Добавление надстройки подписки

Статья
08/24/2015

Область применения: Windows Azure Pack

Добавляет надстройку подписки.

Запрос

Замените <ServiceMgmt> адресом конечной точки API управления службами. Замените <порт> на 30005 для API клиента или 30004 для API администратора. Замените <SubscriptionId> идентификатором подписки для необходимой подписки.

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
POST	<https:// ServiceMgmt>:<Port>/subscriptions/<SubscriptionId>/addons/	HTTP/1.1

Параметры URI

Отсутствует.

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

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

Заголовок запроса	Описание
Авторизация: носитель	Обязательный. Токен носителя авторизации.
x-ms-client-request-id:	Необязательный элемент. Идентификатор запроса клиента.
x-ms-client-session-id:	Необязательный элемент. Идентификатор сеанса клиента.
x-ms-client-principal-id:	Необязательный элемент. Идентификатор участника.
x-ms-principal-liveid:	Необязательный элемент. Идентификатор основной динамической трансляции.

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

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

Имя элемента	Описание
AddOnId	Идентификатор надстройки.
AddOnInstanceId	Идентификатор экземпляра надстройки. Использование null
AcquisitionTime	Время приобретения надстройки. Использование null

Ответ

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

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

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

Сведения о кодах состояния см. в разделе "Коды состояния" и "Коды ошибок" (Windows управления пакетом обновления Azure).

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

Ответ для этой операции включает стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Текст ответа

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

Имя элемента	Описание
AddOnId	Идентификатор надстройки.
AddOnInstanceId	Идентификатор экземпляра надстройки.
AcquisitionTime	Время приобретения надстройки.

Пример

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

POST https://<computer>:30004/subscriptions/1b7a12d8-82c0-4d06-82bb-7da71028b1ff/addons HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: ea3ec878-5246-4c11-9f00-4bec66d6f468-2014-05-02 21:22:34Z
x-ms-client-session-id: c0d4a435-6552-4677-92b7-3da9c5b129e1
x-ms-principal-id: <Computer>%5cAdministrator
Accept-Language: en-US
Content-Type: application/json; charset=utf-8
Host: chrisre-katal:30004
Content-Length: 73
Expect: 100-continue

{
  "AddOnId": "MyAddhupzd4d3",
  "AddOnInstanceId": null,
  "AcquisitionTime": null
}

В следующем примере показан текст ответа "Добавление надстройки подписки".

{
  "AddOnId": "MyAddhupzd4d3",
  "AddOnInstanceId": "c43e34db-156b-4004-a73a-c71d76c2c6f6",
  "AcquisitionTime": "2014-05-02T21:22:35.687"
}

См. также:

Общие интерфейсы подписки

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