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

[アーティクル]
09/20/2024

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

対象ロール: 管理エージェント | 販売エージェント

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

前提条件

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

REST 要求

要求の構文

Method	要求 URI
投稿	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

URI パラメーター

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

名前	タイプ	必須	説明
customer-tenant-id	string	はい	顧客を識別する GUID 形式の文字列。

要求ヘッダー

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

要求本文

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

プロパティ	Type	必須	説明
currentSubscriptionId	string	はい	移行に検証が必要なサブスクリプションを示すサブスクリプション識別子。
termDuration	string	いいえ	期間は、移行時に変更するように指定できます。
billingCycle	string	いいえ	課金サイクルは、移行時に変更するように指定できます。
purchaseFullTerm	[bool]	いいえ	移行時に NCE で新しい用語を開始できます。
quantity	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
        }
    ]
}

次の方法で共有