更新超额

项目
02/09/2024

适用于

合作伙伴中心

相应的角色

全局管理员
管理员代理

注意

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

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

必备条件

合作伙伴中心身份验证中所述的凭据。此方案支持使用独立应用和应用+用户凭据进行身份验证。
客户 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。
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"
    }
}

Share via