新しいコマース移行をスケジュールする

[アーティクル]
07/25/2023

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

対象ロール: グローバル管理者｜管理者代理人｜販売代理人

この記事では、新しいコマースエクスペリエンスをスケジュールする方法について説明します。

前提条件

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

REST 要求

要求の構文

方法	要求 URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

URI パラメーター

次の表に、新しいコマース移行を作成するために必要なクエリパラメーターを示します。

Name	Type	必須	説明
customer-tenant-id	string	はい	顧客を識別する GUID 形式の文字列。

要求ヘッダー

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

要求本文

次の表では、要求本文のサブスクリプションのプロパティについて説明します。

プロパティ	Type	必須	説明
currentSubscriptionId	string	はい	移行に検証が必要なサブスクリプションを示すサブスクリプション識別子。
termDuration	string	いいえ	期間は、移行時に変更するように指定できます。
billingCycle	string	いいえ	課金サイクルは、移行時に変更するように指定できます。
purchaseFullTerm	[bool]	いいえ	移行時に NCE で新しい用語を開始できます。
数量	INT	いいえ	サブスクリプションのライセンス数は、移行時に増減できます。
customTermEndDate	DATETIME	いいえ	終了日は、既存の試用版以外の OnlineServicesNCE サブスクリプションまたはカレンダー月に合わせて設定できます。サブスクリプションの終了日の調整の詳細については、パートナーセンターでサブスクリプションの終了日を調整する
targetDate	DATETIME	必須 (migrateOnRenewal が null/false の場合)	移行をスケジュールするターゲット日付。指定した日付に targetDate が設定されている場合、migrationOnRenewal を null または false に設定できます。
migrateOnRenewal	[bool]	必須 (targetDate が null の場合)	migrateOnRenewal にフラグが true に設定されている場合、移行をスケジュールするために targetDate を指定する必要はありません。
addOnMigrationSchedules	[bool]	いいえ	スケジュールされた移行に含めるアドオンサブスクリプションの一覧が含まれます。

要求の例

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

REST 応答

成功した場合、このメソッドは、応答本文で移行されるサブスクリプション (移行オブジェクト) の詳細を返します。

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

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

応答例

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Share via