Бөлісу құралы:

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

  • Мақала

Область применения: Центр партнеров | Центр партнеров, управляемый 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": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "customerName": "A",
  "subscriptionId": "EC649980-D623-49F5-B7C1-80CC772B83A8",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

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