適切な役割：管理者エージェント
この記事では、統合サンドボックス アカウントから商用マーケットプレース のサービスとしてのソフトウェア (SaaS) 製品のサブスクリプションをアクティブ化して課金を有効にする方法について説明します。
注
統合サンドボックス アカウントからコマーシャル マーケットプレース SaaS 製品のサブスクリプションをアクティブ化することのみが可能です。 運用サブスクリプションをお持ちの場合は、パブリッシャーのサイトにアクセスしてセットアップ プロセスを完了する必要があります。 サブスクリプションの課金は、セットアップが完了した後にのみ開始されます。
[前提条件]
- パートナー センター認証で説明されている資格証明。 このシナリオでは、スタンドアロン アプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
- コマーシャル マーケットプレース SaaS 製品のアクティブなサブスクリプションを持つ顧客との統合サンドボックス パートナー アカウント。
- パートナー センター .NET SDK を使用しているパートナーの場合は、SDK バージョン 1.14.0 以降を使用してこの機能にアクセスする必要があります。
Von Bedeutung
2023 年 6 月の時点で、最新のパートナー センター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。 有用な情報を含む readme ファイルと共に、GitHub から SDK リリースをダウンロードできます。
パートナーは、引き続き パートナー センター REST API を使用することをお勧めします。
C# の使用
コマーシャル マーケットプレース SaaS 製品のサブスクリプションをアクティブ化するには、次の手順に従います。
サブスクリプション操作へのインターフェイスを使用できるようにします。 顧客を識別し、試用版サブスクリプションのサブスクリプション識別子を指定する必要があります。
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);アクティブ化操作を使用してサブスクリプションを アクティブ化 します。
var subscriptionActivationResult = subscriptionOperations.Activate();
REST 要求を送信する
REST 要求を送信するには、次の構文を使用します。
リクエスト構文
| メソッド | 要求 URI |
|---|---|
| 投稿 | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1 |
URI パラメーター
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
| customer-tenant-id | GUID（グローバルユニーク識別子） | 年 | 値は、GUID 形式の顧客テナント識別子 (customer-tenant-id) です。これにより、顧客を指定できます。 |
| subscription-id | guid | 年 | 値は GUID 形式のサブスクリプション識別子 (subscription-id) であり、サブスクリプションを指定できます。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
なし。
要求の例
POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
REST 応答を確認する
このメソッドは、 subscription-id プロパティと status プロパティを返します。
応答の成功とエラー コード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、パートナー センターの REST エラー コード 参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
{
"subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"status":"Success"
}