Cloud Services - List

Служба:: Compute

Версия API:: 2024-11-04

Получает список всех облачных служб в группе ресурсов. Используйте свойство nextLink в ответе, чтобы получить следующую страницу облачных сервисов. Делайте это до тех пор, пока nextLink не станет нулевым, чтобы получить все облачные сервисы.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices?api-version=2024-11-04

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов.
subscriptionId	path	True	string	Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.
api-version	query	True	string	Версия клиентского API.

Ответы

Имя	Тип	Описание
200 OK	CloudServiceListResult	ХОРОШО
Other Status Codes	CloudError	Ошибка

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

List Cloud Services in a Resource Group

Образец запроса

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices?api-version=2024-11-04

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "name": "{cs-name}",
      "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}",
      "type": "Microsoft.Compute/cloudServices",
      "location": "eastus2euap",
      "properties": {
        "configuration": "{ServiceConfiguration}",
        "upgradeMode": "Auto",
        "roleProfile": {
          "roles": [
            {
              "name": "ContosoFrontend",
              "sku": {
                "name": "Standard_D1_v2",
                "tier": "Standard",
                "capacity": 2
              }
            },
            {
              "name": "ContosoBackend",
              "sku": {
                "name": "Standard_D1_v2",
                "tier": "Standard",
                "capacity": 2
              }
            }
          ]
        },
        "osProfile": {
          "secrets": []
        },
        "networkProfile": {
          "loadBalancerConfigurations": [
            {
              "name": "contosolb",
              "properties": {
                "frontendIpConfigurations": [
                  {
                    "name": "contosofe",
                    "properties": {
                      "publicIPAddress": {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Network/publicIPAddresses/contosopublicip"
                      }
                    }
                  }
                ]
              }
            }
          ]
        },
        "extensionProfile": {
          "extensions": [
            {
              "name": "RDPExtension",
              "properties": {
                "autoUpgradeMinorVersion": false,
                "provisioningState": "Succeeded",
                "rolesAppliedTo": [
                  "*"
                ],
                "publisher": "Microsoft.Windows.Azure.Extensions",
                "type": "RDP",
                "typeHandlerVersion": "1.2",
                "settings": "<PublicConfig><UserName>userazure</UserName><Expiration>01/12/2022 16:29:02</Expiration></PublicConfig>"
              }
            }
          ]
        },
        "provisioningState": "Succeeded",
        "uniqueId": "4ccb4323-4740-4545-bb81-780b27375947"
      }
    }
  ]
}

Определения

Имя	Описание
ApiError	Ошибка API.
ApiErrorBase	База ошибок API.
CloudError	Ответ об ошибке от службы вычислений.
CloudService	Описывает облачную службу.
CloudServiceExtensionProfile	Описывает профиль расширения облачной службы.
CloudServiceExtensionProperties	Свойства расширения.
CloudServiceListResult	Результат работы со списками.
CloudServiceNetworkProfile	Сетевой профиль облачной службы.
CloudServiceOsProfile	Описывает профиль ОС для облачной службы.
CloudServiceProperties	Свойства облачной службы
CloudServiceRoleProfile	Описывает профиль роли облачной службы.
CloudServiceRoleProfileProperties	Описывает свойства роли.
CloudServiceRoleSku	Описывает номер SKU роли облачной службы.
CloudServiceSlotType	Тип слота для облачной службы. Возможные значения: рабочей промежуточного Если значение не указано, значение по умолчанию — Production.
CloudServiceUpgradeMode	Режим обновления облачной службы. Экземпляры ролей выделяются для обновления доменов при развертывании службы. Обновления можно инициировать вручную в каждом домене обновления или автоматически инициировать во всех доменах обновления. Возможные значения Автоматически Вручную одновременные Если значение по умолчанию не указано, значение по умолчанию — auto. Если задано значение "Вручную", для применения обновления необходимо вызвать PUT UpdateDomain. Если задано значение "Авто", обновление автоматически применяется к каждому домену обновления в последовательности.
CloudServiceVaultAndSecretReference	Защищенные параметры расширения, на которые ссылается keyVault, которые шифруются перед отправкой экземпляру роли.
CloudServiceVaultCertificate	Описывает ссылку на один сертификат в Key Vault и место расположения сертификата в экземпляре роли.
CloudServiceVaultSecretGroup	Описывает набор сертификатов, которые находятся в одном хранилище ключей.
createdByType	Тип удостоверения, создавшего ресурс.
Extension	Описывает расширение облачной службы.
InnerError	Сведения о внутренней ошибке.
LoadBalancerConfiguration	Описывает конфигурацию подсистемы балансировки нагрузки.
LoadBalancerConfigurationProperties	Описывает свойства конфигурации подсистемы балансировки нагрузки.
LoadBalancerFrontendIpConfiguration	Указывает внешний IP-адрес, используемый для подсистемы балансировки нагрузки. Поддерживается только IP-адрес внешнего интерфейса IPv4. Каждая конфигурация подсистемы балансировки нагрузки должна иметь ровно одну конфигурацию внешнего IP-адреса.
LoadBalancerFrontendIpConfigurationProperties	Описание IP-конфигурации облачной службы
SubResource
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

