取消 Azure 訂用帳戶
適用於:合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
如果遭到入侵或濫用,Azure 客戶訂用帳戶的合作夥伴可以直接從合作夥伴中心入口網站或 API 取消訂用帳戶,關閉其 Azure 方案訂用帳戶中探索到的可疑活動。
此 API 將會取消 Azure 訂用帳戶。 如果合作夥伴想要取消多個訂用帳戶,則必須個別呼叫 API 以取消每個訂用帳戶。
如果合作夥伴想要暫停其 Azure 方案,他們應該使用可用的現有 API, 依標識碼更新訂用帳戶。
下列 API 不支援取消 Azure 方案。
合作夥伴必須是具有 管理員 代理程式角色的全域 管理員 istrators,才能取消。
必要條件
合作夥伴中心驗證中所述 的認證 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
Customer_id。
Subscription_id。
Entitlement_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 | 值是表示客戶識別碼的字串。 |
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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
{
"id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"friendlyName": "Cancel_Azure_Subscription ",
"status": "active",
"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": []
}
}
}
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: 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": "active",
"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": []
}
}
下一步
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: