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

Создать облачную службу

  • Статья

Асинхронная операция Create Cloud Service создает новую облачную службу в Microsoft Azure.

Запрос

Запрос Create Cloud Service указывается следующим образом. Замените <subscription-id> идентификатором своей подписки.

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

Параметры URI

Нет.

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

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

Заголовок запроса Описание
Content-Type Обязательный. Задайте для этого заголовка значение application/xml.
x-ms-version Обязательный. Задает версию операции, используемой для этого запроса. Значение этого заголовка должно быть равно 2010-10-28 или выше.

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

Далее приведен формат текста запроса.

<?xml version="1.0" encoding="utf-8"?>  
<CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <ServiceName>name-of-cloud-service</ServiceName>  
  <Label>base64-encoded-label-of-cloud-service</Label>  
  <Description>description-of-cloud-service</Description>  
  <Location>location-of-cloud-service</Location>  
  <AffinityGroup>name-of-affinity-group</AffinityGroup>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</CreateHostedService>

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

Имя элемента Описание
ServiceName Обязательный. Указывает имя для облачной службы. Это имя должно быть уникальным в пределах Azure. Это имя является префиксом DNS, который может использоваться для доступа к службе. Чтобы проверить доступность имени, можно использовать команду Проверить доступность имени облачной службы.
Метка Обязательный. Задает идентификатор облачной службы в кодировке base-64. Идентификатор может иметь длину до 100 символов. Метку можно использовать для отслеживания.
Описание Необязательный элемент. Указывает описание облачной службы. Длина описания не может быть более 1024 символов.
Расположение Обязательный элемент, если параметр AffinityGroup не задан. Указывает расположение, в котором создана облачная служба.

Необходимо указать Location или AffinityGroup, но не оба значения. Чтобы просмотреть доступные расположения, можно использовать список расположений.
Территориальная группа Обязательный элемент, если параметр Location не задан. Задает имя существующей территориальной группы, связанной с этой подпиской. Необходимо указать Location или AffinityGroup, но не оба значения. Чтобы просмотреть доступные группы сходства, можно воспользоваться функцией Перечисление групп сходства.
Имя Необязательный элемент. Задает имя расширенного свойства облачной службы. Длина имени не должна превышать 64 символа, допустимы только буквенно-цифровые символы и знаки подчеркивания, и имя должно начинаться с буквы. Каждое расширенное свойство должно иметь и заданное имя, и значение. Можно определить самое большее 50 расширенных свойств.

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

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

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

Ответ

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

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

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

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

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

Заголовок ответа Описание
x-ms-request-id Значение, которое однозначно определяет запрос к службе управления. Для асинхронной операции можно вызвать Get Operation Status со значением заголовка, чтобы определить, завершена ли операция, завершилась ли она сбоем или все еще выполняется.

Текст ответа

Нет.