Получение всех аналитических сведений об использовании Azure

Статья
05/28/2024

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

Как получить все сведения об аналитике использования Azure для клиентов.

Предварительные условия

Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности только с учетными данными пользователя.

Запрос REST

Синтаксис запроса

Метод	Универсальный код ресурса (URI) запроса
GET	{baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Параметры универсального кода ресурса (URI)

Параметр	Тип	Описание
top	строка	Количество строк данных, возвращаемых в запросе. Максимальное значение и значение по умолчанию (если параметр не указан) — 10 000. Если в запросе содержится больше строк, то тело ответа будет содержать ссылку «Далее», которую можно использовать для запроса следующей страницы данных
skip	INT	Количество строк, пропускаемых в запросе. Используйте этот параметр для постраничного перемещения по большим наборам данных. Например, `top=10000 and skip=0` извлекает первые 10 000 строк данных, `top=10000 and skip=10000` возвращает следующие 10 000 строк данных и т. д.
фильтр	строка	Параметр filter запроса содержит один или несколько операторов, фильтрующих строки в ответе. Каждая инструкция содержит поле и значение, связанные с операторами `eq` или `ne` , а инструкции можно объединить с помощью `and` или `or`. Можно указать следующие строки: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` Пример. `.../usage/azure?filter=meterCategory eq 'Data Management'` Пример. `.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))`
aggregationLevel	строка	Определяет диапазон времени, для которого требуется получить сводные данные. Может быть одной из следующих строк: `day`, `week`или `month`. Если это не указано, по умолчанию используется значение `day`. Параметр `aggregationLevel` не поддерживается без `groupby`. Параметр `aggregationLevel` применяется ко всем полям даты, присутствующим `groupby`в .
orderby	строка	Выражение, которое определяет порядок полученных значений данных для каждой установки. Синтаксис: `...&orderby=field [order],field [order],...`. Параметр `field` может быть одной из следующих строк: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` Параметр order является необязательным и может иметь значение `asc` или `desc` для указания возрастающего или убывающего порядка для каждого поля соответственно. Значение по умолчанию — `asc`. Пример. `...&orderby=meterCategory,meterUnit`
groupby	строка	Выражение, которое применяет агрегирование данных только к указанным полям. Можно указать следующие поля: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` Возвращаемые строки данных будут содержать поля, указанные в параметре `groupby` и Quantity. Параметр `groupby` можно использовать с параметром `aggregationLevel` . Пример. `...&groupby=meterCategory,meterUnit`

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

Дополнительные сведения см. в статье о заголовках REST Центра партнеров.

Тело запроса

Нет.

Пример запроса

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Ответ REST

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

Коды успешного выполнения и ошибок в ответе

Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.

Пример ответа

{
  "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

См. также раздел

Аналитика Центра партнеров. Ресурсы

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