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

Manage billing - Get a customer's utilization records for Azure

  • Ссылка
Служба:
Partner Center Rest
Версия API:
v1

Возвращает использование ресурсов, принадлежащих подписке Azure, принадлежащей клиенту партнера.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
С использованием необязательных параметров: 
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure?start_time={start_time}&end_time={end_time}&size={size}&granularity={granularity}&show_details={show_details}&seek_operation={seek_operation}

Параметры URI

Имя В Обязательно Тип Описание
customer_id
 path True

string

Идентификатор клиента, которому принадлежит подписка.
subscription_id
 path True

string

Идентификатор подписки Azure для получения использования.
end_time
 query

string

date-time

Время окончания использования в системе выставления счетов.
granularity
 query

string

Степень детализации времени использования ресурсов. Может быть ежедневно или почасово. Дефальт ежедневно.
seek_operation
 query

string

Операция поиска для выполнения. Поддерживается только Next.
show_details
 query

boolean

Если задано значение true, записи об использовании будут разделены уровнями экземпляров ресурсов. Если задано значение false, записи об использовании будут агрегированы на уровне ресурса. Значение по умолчанию — true.
size
 query

integer

int32

Необязательное максимальное количество возвращаемых записей. Значение по умолчанию — 1000. Возвращаемая коллекция ресурсов будет указывать следующую ссылку, если были доступны дополнительные записи об использовании.
start_time
 query

string

date-time

Время начала использования в системе выставления счетов.

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

Имя Обязательно Тип Описание
Authorization True

string

Маркер носителя авторизации
ms-correlationid

string

Используется для отслеживания запросов внутри системы. Если ms-correlationid не указан, сервер создаст новый для каждого запроса.
ms-cv

string

Используется для отслеживания запросов внутри системы. Если ms-cv не предоставлено, сервер создаст новый для каждого запроса.
ms-requestid

string

Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создаст новый для каждого запроса.

Ответы

Имя Тип Описание
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

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

Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Данные недоступны для заданного времени начала и окончания. Содержимое не возвращается с заголовком повторных попыток.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Отсутствуют или недопустимые входные данные. Текст ответа предоставит сведения об ошибке.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

Запрос не прошел проверку подлинности. Сначала клиент должен пройти проверку подлинности с помощью службы API партнеров.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

Запрос прошел проверку подлинности, но был отклонен, так как вызывающий объект не имеет прав на его вызов.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

Ресурс не найден или недоступен с заданными входными параметрами.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить это.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Определения

Имя Описание
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
Utilizations.AzureInstanceData
Utilizations.AzureResource
Utilizations.AzureUtilizationRecord

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Имя Тип Описание
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Имя Тип Описание
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Имя Тип Описание
etag

string

objectType

string

Имя Тип Описание
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Имя Тип Описание
key

string

value

string

Utilizations.AzureInstanceData

Имя Тип Описание
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Имя Тип Описание
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Имя Тип Описание
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string