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

Перечисление облачных служб

  • Статья

Операция List Cloud Services выводит список облачных служб, доступных в указанной подписке.

Запрос

Запрос List Cloud Services можно указать следующим образом. Замените <subscription-id> идентификатором своей подписки.

Метод Универсальный код ресурса (URI) запроса
GET https://management.core.windows.net/<subscription-id>/services/hostedservices

Параметры URI

Нет.

Заголовки запросов

В следующей таблице описаны заголовки запросов.

Заголовок запроса Описание
x-ms-version Обязательный. Задает версию операции, используемой для этого запроса. Этот заголовок должен иметь значение 2009-10-01 или выше.
x-ms-continuation-token Необязательный элемент. Указывает токен продолжения, позволяющий получить оставшуюся часть ответа, когда можно перечислить больше облачных служб, чем может быть возвращено в отведенное время. Значение этого токена возвращается в заголовке предыдущего ответа и будет возвращаться только в том случае, когда необходимо перечислить дополнительные облачные службы.

Текст запроса

Нет.

Ответ

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

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

Успешная операция возвращает код состояния 200 (ОК).

Заголовки откликов

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP.

Заголовок ответа Описание
x-ms-request-id Указывает значение, которое однозначно идентифицирует запрос к службе управления.
x-ms-continuation-token Указывает токен продолжения, позволяющий получить оставшуюся часть ответа, когда можно перечислить больше облачных служб, чем может быть возвращено в отведенное время. Если в подписке существует большое количество облачных служб, не все они могут быть перечислены в одном ответе. Можно использовать токен в этом заголовке в последующих запросах операции, пока не будут возвращены все облачные службы.

Текст ответа

Текст ответа имеет следующий формат:

  
<?xml version="1.0" encoding="utf-8"?>  
  <HostedServices xmlns=”http://schemas.microsoft.com/windowsazure”>  
    <HostedService>  
      <Url>address-of-cloud-service</Url>  
      <ServiceName>name-of-cloud-service</ServiceName>  
      <HostedServiceProperties>  
        <Description>description-of-cloud-service</Description>  
        <AffinityGroup>name-of-affinity-group</AffinityGroup>  
        <Location>location-of-cloud-service</Location>  
        <Label>label-of-cloud-service</Label>  
        <Status>status-of-cloud-service</Status>  
        <DateCreated>date-created</DateCreated>  
        <DateLastModified>date-modified</DateLastModified>  
        <ExtendedProperties>  
          <ExtendedProperty>  
            <Name>name-of-property-name</Name>  
            <Value>value-of-property</Value>  
          </ExtendedProperty>  
        </ExtendedProperties>  
        <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
      </HostedServiceProperties>  
      <DefaultWinRMCertificateThumbprint>certificate-thumbprint-for-winrm</DefaultWinRMCertificateThumbprint>  
      <ComputeCapabilities>  
        <VirtualMachineRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </VirtualMachineRoleSizes>  
        <WebWorkerRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </WebWorkerRoleSizes>  
      </ComputeCapabilities>  
    </HostedService>  
  </HostedServices>

В следующей таблице описаны элементы текста ответа.

Имя элемента Описание
Url Задает URI запроса, который используется для получения сведений об облачной службе.
ServiceName Указывает имя облачной службы. Это имя префикса DNS, оно может использоваться для доступа к службе.

Например, если имя службы — MyService, вы можете получить доступ к службе, вызвав http:// MyService.cloudapp.net
Описание Указывает описание облачной службы.

Элемент Description доступен только в версии 2012-03-01 или более поздней.
Территориальная группа Задает территориальную группу сходства, с которой связана эта облачная служба (если она имеется). Если служба связана с территориальной группой, элемент Location не возвращается.

Элемент AffinityGroup доступен только в версии 2012-03-01 или более поздней.
Расположение Задает географическое местоположение облачной службы в Azure, если служба не связана с территориальной группой. Если расположение указано, то элемент AffinityGroup не возвращается.

Элемент Location доступен только в версии 2012-03-01 или более поздней.
Метка Задает идентификатор облачной службы в кодировке base-64. Этот идентификатор можно использовать для отслеживания.

Элемент Label доступен только в версии 2012-03-01 или более поздней.
Состояние Задает состояние облачной службы. Возможны следующие значения:

- Creating
- Created
- Deleting
- Deleted
- Changing
- ResolvingDns

Элемент Status доступен только в версии 2012-03-01 или более поздней.
DateCreated Задает дату создания облачной службы в формате [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z. Дата 2011-05-11T16:15:26Z - пример значения, которое может быть возвращено элементами DateCreated или DateLastModified.

Элемент DateCreated доступен только в версии 2012-03-01 или более поздней.
DateLastModified Задает дату последнего обновления облачной службы в формате [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z. Дата 2011-05-11T16:15:26Z - пример значения, которое может быть возвращено элементами DateCreated или DateLastModified.

Элемент DateLastModified доступен только в версии 2012-03-01 или более поздней.
Имя Задает имя расширенного свойства облачной службы. Каждое расширенное свойство должно иметь и заданное имя, и значение. Можно определить самое большее 50 расширенных свойств.

Элемент Name доступен только в версии 2012-03-01 или более поздней.
Значение Представляет собой значение расширенного свойства облачной службы. Значение расширенного свойства не должно превышать по длине 255 символов.

Элемент Value доступен только в версии 2012-03-01 или более поздней.
ReverseDnsFqdn Необязательный элемент. Указывает DNS-адрес, в который разрешается IP-адрес облачной службы при запросе с использованием обратного запроса DNS.

Элемент ReverseDnsFqdn доступен только в версии 2014-06-01 или более поздней.
DefaultWinRMCertificateThumbprint Задает сертификат по умолчанию для безопасного соединения с WinRM. Если для WinRM не указан отпечаток сертификата, то при развертывании виртуальной машины в облачной службе сертификат создается автоматически и его отпечаток приводится как значение данного элемента. Дополнительные сведения об определении WinRM см. в разделе Создание развертывания виртуальной машины или Добавление роли.
ComputeCapabilities Указывает размеры ролей, доступные для развертывания в облачной службе. Доступные размеры ролей определяются ресурсами, которые поддерживаются облачной службой. Например, доступные размеры развертывания веб-ролей и рабочих ролей могут отличаться от размеров развертываний виртуальных машин.

Элемент ComputeCapabilities доступен только в версии 2014-05-01 или более поздней.

ComputeCapabilities

Указывает размеры ролей, доступные для развертывания в облачной службе.

Имя элемента Описание
VirtualMachineRoleSizes Включает в себя коллекцию элементов RoleSize.
WebWorkerRoleSizes Включает в себя коллекцию элементов RoleSize.
RoleSize Задает размер роли, доступный для типа развертывания.

Комментарии

Если значение x-ms-version имеет более раннюю версию, чем 2012-03-01, то облачные службы, содержащие развертывания виртуальных машин, не будут возвращены.

В разделе «Облачные службы» портала управления можно видеть службы, существующие в вашей подписке. Вы также можете получить список облачных служб с помощью командлета Get-AzureService .