サブスクリプションの登録状態を取得する

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

Azure 予約 VM インスタンスの購入が有効になっている顧客サブスクリプションのサブスクリプション登録状態を取得する方法。

パートナーセンター API を使用して Azure 予約 VM インスタンスを購入するには、少なくとも 1 つの既存の CSP Azure サブスクリプションが必要です。 [ サブスクリプションの登録 ] メソッドを使用すると、既存の CSP Azure サブスクリプションを登録して、Azure 予約 VM インスタンスを購入できます。このメソッドを使用すると、その登録の状態を取得できます。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
顧客 ID です (customer-tenant-id)。顧客の ID がわからない場合は、パートナーセンターで [顧客] ワークスペースを選択し、 次に顧客 の一覧から [顧客]、[ アカウント] の順に選択して、その ID を検索できます。お客様のアカウントページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。
サブスクリプション ID。

C#

サブスクリプションの登録状態を取得するには、まず、顧客 ID で IAggregatePartner.Customers.ById メソッドを使用して顧客を識別します。次に、サブスクリプション ID を持つ Subscription.ById() メソッドを呼び出してサブスクリプション操作へのインターフェイスを取得し、サブスクリプションを識別します。次に、RegistrationStatus プロパティを使用して現在のサブスクリプションの登録状態操作のインターフェイスを取得し、 Get メソッドまたは GetAsync メソッドを呼び出して SubscriptionRegistrationStatus オブジェクトを 取得します。

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

URI パラメーター

顧客とサブスクリプションを識別するには、次のパスパラメーターを使用します。

名前	Type	必須	説明
customer-id	string	はい	顧客を識別する GUID 形式の文字列。
subscription-id	string	はい	サブスクリプションを識別する GUID 形式の文字列。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

[要求本文]

なし。

要求の例

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105123
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

REST 応答

成功した場合、応答本文には SubscriptionRegistrationStatus リソースが含まれます。

応答の成功とエラーのコード

各応答には、成功または失敗を示す HTTP ステータスコードと、追加のデバッグ情報が付属しています。このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワークトレースツールを使用します。完全な一覧については、エラーコードに関するページを参照してください。

応答の例

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}