共用方式為

取消 Azure 訂用帳戶

  • 發行項

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

如果遭到入侵或濫用，Azure 客戶訂用帳戶的合作夥伴可以直接從合作夥伴中心入口網站或 API 取消訂用帳戶，關閉其 Azure 方案訂用帳戶中探索到的可疑活動。

此 API 將會取消 Azure 訂用帳戶。 如果合作夥伴想要取消多個訂用帳戶，則必須個別呼叫 API 以取消每個訂用帳戶。

如果合作夥伴想要暫停其 Azure 方案，他們應該使用可用的現有 API， 依標識碼更新訂用帳戶。

下列 API 不支援取消 Azure 方案。

合作夥伴必須是具有管理員代理程式角色的全域管理員，才能取消。

必要條件

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

  • Customer_id。

  • Subscription_id。

  • Entitlement_id。

C#

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

REST 要求

要求語法

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

URI 參數

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

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

要求標頭

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

要求本文

HTTP
{ "cancellationReason": "compromise" }

要求範例

POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
 "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
 "links": {
  "self": {
  "uri":
  "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
  "method": "GET",
"headers": []
   }
  }
}

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 權利。

回應範例

取消訂閱的回應包含權利狀態。 預期大約 10 分鐘，狀態會反映 （也就是作用中到非使用中）。

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"links": {
"self": {
"uri":
"/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
 }
}

相關內容