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

Статья
10/07/2024

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

Ресурс CustomerUsageSummary можно использовать для получения использования определенной службы Или ресурса Azure в течение текущего периода выставления счетов.

Примечание.

Как правило, ежедневные данные об использовании без оценки доступны через API или портал Центра партнеров через 24 часа. В зависимости от расположения и времени использования отчета о счетчиках могут возникнуть дополнительные задержки.

Иногда вы можете не видеть последние необязанные данные об использовании с начала месяца до тех пор, пока не будут доставлены данные о выставлении счетов за использование за предыдущий месяц. Это позволяет убедиться, что данные об использовании выставления счетов эффективно предоставляются в рамках SLA. Получив данные об использовании с выставленным счетом, вы можете начать получение всех обновленных необновенных данных об использовании с начала месяца.

Необходимые компоненты

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

C#

Чтобы получить сводку по использованию для всех подписок клиента, выполните следующее:

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

Вызовите свойство UsageSummary, а затем методы Get() или GetAsync():

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

var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();

Пример см. в следующем примере:

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

Запрос REST

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

Способ	URI запроса
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1

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

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

Имя.	Type	Обязательно	Описание
customer-tenant-id	guid	Y	GUID, соответствующий клиенту.

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

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

Текст запроса

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-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

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

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

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

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

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

Для клиентов с подписками 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

{
    "budget":{
        "ammount":300.000000,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "id":"65726577-C208-40FD-9735-8C85AC9CAC68",
    "name":"600 test",
    "billingStartDate":"2016-02-06T00:00:00-08:00",
    "billingEndDate":"2016-03-05T00:00:00-08:00",
    "totalCost":0.0,
    "currencyLocale":"en-US",
    "lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
    "links":{
        "self":{
            "uri":"/customers/{customer-tenant-id}/usagesummary",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"CustomerUsageSummary"
    }
}

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

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

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

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

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

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Modern Azure Customer UK",
    "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",
    "attributes": {
        "objectType": "CustomerUsageSummary"
    }
}

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