更新超量資訊

適用於

合作夥伴中心

適當的角色

管理代理人

注意

授權型服務的新商務體驗包含許多新功能，可供所有雲端解決方案提供者（CSP）使用。如需詳細資訊，請參閱新商務體驗概覽。

用於將特定客戶的超額使用分配至消費型訂閱。也可以將設定值改為 false 後即可移除超額。超額可讓客戶在使用超出規定限制的服務時繼續使用服務。超額是指訂用帳戶中的使用量超出後，依隨用隨付模式累計的使用量。

資源群組永遠是 M365。合作夥伴可以為資源群組新增標籤和位置，但無法更改。

必要條件

憑證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的識別碼，可以在合作夥伴中心中，先選取[客戶]工作區，再從客戶清單中選擇該客戶，然後選擇[帳戶]。在客戶的 [帳戶] 頁面上，尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼]。 Microsoft ID 與客戶 ID (customer-tenant-id) 相同。
至少有一個符合條件的超額訂閱已被購買給客戶。

REST 要求

[賣出] /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	Required. 定義超額使用量訂閱的 GUID。
azureResourceGroup	物件	Optional. 標籤的名稱值以及資源群組的位置。
partnerId	guid	僅適用於兩層級模型（間接提供者）。間接轉銷商的夥伴識別碼。
overageEnabled	bool	Required. 指出是否應該為某一特定的消費訂閱啟用超額功能。

要求範例

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"
    }
}

意見反應

此頁面對您有幫助嗎？

上次更新時間： 2026-08-13