新しいコマース移行スケジュールをキャンセルする
適用対象: パートナー センター | 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/{scheduleID}/cancel |
URI パラメーター
次の表に、新しいコマース移行を作成するために必要なクエリ パラメーターを示します。
名前 | タイプ | 必須 | 説明 |
---|---|---|---|
customer-tenant-ID | string | はい | 顧客を識別する GUID 形式の文字列。 |
scheduleID | string | はい | スケジュールを識別する GUID 形式の文字列 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
応答の本文
次の表では、応答の subscription プロパティについて説明します。
プロパティ | Type | 必須 | 説明 |
---|---|---|---|
id | String | いいえ | スケジュールを識別する GUID 形式の文字列 |
currentSubscriptionID | string | いいえ | 移行に検証が必要なサブスクリプションを示すサブスクリプション識別子。 |
termDuration | string | いいえ | 移行時に変更するように指定された期間。 |
billingCycle | string | いいえ | 移行時に変更するように指定された課金サイクル。 |
purchaseFullTerm | [bool] | いいえ | 移行時に NCE で新しい用語が開始されました。 |
quantity | int | いいえ | 移行時にライセンス数が増減しました。 |
customTermEndDate | datetime | いいえ | 終了日は、既存の非トライアル OnlineServicesNCE サブスクリプションまたはカレンダー月に合わせて設定できます。 サブスクリプションの終了日の調整の詳細については、次を参照してください。 パートナー センターでのサブスクリプションの終了日の調整 |
targetDate | datetime | いいえ | 移行をスケジュールするターゲット日付。 |
migrateOnRenewal | [bool] | いいえ | 更新時にサブスクリプションを移行できるかどうかを示します。 |
status | string | いいえ | 移行スケジュールの状態 |
createdTime | datetime | いいえ | スケジュールが作成されたとき |
lastModifiedTime | datetime | いいえ | スケジュールが最後に変更されたとき |
REST 応答
成功した場合、このメソッドは、応答本文で移行中の サブスクリプション (移行オブジェクト) の詳細を返します。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。
応答例
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Cancelled",
"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"
}