ApiError

Объект

Ошибка API.

Имя	Тип	Описание
code	string	Код ошибки.
details	ApiErrorBase[]	Сведения об ошибке Api
innererror	InnerError	Внутренняя ошибка Api
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

ApiErrorBase

Объект

База ошибок API.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

CloudError

Объект

Ответ об ошибке от службы вычислений.

Имя	Тип	Описание
error	ApiError	Ошибка API.

CloudService

Объект

Описывает облачную службу.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties	CloudServiceProperties	Свойства облачной службы
systemData	systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
tags	object	Теги ресурсов.
type	string	Тип ресурса.
zones	string[]	Список логической зоны доступности ресурса. Список должен содержать только 1 зону, в которой должна быть подготовлена облачная служба. Это поле необязательно.

CloudServiceExtensionProfile

Объект

Описывает профиль расширения облачной службы.

Имя	Тип	Описание
extensions	Extension[]	Список расширений облачной службы.

CloudServiceExtensionProperties

Объект

Свойства расширения.

Имя	Тип	Описание
autoUpgradeMinorVersion	boolean	Явно укажите, может ли платформа автоматически обновлять typeHandlerVersion до более поздних дополнительных версий, когда они становятся доступными.
forceUpdateTag	string	Тег для принудительного применения предоставленных общедоступных и защищенных параметров. Изменение значения тега позволяет повторно запустить расширение, не изменяя общедоступные или защищенные параметры. Если forceUpdateTag не изменяется, обновления общедоступных или защищенных параметров по-прежнему применяются обработчиком. Если ни forceUpdateTag, ни какие-либо публичные или защищенные настройки не изменяются, расширение будет передаваться экземпляру роли с тем же порядковым номером, и реализация обработчика будет решать, запускать его повторно или нет
protectedSettings	object	Защищенные параметры для расширения, зашифрованного перед отправкой в экземпляр роли.
protectedSettingsFromKeyVault	CloudServiceVaultAndSecretReference	Защищенные параметры расширения, на которые ссылается keyVault, которые шифруются перед отправкой экземпляру роли.
provisioningState	string	Состояние подготовки, которое отображается только в ответе.
publisher	string	Имя издателя обработчика расширений.
rolesAppliedTo	string[]	Необязательный список ролей для применения этого расширения. Если свойство не указано или "*" не указано, расширение применяется ко всем ролям в облачной службе.
settings	object	Общедоступные параметры расширения. Для расширений JSON это параметры JSON для расширения. Для расширения XML (например, RDP) это параметр XML для расширения.
type	string	Указывает тип расширения.
typeHandlerVersion	string	Указывает версию расширения. Указывает версию расширения. Если этот элемент не указан или звездочка (*) используется в качестве значения, используется последняя версия расширения. Если значение указано с номером основной версии и звездочкой в качестве дополнительного номера версии (X.), выбрана последняя дополнительная версия указанной основной версии. Если указан номер основной версии и дополнительный номер версии (X.Y), выбрана конкретная версия расширения. Если указана версия, автоматическое обновление выполняется в экземпляре роли.

CloudServiceListResult

Объект

Результат работы со списками.

Имя	Тип	Описание
nextLink	string	URI для получения следующей страницы ресурсов. Используйте это, чтобы получить следующую страницу ресурсов. Делайте это до тех пор, пока nextLink не станет нулевым, чтобы получить все ресурсы.
value	CloudService[]	Список ресурсов.

CloudServiceNetworkProfile

Объект

Сетевой профиль облачной службы.

Имя	Тип	Описание
loadBalancerConfigurations	LoadBalancerConfiguration[]	Список конфигураций подсистемы балансировки нагрузки. Облачная служба может иметь до двух конфигураций подсистемы балансировки нагрузки, соответствующих общедоступной подсистеме балансировки нагрузки и внутренней подсистеме балансировки нагрузки.
slotType	CloudServiceSlotType	Тип слота для облачной службы. Возможные значения: рабочей промежуточного Если значение не указано, значение по умолчанию — Production.
swappableCloudService	SubResource	Ссылка на идентификатор облачной службы, содержащей целевой IP-адрес, с помощью которого облачная служба субъекта может выполнить переключение. Это свойство невозможно обновить после установки. Переключаемая облачная служба, на которую ссылается этот идентификатор, должна присутствовать в противном случае будет вызвана ошибка.

