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

Применимо к

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

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

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

Примечание.

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

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

Группа ресурсов всегда является M365. Партнеры могут добавлять теги и расположения в группу ресурсов, но не могут его изменить.

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

  • Учетные данные, описанные в статье об аутентификации в Центре партнеров. Этот сценарий поддерживает аутентификацию с использованием как автономных учетных данных приложения, так и учетных данных приложения с пользователем.

  • Идентификатор клиента (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, определяющий подписку на использование в случае перерасхода.
azureResourceGroup объекта Optional. Имя тегов и расположение группы ресурсов.
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: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "overageEnabled": true
}

Ответ REST

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

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

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

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

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}
  • Last updated on