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

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

関連項目