Превышение обновлений

Статья
02/09/2024

Применимо к:

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

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

Глобальный администратор
Агент по администрированию

Примечание

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

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

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

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

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

Имя	Тип	Обязательно	Описание
customer-tenant-id	guid	Да	Идентификатор 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"
    }
}

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