CloudServiceOsProfile

Объект

Описывает профиль ОС для облачной службы.

Имя	Тип	Описание
secrets	CloudServiceVaultSecretGroup[]	Указывает набор сертификатов, которые должны быть установлены на экземпляры роли.

CloudServiceProperties

Объект

Свойства облачной службы

Имя	Тип	Описание
allowModelOverride	boolean	(Необязательно) Указывает, должны ли свойства sku роли (roleProfile.role.sku), указанные в модели или шаблоне, переопределить количество экземпляров ролей и размер виртуальной машины, указанные в CSCFG и CSDEF соответственно. Значение по умолчанию — `false`.
configuration	string	Указывает конфигурацию СЛУЖБЫ XML (CSCFG) для облачной службы.
configurationUrl	string	Указывает URL-адрес, ссылающийся на расположение конфигурации службы в службе BLOB-объектов. URL-адрес пакета службы может быть url-адресом URI подписанного URL-адреса (SAS) из любой учетной записи хранения. Это свойство только для записи и не возвращается в вызовах GET.
extensionProfile	CloudServiceExtensionProfile	Описывает профиль расширения облачной службы.
networkProfile	CloudServiceNetworkProfile	Сетевой профиль облачной службы.
osProfile	CloudServiceOsProfile	Описывает профиль ОС для облачной службы.
packageUrl	string	Указывает URL-адрес, ссылающийся на расположение пакета службы в службе BLOB-объектов. URL-адрес пакета службы может быть url-адресом URI подписанного URL-адреса (SAS) из любой учетной записи хранения. Это свойство только для записи и не возвращается в вызовах GET.
provisioningState	string	Состояние подготовки, которое отображается только в ответе.
roleProfile	CloudServiceRoleProfile	Описывает профиль роли облачной службы.
startCloudService	boolean	(Необязательно) Указывает, следует ли запускать облачную службу сразу после ее создания. Значение по умолчанию — `true`. Если значение false, модель службы по-прежнему развертывается, но код не выполняется немедленно. Вместо этого служба poweredOff будет запущена до вызова Start, в то время как служба будет запущена. Развернутая служба по-прежнему взимает плату, даже если она отключена.
uniqueId	string	Уникальный идентификатор облачного сервиса.
upgradeMode	CloudServiceUpgradeMode	Режим обновления облачной службы. Экземпляры ролей выделяются для обновления доменов при развертывании службы. Обновления можно инициировать вручную в каждом домене обновления или автоматически инициировать во всех доменах обновления. Возможные значения Автоматически Вручную одновременные Если значение по умолчанию не указано, значение по умолчанию — auto. Если задано значение "Вручную", для применения обновления необходимо вызвать PUT UpdateDomain. Если задано значение "Авто", обновление автоматически применяется к каждому домену обновления в последовательности.

CloudServiceRoleProfile

Объект

Описывает профиль роли облачной службы.

Имя	Тип	Описание
roles	CloudServiceRoleProfileProperties[]	Список ролей для облачной службы.

CloudServiceRoleProfileProperties

Объект

Описывает свойства роли.

Имя	Тип	Описание
name	string	Имя ресурса.
sku	CloudServiceRoleSku	Описывает номер SKU роли облачной службы.

CloudServiceRoleSku

Объект

Описывает номер SKU роли облачной службы.

Имя	Тип	Описание
capacity	integer (int64)	Указывает количество экземпляров ролей в облачной службе.
name	string	Имя SKU. ПРИМЕЧАНИЕ. Если новый номер SKU не поддерживается на оборудовании облачной службы в настоящее время, необходимо удалить и повторно создать облачную службу или вернуться к старому номеру SKU.
tier	string	Указывает уровень облачной службы. Возможные значения Стандарт Basic

CloudServiceSlotType

Перечисление

Тип слота для облачной службы. Возможные значения:

рабочей

промежуточного

Если значение не указано, значение по умолчанию — Production.

Значение	Описание
Production
Staging

CloudServiceUpgradeMode

Перечисление

Режим обновления облачной службы. Экземпляры ролей выделяются для обновления доменов при развертывании службы. Обновления можно инициировать вручную в каждом домене обновления или автоматически инициировать во всех доменах обновления. Возможные значения

Автоматически

Вручную

одновременные

Если значение по умолчанию не указано, значение по умолчанию — auto. Если задано значение "Вручную", для применения обновления необходимо вызвать PUT UpdateDomain. Если задано значение "Авто", обновление автоматически применяется к каждому домену обновления в последовательности.

