Получение превышения

Статья
03/07/2025

Применимо к

Центр партнеров

Соответствующие роли

Агент по администрированию

Примечание.

Новые коммерческие возможности для служб на основе лицензий включают множество новых функций и доступны для всех поставщиков облачных решений (ПОСТАВЩИКОВ УСЛУГ). Для получения дополнительной информации см. обзор новых коммерческих возможностей.

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

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

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

Запрос REST

[GET] /customers/{customer-tenant-id}/subscriptions/overage

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

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

Параметр URI

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

Имя.	Тип	Обязательно	Описание
идентефикатор клиента-арендатора	guid	Y	GUID, соответствующий арендатору клиента.

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

Для получения дополнительной информации см. заголовки REST Центра партнеров.

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

нет

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

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Ответ REST

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

Коды успешных и ошибочных ответов

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

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

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "totalCount": 1,
    "items": [
        {
            "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
            "partnerId": "1234",
            "type": "PhoneServices",
            "overageEnabled": true,
            "links": {
                "overage": {
                    "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
                    "method": "GET",
                    "headers": []
                }
            },
            "attributes": {
                "objectType": "Overage"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

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