Share via

取得訂用帳戶的 Azure 權利

  • 文章

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心

合作夥伴可以使用此 API 來檢視訂用帳戶的 Azure 權利，以取得客戶的訂用帳戶標識碼權利。

必要條件

  • 認證，如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
  • Customer_id。
  • Subscription_id。
  • Entitlement_id。

C#

若要取消 Azure 訂用帳戶，您必須識別您想要取消之 Azure 訂用帳戶的客戶標識碼、訂用帳戶標識碼和權利標識碼。

REST 要求

要求語法

方法 要求 URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} HTTP/1.1

URI 參數

下表列出取消 Azure 訂用帳戶的必要查詢參數。

名稱 輸入 必要項目 說明
客戶識別碼 String Y 值是表示客戶識別碼的字串。
subscription_id String Y 值是表示客戶識別碼的字串。
entitlement_id String Y 值是表示 Azure 訂用帳戶權利標識碼的字串。

要求標頭

請參閱 合作夥伴中心 REST 標頭。

要求本文

不需要要求本文。

要求範例

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd

REST 回應

如果成功，此方法會在 回應本文中傳回訂 用帳戶資源的 Azure 權利。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗，以及更多偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。 如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

HTTP 狀態 HTTP 程式代碼 錯誤碼 說明
BadRequest 400 900118 無效的客戶識別碼。
BadRequest 400 800002 客戶標識符 {0} 應具有 GUID 格式 （xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx）。
BadRequest 400 800002 需要訂用帳戶標識碼。
BadRequest 400 800002 需要權利標識碼。
BadRequest 400 800002 需要 Azure 權利取消要求內容。
禁止 403 900159 具有帳戶標識碼 {0} 和組織標識碼 {1} 的合作夥伴與具有帳戶標識碼 {2} 和組織標識碼 {3}的客戶沒有商務關係。
BadRequest 400 900307 取消原因 '{0} 無效。
NotFound 404 800111 找不到標識碼為的 {0} Azure 權利。

回應範例

回應會傳回指定客戶的 Azure 權利。

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT

{ 
    "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
    "friendlyName": " Cancel_Azure_Subscription", 
    "status": “inactive", 
    "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1", 
    "links": { 
        "self": { 
            "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
            "method": "GET", 
            "headers": [] 
        } 
    }

下一步