移行のためにサブスクリプションを検証する

  • [アーティクル]

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

新しいコマース エクスペリエンスへの移行のサブスクリプションを検証する方法

前提条件

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

  • 顧客 ID です (customer-tenant-id)。 顧客の ID がわからない場合は、[顧客] ワークスペースを選択し、顧客の一覧から顧客を選択し、[アカウント] を選択して、パートナー センターで検索できます。 お客様のアカウント ページで、[顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。

  • 現在のサブスクリプション ID

レート制限

Validate Migration API の制限は、パートナーと顧客の組み合わせごとに 5 分で 450 回の呼び出しです。 レート制限と調整の詳細については、API 調整のガイダンスを参照してください。

REST 要求

要求の構文

認証方法 要求 URI
投稿 {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

URI パラメーター

次の表に、移行のサブスクリプションを検証するために必要なクエリ パラメーターを示します。

名前 タイプ Required 説明
customer-tenant-id string はい 顧客を識別する GUID 形式の文字列。
termDuration string いいえ 期間は、移行時に変更できます。
billingCycle string いいえ 課金サイクルは、移行時に変更できます。
purchaseFullTerm bool いいえ 移行時に NCE で新しい用語を開始できます。
quantity int いいえ サブスクリプションのライセンス数は、移行時に増減できます。
customTermEndDate datetime いいえ 終了日は、既存の非トライアル OnlineServicesNCE サブスクリプションまたはカレンダー月に合わせて設定できます。 サブスクリプションの終了日の調整の詳細については、パートナー センターでサブスクリプションの終了日を調整する

要求ヘッダー

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

リクエストの本文

次の表では、要求本文の Subscription プロパティについて説明します。

プロパティ タイプ Required 説明
currentSubscriptionId string はい 移行に検証が必要なサブスクリプションを示すサブスクリプション識別子。

要求の例

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

REST 応答

成功した場合、このメソッドは応答本文で "isEligible" ブール値を返し、現在のサブスクリプションが新しいコマースへの移行の対象かどうかを示します。 Validate Migration API では、サブスクリプションの New Commerce でのプロモーションの資格に関する情報は提供されません。

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

各応答には、成功または失敗と余分なデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。

応答例

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }