更新超额

适用于

  • 合作伙伴中心

相应的角色

  • 管理员代理

注意

基于许可证的服务的新商务体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。 有关详细信息，请参阅新商业体验概述。

用于将给定客户的超额设置为消耗订阅。 还可以通过将超额设置为 false 来删除超额。 超额使客户能够继续使用服务（如果服务超出规定的限制）。 超额定义消耗订阅超额即用即付将累算到。

资源组始终为 M365。 合作伙伴可以将标记和位置添加到资源组，但无法更改它。

先决条件

  • 合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和 App+User 凭据进行身份验证。

  • 客户 ID (customer-tenant-id)。 如果不知道客户的 ID，可以通过选择“客户”工作区，然后从客户列表中选择客户，然后选择“帐户”，在合作伙伴中心中查找该 ID。 在客户的“帐户”页上的“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 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 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