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

Статья
06/27/2024

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

Вы можете обновить бюджет расходов (объект Spending Budget) в сводке по использованию клиента (ресурс CustomerUsageSummary).

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

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

C#

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

Создайте новый объект SpendingBudget с обновленной суммой.
Используйте коллекцию IAggregatePartner.Customers для вызова метода ById() с указанным идентификатором клиента.
Вызовите метод Get или GetAsync, чтобы получить бюджет использования клиента.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

// Create a new spending budget with the udpated amount.
var newUsageBudget = new SpendingBudget()
{
    Amount = 100
};

// Update the customer's usage budget.
var usageBudget = partnerOperations.Customers.ById(selectedCustomerId).UsageBudget.Get();

Запрос REST

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

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

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

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

Имя.	Type	Обязательно	Описание
customer-tenant-id	guid	Y	Это значение — идентификатор GUID, отформатированный клиентом клиента , который позволяет торговому посреднику фильтровать результаты для данного клиента, который принадлежит торговому посреднику.

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

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

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

Полный ресурс.

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

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/usagebudget HTTP/1.1
Authorization: Bearer <token>
Accept: application/json, text/plain, */*
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"

Ответ REST

При успешном выполнении этот метод возвращает бюджет расходов пользователя с обновленным объемом.

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

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

Пример ответа

HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "amount": 100,
    "usageSpendingBudget": 100,
    "attributes": {
        "objectType": "SpendingBudget"
    },
    "links": {
        "self": {
            "uri": "/v1/customers/<customer-tenant-id>/usagebudget",
            "method": "GET",
            "headers": []
        }
    }
}

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