Получение сводки по использованию для подписки

Статья
08/24/2015

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

Вызывается API управления службами для получения сводки данных об использовании подписки, созданных поставщиком ресурсов. Эти сведения можно использовать адаптером выставления счетов для расчета затрат на выставление счетов. Дополнительные сведения см. в статье Windows службе использования пакета Azure.

Запрос

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

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
GET	<http:// NotificationEndpoint>/subscriptions/<Id>/usagesummary	HTTP/1.1

Параметры URI

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

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

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

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

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

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

Ответ

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

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

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

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

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

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

Текст ответа

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

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

Пример

В следующем примере кода показан запрос получения сводки по использованию подписки .

GET https://<NotificationEndpoint>/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummary HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummaries
Accept: application/json
Accept-Language: en-US
x-ms-client-request-id: 82610bdb-14d6-4e2a-99a0-9930d879b300-2013-07-25 06:14:56Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 37739ad5c7ab4654b6bb5d5e211f974e.2013-07-25T06:14:57.7649169Z
Authorization: Basic <encoded username and password>
Host: <Computer>:30010

В следующем примере кода показан ответ JSON "Получить сводку использования подписки ".

{
  "ServiceName": "SqlServer",
  "ServiceDisplayName": "Sql Server",
  "RetrievedSuccessfully": false,
  "ErrorMessage": null,
  "Usages": [

  ]
}

Примечания

При вызове TBD API управления службами ожидает одну минуту ответа. Если ответ не получен, подписка помечается как не синхронизированная.

См. также:

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

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