Добавление расширения

Асинхронная операция Add Extension добавляет к облачной службе доступное расширение. В Microsoft Azure процесс может выполняться как расширение облачной службы.

Запрос

Запрос Add Extension можно указать следующим образом. Замените <subscription-id> идентификатором своей подписки, а <cloudservice-name> ― именем облачной службы.

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

Параметры URI

Нет.

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

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

Заголовок запроса	Описание
x-ms-version	Обязательный. Задает версию операции, используемой для этого запроса. Этот заголовок должен иметь 2013-03-01 или более позднюю версию.

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

В следующем примере показан формат текста запроса.

  
<?xml version="1.0" encoding="utf-8"?>  
<Extension xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
  <Type>type-of-extension</Type>  
  <Id>identifier-of-extension</Id>  
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
  <PrivateConfiguration>base-64-encoded-xsd-for-extension-private-configuration</PrivateConfiguration>  
  <Version>version-of-extension</Version>  
</Extension>  

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

Имя элемента	Описание
ProviderNameSpace	Обязательный. Указывает пространство имен поставщика расширения. Пространство имен поставщика для расширений Azure —Microsoft.Windows.Azure.Extensions.
Тип	Обязательный элемент. Указывает тип расширения.
Идентификатор	Обязательный. Указывает идентификатор расширения.
Отпечаток	Необязательный элемент. Указывает отпечаток сертификата, используемого для шифрования конфигурации, заданной в PrivateConfiguration. Если этот элемент не указан, сертификат может быть создан автоматически и добавлен в облачную службу.
ThumbprintAlgorithm	Необязательный элемент. Указывает алгоритм отпечатка сертификата, используемого для шифрования конфигурации, которая задана в PrivateConfiguration.
PublicConfiguration	Необязательный элемент. Указывает общедоступную конфигурацию, определенную с помощью схемы, возвращаемой операцией Перечисление доступных расширений .
PrivateConfiguration	Необязательный элемент. Указывает частную конфигурацию, определяемую с помощью схемы, возвращаемой операцией Перечисление доступных расширений .
Версия	Необязательный элемент. Указывает версию расширения. Если этот элемент не указан или в качестве значения используется символ звездочки (*), применяется последняя версия расширения. Если значение указано с основным номером версии и звездочкой в качестве дополнительного номера версии (X.*), выбирается последняя дополнительная версия указанной основной версии. Если основной номер версии и дополнительный номер версии указаны (X.Y), выбирается соответствующая версия расширения. Если указана версия, выполняется автоматическое обновление экземпляра роли.

Ответ

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

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

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

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

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

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

Текст ответа

Нет.