Проверка квоты службы для поставщика ресурсов

Статья
08/24/2015

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

Проверяет квоту службы для поставщика ресурсов.

Запрос

Замените <NotificationEndpoint> адресом конечной точки Windows REST API уведомления пользовательского поставщика ресурсов Пакета Azure.

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
PUT	<http:// NotificationEndpoint>/quota?validateOnly=true	HTTP/1.1

Параметры URI

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

Параметр универсального кода ресурса (URI)	Описание
validateOnly	Задайте значение true, чтобы проверить квоту.

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

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

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

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

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

Имя элемента	Описание
QuotaUpdateBatchSubscription	Пакет параметров квоты, которые следует игнорировать при проверке. Дополнительные сведения см. в разделе QuotaUpdateBatch (объект конечной точки уведомления).

Ответ

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

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

Успешная операция возвращает код состояния 200 (ОК), если квота действительна. Если квота недопустимая, возвращается значение 400 с объектом ResourceProviderError (объект конечной точки уведомления), содержащим локализованное сообщение об ошибке, объясняющее причину ошибки проверки.

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

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

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

Текст ответа

Нет.

Пример

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

PUT https://<NotificationEndpoint>:30012/quota?validateOnly=true HTTP/1.1
Referer: https://<Computer>:30004/plans/MyServicePlanX18aa6bac-5e8d-439e-b4d9-4a7dea4e843a/quota
Accept-Language: en-US
x-ms-client-request-id: 0ee49d13-7b86-4840-b0e1-046106a8d813-2014-07-09 23:16:21Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 840de34d9d9a484a8ddd7255a44cb1fd.2014-07-09T23:16:22.6545190Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30012
Content-Length: 273
Expect: 100-continue

{
  "BaseQuota": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":11,\"resourceSize\":1024,\"offerEditionId\":\"040814101717\",\"groupType\":null,\"resourceSizeLimit\":null}]"
    }
  ],
  "AddOnQuotas": [

  ],
  "SubscriptionIdsToUpdate": [

  ]
}

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

{
  "BaseQuota": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":11,\"resourceSize\":1024,\"offerEditionId\":\"040814101717\",\"groupType\":null,\"resourceSizeLimit\":null}]"
    }
  ],
  "AddOnQuotas": [

  ],
  "SubscriptionIdsToUpdate": [

  ]
}

Сводка

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

См. также:

Windows справочнике по REST API уведомления пользовательского поставщика ресурсов Azure Pack

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