コマーシャル マーケットプレース SaaS 製品のサンドボックス サブスクリプションをアクティブ化して課金を有効にする

  • [アーティクル]

統合サンドボックス アカウントから商用マーケットプレース のサービスとしてのソフトウェア (SaaS) 製品のサブスクリプションをアクティブ化して課金を有効にする方法。

Note

統合サンドボックス アカウントからコマーシャル マーケットプレース SaaS 製品のサブスクリプションをアクティブ化することのみが可能です。 運用サブスクリプションをお持ちの場合は、パブリッシャーのサイトにアクセスしてセットアップ プロセスを完了する必要があります。 サブスクリプションの課金は、セットアップが完了した後にのみ開始されます。

前提条件

  • パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
  • コマーシャル マーケットプレース SaaS 製品のアクティブなサブスクリプションを持つ顧客との統合サンドボックス パートナー アカウント。
  • パートナー センター .NET SDK を使用しているパートナーの場合は、SDK バージョン 1.14.0 以降を使用してこの機能にアクセスする必要があります。

重要

2023 年 6 月の時点で、最新のパートナー センター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。 SDK リリースは、有用な情報が記載された readme ファイルと一緒に GitHub からダウンロードできます。

パートナーの皆様には、パートナー センター REST API を引き続き使用することをお勧めします。

C#

コマーシャル マーケットプレース SaaS 製品のサブスクリプションをアクティブ化するには、次の手順に従います。

  1. サブスクリプション操作へのインターフェイスを使用できるようにします。 顧客を識別し、試用版サブスクリプションのサブスクリプション識別子を指定する必要があります。

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

  2. アクティブ化操作を使用してサブスクリプションを アクティブ化 します。

    var subscriptionActivationResult = subscriptionOperations.Activate();

REST 要求

要求の構文

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

URI パラメーター

名前 タイプ Required 説明
customer-tenant-id guid Y 値は、GUID 形式の顧客テナント識別子 (customer-tenant-id) です。これにより、顧客を指定できます。
subscription-id guid Y 値は 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"
}