サブスクリプションを登録する

[アーティクル]
01/11/2024

既存のサブスクリプションを登録して、Azure 予約の注文を有効にします。

Azure 予約を購入するには、少なくとも 1 つの既存の CSP Azure サブスクリプションが必要です。この方法では、既存の CSP Azure サブスクリプションを登録して、Azure 予約を購入できるようにします。

前提条件

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

C#

顧客のサブスクリプションを登録するには、顧客 ID を指定して IAggregatePartner.Customers.ById メソッドを呼び出して、サブスクリプション操作へのインターフェイスを取得して顧客を識別します。次に、サブスクリプション ID を 指定して Subscription.ById() メソッドを呼び出して、登録しているサブスクリプションを識別します。

最後に、Registration.Register() メソッドを呼び出してサブスクリプションを登録し、サブスクリプションの登録状態を取得するために使用できる URI を取得します。詳細については、「サブスクリプションの登録状態を取得する」を参照してください。

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

// Retrieve the subscription registration details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).Registration.Register();

REST 要求

要求の構文

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

URI パラメーター

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

名前	タイプ	Required	説明
customer-id	string	はい	顧客を識別する GUID 形式の文字列。
subscription-id	string	はい	サブスクリプションを識別する GUID 形式の文字列。パートナーは、新しいコマースケースに Azure プラン ID を使用する必要があります。

要求ヘッダー

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

要求本文

なし。

要求の例

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrations 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 応答

成功した場合、応答には、サブスクリプションの登録状態を取得するために使用できる URI を持つ Location ヘッダーが含まれます。他の関連する REST API で使用するために、この URI を保存します。状態を取得する方法の例については、「サブスクリプションの登録状態を取得する」を参照してください。

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

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

応答の例

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525