Добавление службы в надстройку

Статья
08/24/2015

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

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

Запрос

Укажите запрос на добавление надстройки следующим образом: замените <ServiceMgmt> адресом конечной точки API управления службами. Замените <AddonId> идентификатором надстройки, к которой добавляется служба.

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

Параметры URI

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

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

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

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

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

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

Имя элемента	Описание
Имя	Имя службы.
InstanceId	Идентификатор экземпляра службы.
ConfigState	Состояние конфигурации квоты.

Ответ

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

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

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

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

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

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

Текст ответа

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

Имя элемента	Описание
Имя	Имя службы.
InstanceId	Идентификатор экземпляра службы.
ConfigState	Состояние конфигурации квоты.

Пример

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

POST https://<Computer>:30004/addons/GoldAhihps8jy/services HTTP/1.1
Authorization: Bearer <Token>
x-ms-principal-id: <COMPUTER>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <COMPUTER>\Administrator
Content-Type: application/json; charset=utf-8
Host: <Computer>:30004
Content-Length: 91
Expect: 100-continue
{
  "Name": "mysqlservers",
  "InstanceId": "33CC0954-8412-4CE1-924F-B9CB1525FA96",
  "ConfigState": 0
}

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

{
  "Name": "mysqlservers",
  "InstanceId": "33CC0954-8412-4CE1-924F-B9CB1525FA96",
  "ConfigState": 0
}

См. также:

Интерфейсы надстроек администратора

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