超额

项目
07/19/2022

适用于

合作伙伴中心

相应的角色

全局管理员
管理员代理

注意

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

用于为给定客户超额。超额使客户能够继续使用服务，如果他们使用超出规定限制的服务。超额定义消耗订阅超额即用即付。

必备条件

合作伙伴中心身份验证中所述的凭据。此方案支持使用独立应用和 App+用户凭据进行身份验证。
客户 ID (customer-tenant-id)。如果不知道客户的 ID，则可以在合作伙伴中心仪表板中查找它。从“合作伙伴中心”菜单中选择“CSP” ，然后选择“客户” 。从客户列表中选择客户，然后选择“帐户” 。在客户的“帐户”页上的“客户帐户信息” 部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id) 相同。
转换的订阅的一个订阅 ID。

REST 请求

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

请求语法

方法	请求 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI 参数

使用以下查询参数返回客户的超额。

名称	类型	必需	说明
customer-tenant-id	guid	Y	对应于客户的租户的 GUID。

请求标头

有关详细信息，请参阅合作伙伴中心 REST 标头。

请求正文

无

请求示例

GET 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

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

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