適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心
如果遭到入侵或濫用，Azure 客戶訂用帳戶的合作夥伴可以直接從合作夥伴中心入口網站或 API 取消訂用帳戶，關閉其 Azure 方案訂用帳戶中探索到的可疑活動。
此 API 將會取消 Azure 訂用帳戶。 如果合作夥伴想要取消多個訂用帳戶，則必須個別呼叫 API 以取消每個訂用帳戶。
如果合作夥伴想要暫停其 Azure 方案，他們應該使用可用的現有 API， 依標識碼更新訂用帳戶。
下列 API 不支援取消 Azure 方案。
合作夥伴必須同時具備全域管理員和管理代理角色，才能進行取消。
必要條件
如合作夥伴中心驗證所述的認證，此情境支援使用獨立應用程式和應用程式+使用者認證進行驗證。
客戶識別碼 (Customer_id)
訂閱ID。
權限碼_id。
C#
若要取消 Azure 訂用帳戶，您必須識別該訂用帳戶的客戶標識碼、訂用帳戶標識碼和權利標識碼。
若要取得客戶，請參閱 依 標識符取得客戶和 依客戶標識碼取得客戶 - REST API 以取得更多協助。
若要取得訂用帳戶，請參閱 依標識元 取得訂用帳戶和 依標識元取得訂用帳戶 - REST API 以取得更多說明。
若要取得權利，請參閱 取得訂用帳戶的 Azure 權利 - REST API。
REST 要求
請求語法
| 方法 | 要求 URI |
|---|---|
| POST | {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1 |
URI 參數
下表列出取消 Azure 訂用帳戶的必要查詢參數。
| 名稱 | 類型 | 必要項目 | 說明 |
|---|---|---|---|
| 客戶識別碼 | String（字串） | Y | 值是表示客戶識別碼的字串。 |
| 訂閱編號 | String（字串） | Y | 值是表示訂用帳戶標識碼的字串。 |
| 權限識別碼 | 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 程式代碼 | 錯誤碼 | 說明 |
|---|---|---|---|
| 錯誤的請求 | 400 | 900118 | 無效的客戶識別碼。 |
| 錯誤請求 | 400 | 800002 | 客戶標識符 {0} 應具有 GUID 格式 （xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx）。 |
| 錯誤請求 | 400 | 800002 | 需要訂用帳戶標識碼。 |
| 錯誤請求 | 400 | 800002 | 需要權利標識碼。 |
| 錯誤請求 | 400 | 800002 | 需要提供 Azure 權利取消請求的內容。 |
| 禁止 | 403 | 900159 | 具有帳戶標識碼 {0} 和組織標識碼 {1} 的合作夥伴與具有帳戶標識碼 {2} 和組織標識碼 {3}的客戶沒有商務關係。 |
| 錯誤的請求 | 400 | 900307 | 取消原因 '{0} 無效。 |
| 未找到 | 404 | 800111 | 無法找到具有 ID {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": []
}
}