Получение всех ежемесячных записей об использовании для подписки
Область применения: Центр партнеров | Центр партнеров для Microsoft Cloud for US Government
Вы можете использовать коллекцию ресурсов AzureResourceMonthlyUsageRecord , чтобы получить список служб в подписке клиента и связанные с ними сведения об использовании.
Предварительные условия
Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с использованием учетных данных автономного приложения и приложения и пользователя.
Идентификатор клиента (
customer-tenant-id
). Если вы не знаете идентификатор клиента, вы можете найти его в Центре партнеров , выбрав рабочую область Клиенты , а затем клиента в списке клиентов, а затем — Учетная запись. На странице учетной записи клиента найдите Идентификатор Майкрософт в разделе Сведения об учетной записи клиента. Идентификатор Майкрософт совпадает с идентификатором клиента (customer-tenant-id
).Идентификатор подписки.
Этот API поддерживает только подписки Microsoft Azure (MS-AZR-0145P). Если вы используете план Azure, см. статью Получение данных об использовании для подписки по счетчику .
C#
Чтобы получить сведения об использовании ресурсов подписки, выполните следующие действия.
Используйте коллекцию IAggregatePartner.Customers для вызова метода ById().
Вызовите свойство Subscriptions и UsageRecords, а затем свойство Resources .
Вызовите методы Get() или GetAsync().
// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
// var selectedSubscriptionID as string;
var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Resources.Get();
Пример см. в следующем примере:
- Пример: Тестовое консольное приложение
- Проект: PartnerSDK.FeatureSample
- Класс: SubscriptionResourceUsageRecords.cs
Запрос REST
Синтаксис запроса
Метод | Универсальный код ресурса (URI) запроса |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1 |
Параметры универсального кода ресурса (URI)
В этой таблице перечислены необходимые параметры запроса для получения сведений об использовании с оценкой.
Имя | Тип | Обязательно | Описание |
---|---|---|---|
customer-tenant-id | guid | Да | Идентификатор GUID, соответствующий клиенту. |
идентификатор подписки | guid | Да | Идентификатор GUID, соответствующий подписке. |
Заголовки запроса
Дополнительные сведения см. в статье о заголовках REST Центра партнеров.
Тело запроса
Нет.
Пример запроса
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 65b26053-37d0-4303-9fd1-46ad8012bcb6
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Ответ REST
При успешном выполнении запроса этот метод возвращает коллекцию ресурсов клиента AzureResourceMonthlyUsageRecord в тексте ответа.
Коды успешного выполнения и ошибок в ответе
Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.
Пример ответа
HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT
{
"totalCount":20,
"items":[{
"category":"Storage",
"subcategory":"LOCALLY REDUNDANT",
"quantityUsed":0.151287527825352,
"unit":"GB",
"id":"2a2419c0-cefe-46b2-8004-8eb002ad606c",
"name":"Azure Resource 1",
"totalCost":0.195779159290613,
"currencyLocale":"en-US",
"attributes":{
"objectType":"AzureResourceMonthlyUsageRecord"
}
},
{
"category":"Remote App",
"subcategory":"Remote App",
"quantityUsed":0.932546524299563,
"unit":"GB",
"id":"7e4099c8-2b3d-41a6-a1bd-d5cf315989b2",
"name":"Azure Resource 2",
"totalCost":0.920983775016379,
"currencyLocale":"en-US",
"attributes":{
"objectType":"AzureResourceMonthlyUsageRecord"
}
}],
"links":{
"self":{
"uri":"/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription>%20/usagerecords",
"method":"GET",
"headers":[]
}
},
"attributes":{
"objectType":"Collection"
}
}