サブスクリプションの Azure エンタイトルメントを取得する

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

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

パートナーは、この API を使用してサブスクリプションの Azure エンタイトルメントを表示できます。この API は、顧客のサブスクリプション識別子の権利を取得します。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
Customer_id。
Subscription_id。
Entitlement_id。

C#

Azure サブスクリプションを取り消すには、取り消す 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} HTTP/1.1

URI パラメーター

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

名前	タイプ	必須	説明
customer_id	String	年	値は、顧客の識別子を表す文字列です。
subscription_id	String	年	値は、顧客の識別子を表す文字列です。
entitlement_id	String	年	値は、Azure サブスクリプションの権利の識別子を示す文字列です。

要求ヘッダー

パートナーセンターの REST ヘッダーを参照してください。

要求本文

要求本文は必要ありません。

要求の例

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd

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 エンタイトルメントが見つかりません。

応答の例

応答は、特定の顧客の Azure エンタイトルメントを返します。

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": “inactive", 
    "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