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

適用対象: パートナー センター | 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
        }
    ]
}

関連項目