新しいコマース移行を作成する

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

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

[前提条件]

  • パートナー センター認証で説明されている資格証明。 このシナリオでは、スタンドアロン アプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。

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

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

レート制限

Create Migration API の制限は、パートナーによる 5 分間の呼び出し 100 回です。 レート制限と調整の詳細については、 API 調整ガイダンスを参照してください。

REST 要求

リクエスト構文

メソッド URI リクエスト
投稿 {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1

URI パラメーター

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

名前 タイプ 必須 説明
カスタマー・テナントID (customer-tenant-id) ひも イエス 顧客を識別する GUID 形式の文字列。

要求ヘッダー

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

リクエストの本文

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

プロパティ タイプ 必須 説明
現在のサブスクリプションID ひも イエス 移行のために検証が必要なサブスクリプションを示すサブスクリプション識別子。
termDuration (期間) ひも いいえ 期間は移行時に変更できます。
billingCycle ひも いいえ 請求サイクルは移行時に変更できます。
購入フルターム ブール (bool) いいえ 移行時に NCE で新しい期間を開始できます。
量 整数 (int) いいえ サブスクリプションのライセンス数量は、移行時に増減できます。
customTermEndDate datetime いいえ 終了日は、既存の非試用版 OnlineServicesNCE サブスクリプションまたは暦月に合わせて設定できます。 サブスクリプションの終了日の調整の詳細については、「パートナー センターでサブスクリプションの終了日を調整する」を参照してください。

要求の例

ネストされたアドオン (アドオンサブスクリプションとアドオンサブスクリプション) は、リクエスト本文に addOnMigrations 内のフラットリストとして記述する必要があり、リクエスト内の他のアドオンサブスクリプション内にネストしないでください。リクエスト本文にアドオンを書き込む方法については、最後のリクエストの例を参照してください。

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

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

REST 応答

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

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

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

応答例

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}
  • Last updated on