次の方法で共有

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

  • [アーティクル]

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

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

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

パートナーが Azure プランを中断する場合は、使用可能な既存の API を使用する必要があります。 ID でサブスクリプションを更新。

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

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

前提条件

C#

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

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 サブスクリプションの権利の識別子を示す文字列です。

要求ヘッダー

「<Partner Center 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 顧客 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 {0} と組織 ID {1} を持つパートナーは、アカウント ID {2} と組織 ID {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: 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": []
 }
}

関連するコンテンツ