Обновление переполнения

Статья
03/07/2025

Применимо к

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

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

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

Примечание.

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

Используется для задания лимита превышения для конкретного клиента в подписке на потребление. Можно также использовать для устранения избытка, установив значение false. Превышение позволяет клиенту продолжать использовать службы, если они используют службу за пределами указанных ограничений. Предел превышения определяет, к чему будет начисляться превышение подписки по модели "оплата по мере использования".

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

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

Запрос REST

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

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

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

Параметр URI

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

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

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

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

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

Имя.	Тип	Описание
azureEntitlementId	идентификатор GUID	GUID, определяющий подписку на использование в случае перерасхода.
partnerId	guid	PartnerID косвенного торгового посредника. Применимо только для двухуровневой модели (косвенный поставщик).
overageEnabled	bool	Укажите, следует ли включить превышение потребления для данной подписки на потребление.

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

PUT 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

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

Ответ 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

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

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