Значение	Описание
Auto
Manual
Simultaneous

CloudServiceVaultAndSecretReference

Объект

Защищенные параметры расширения, на которые ссылается keyVault, которые шифруются перед отправкой экземпляру роли.

Имя	Тип	Описание
secretUrl	string	URL-адрес секрета, содержащий защищенные параметры расширения
sourceVault	SubResource	Идентификатор ресурса ARM в Key Vault

CloudServiceVaultCertificate

Объект

Описывает ссылку на один сертификат в Key Vault и место расположения сертификата в экземпляре роли.

Имя	Тип	Описание
certificateUrl	string	Это URL-адрес сертификата, который был отправлен в Key Vault в качестве секрета.
isBootstrapCertificate	boolean	Флаг, указывающий, указан ли сертификат начальной загрузки, используемый расширением Key Vault для получения оставшихся сертификатов.

CloudServiceVaultSecretGroup

Объект

Описывает набор сертификатов, которые находятся в одном хранилище ключей.

Имя	Тип	Описание
sourceVault	SubResource	Относительный URL-адрес Хранилища ключей, содержащий все сертификаты в VaultCertificates.
vaultCertificates	CloudServiceVaultCertificate[]	Список ссылок на хранилище ключей в SourceVault, содержащий сертификаты.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

Extension

Объект

Описывает расширение облачной службы.

Имя	Тип	Описание
name	string	Имя расширения.
properties	CloudServiceExtensionProperties	Свойства расширения.

InnerError

Объект

Сведения о внутренней ошибке.

Имя	Тип	Описание
errordetail	string	Внутреннее сообщение об ошибке или дамп исключений.
exceptiontype	string	Тип исключения.

LoadBalancerConfiguration

Объект

Описывает конфигурацию подсистемы балансировки нагрузки.

Имя	Тип	Описание
id	string	Идентификатор ресурса
name	string	Имя подсистемы балансировки нагрузки
properties	LoadBalancerConfigurationProperties	Свойства конфигурации подсистемы балансировки нагрузки.

LoadBalancerConfigurationProperties

Объект

Описывает свойства конфигурации подсистемы балансировки нагрузки.

Имя	Тип	Описание
frontendIpConfigurations	LoadBalancerFrontendIpConfiguration[]	Указывает внешний IP-адрес, используемый для подсистемы балансировки нагрузки. Поддерживается только IP-адрес внешнего интерфейса IPv4. Каждая конфигурация подсистемы балансировки нагрузки должна иметь ровно одну конфигурацию внешнего IP-адреса.

LoadBalancerFrontendIpConfiguration

Объект

Указывает внешний IP-адрес, используемый для подсистемы балансировки нагрузки. Поддерживается только IP-адрес внешнего интерфейса IPv4. Каждая конфигурация подсистемы балансировки нагрузки должна иметь ровно одну конфигурацию внешнего IP-адреса.

Имя	Тип	Описание
name	string	Имя ресурса, уникального в наборе интерфейсных IP-конфигураций, используемых подсистемой балансировки нагрузки. Это имя можно использовать для доступа к ресурсу.
properties	LoadBalancerFrontendIpConfigurationProperties	Свойства интерфейсной ip-конфигурации подсистемы балансировки нагрузки.

LoadBalancerFrontendIpConfigurationProperties

Объект

Описание IP-конфигурации облачной службы

Имя	Тип	Описание
privateIPAddress	string	Частный IP-адрес виртуальной сети конфигурации IP-адресов.
publicIPAddress	SubResource	Ссылка на ресурс общедоступного IP-адреса.
subnet	SubResource	Ссылка на ресурс подсети виртуальной сети.

SubResource

Объект

Имя	Тип	Описание
id	string	Идентификатор ресурса

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

Cloud Services - List

Параметры URI

Ответы

Безопасность

azure_auth

Области

Примеры

List Cloud Services in a Resource Group

Образец запроса

Пример ответа

Определения

ApiError

ApiErrorBase

CloudError

CloudService

CloudServiceExtensionProfile

CloudServiceExtensionProperties

CloudServiceListResult

CloudServiceNetworkProfile

CloudServiceOsProfile

CloudServiceProperties

CloudServiceRoleProfile

CloudServiceRoleProfileProperties

CloudServiceRoleSku

CloudServiceSlotType

CloudServiceUpgradeMode

CloudServiceVaultAndSecretReference

CloudServiceVaultCertificate

CloudServiceVaultSecretGroup

createdByType

Extension

InnerError

LoadBalancerConfiguration

LoadBalancerConfigurationProperties

LoadBalancerFrontendIpConfiguration

LoadBalancerFrontendIpConfigurationProperties

SubResource

systemData