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

[アーティクル]
10/26/2023

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

この記事では、新しいコマース移行スケジュールを更新する方法について説明します。パートナーは、スケジュールされたターゲット日より前に更新できます。

重要

この API は現在、サンドボックステナントでのみ使用できます。

前提条件

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

REST 要求

要求の構文

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

URI パラメーター

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

名前	Type	必須	説明
customer-tenant-id	string	はい	顧客を識別する GUID 形式の文字列。
scheduleID	string	はい	スケジュールを識別する GUID 形式の文字列

要求ヘッダー

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

[要求本文]

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

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

要求の例

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

REST 応答

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

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

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

応答例

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}

Share via