Azure サブスクリプションを取り消す

[アーティクル]
02/05/2024

適用対象: パートナーセンター | 21Vianet が運営するパートナーセンター | Microsoft Cloud for US Government のパートナーセンター

侵害や不正使用が発生した場合、Azure 顧客サブスクリプションを持つパートナーは、パートナーセンターポータルまたは API から直接サブスクリプションを取り消し、Azure プランサブスクリプションで検出された疑わしいアクティビティをシャットダウンできます。

この API は、Azure サブスクリプションを取り消します。パートナーが複数のサブスクリプションをキャンセルする場合は、API を個別に呼び出して各サブスクリプションを取り消す必要があります。

パートナーが Azure プランを一時停止する場合は、使用可能な既存の API を使用する必要があります。ID でサブスクリプションを更新してください。

Azure プランの取り消しは、次の API ではサポートされていません。

取り消すには、パートナーがグローバル管理管理エージェントロールを持つユーザーである必要があります。

前提条件

パートナーセンター認証の説明に従った資格情報このシナリオでは、スタンドアロンのアプリとアプリ + ユーザーの両方の資格情報を使用した認証がサポートされます。
Customer_id。
Subscription_id。
Entitlement_id。

C#

Azure サブスクリプションを取り消すには、そのサブスクリプションの顧客 ID、サブスクリプション ID、エンタイトルメント ID を識別する必要があります。

顧客を取得するには、「ID で顧客を取得する」と「顧客 ID で顧客を取得する - REST API」を参照してください。
サブスクリプションを取得するには、「ID でサブスクリプションを取得する」と「ID でサブスクリプションを取得する - REST API」を参照してください。
権利を取得するには、「サブスクリプションの Azure エンタイトルメントを取得する - REST API」を参照してください。

REST 要求

要求の構文

Method	要求 URI
投稿	{baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

URI パラメーター

次の表に、Azure サブスクリプションを取り消すために必要なクエリパラメーターを示します。

名前	タイプ	必須	説明
customer_id	String	年	値は、顧客の識別子を表す文字列です。
subscription_id	String	年	値は、顧客の識別子を表す文字列です。
entitlement_id	String	年	値は、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	顧客 ID が無効です。
BadRequest	400	800002	顧客 ID {0} には GUID 形式 (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) が必要です。
BadRequest	400	800002	サブスクリプション ID が必要です。
BadRequest	400	800002	エンタイトルメント ID が必要です。
BadRequest	400	800002	Azure エンタイトルメントキャンセル要求のコンテンツが必要です。
Forbidden	403	900159	アカウント ID と組織 ID {1} を持つパートナーには、アカウント ID {0} と組織 ID {2}{3}を持つ顧客との商取引関係はありません。
BadRequest	400	900307	キャンセル理由 '{0} が無効です。
NotFound	404	800111	ID {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": []
 }
}

Share via