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

[アーティクル]
10/28/2024

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

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

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンアプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
顧客 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"
    }

次の方法で共有