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

Статья
10/07/2024

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

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

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

Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает только проверку подлинности с использованием учетных данных приложений и пользователей.
Идентификатор клиента (customer-tenant-id). Если вы не знаете идентификатор клиента, вы можете найти его в Центре партнеров , выбрав рабочую область Клиенты , а затем клиента в списке клиентов, а затем Учетная запись. На странице учетной записи клиента найдите Идентификатор Майкрософт в разделе Сведения об учетной записи клиента. Идентификатор Майкрософт совпадает с идентификатором клиента (customer-tenant-id).
Идентификатор подписки

C#

Чтобы получить сводку по использованию подписки клиента, выполните приведенные ниже действия.

Используйте коллекцию IAggregatePartner.Customers для вызова метода ById().

Затем вызовите свойства Subscriptions и UsageSummary . Завершите, вызвав методы Get() или GetAsync().

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
// var selectedSubscriptionId as string;

var subscriptionUsageSummary = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageSummary.Get();

Пример см. в следующих статьях:

Пример: Тестовое консольное приложение
Проект: PartnerSDK.FeatureSamples
Класс: GetSubscriptionUsageSummary.cs

Запрос REST

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

Метод	Универсальный код ресурса (URI) запроса
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/usagesummary HTTP/1.1

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

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

Имя	Тип	Обязательно	Описание
customer-tenant-id	guid	Да	Идентификатор GUID, соответствующий клиенту.
идентификатор подписки	guid	Да	Идентификатор GUID, соответствующий идентификатору подписки. Для плана Azure это идентификатор соответствующего ресурса подписки Центра партнеров, который представляет план Azure. Для ресурсов подписки на план Azure укажите plan-id* в качестве идентификатора подписки в этом маршруте.*

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

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

Тело запроса

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Ответ REST

В случае успешного выполнения этот метод возвращает ресурс SubscriptionUsageSummary в тексте ответа.

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

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

Пример ответа для подписок Microsoft Azure (MS-AZR-0145P)

В этом примере клиент приобрел предложение 145P Azure PayG .

Для клиентов с подписками Microsoft Azure (MS-AZR-0145P) изменения в ответе API не будут.

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Microsoft Azure",
    "name": "Microsoft Azure",
    "billingStartDate": "2019-08-28T00:00:00-07:00",
    "billingEndDate": "2019-09-27T00:00:00-07:00",
    "totalCost": 22.861172,
    "currencyLocale": "fr-FR",
    "lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

Пример ответа REST для плана Azure

В этом примере клиент приобрел план Azure.

Для клиентов с планами Azure существуют следующие изменения в ответе API:

currencyLocale заменяется на currencyCode
usdTotalCost — это новое поле

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
    "resourceName": "Azure plan",
    "billingStartDate": "2019-09-01T00:00:00+00:00",
    "billingEndDate": "2019-10-01T00:00:00+00:00",
    "totalCost": 28.82860766744404945074,
    "currencyCode": "GBP",
    "usdTotalCost": 35.23000000000000362337,
    "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

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