切り替えに関するリソース

適用対象

適切なロール

Note

ライセンスベースのサービスの新しいコマースエクスペリエンスには、多くの新機能が含まれており、すべてのクラウドソリューションプロバイダー (CSP) で利用できます。詳細については、新しいコマースエクスペリエンスの概要を参照してください。

ある新しいコマースサブスクリプションから別のコマースサブスクリプションに移行するために使用されるリソースについて説明します。

TransitionEligibility

個々のサブスクリプション移行リソースの動作について説明します。

プロパティ	タイプ	説明
CatalogItemId	string	チェック対象のカタログアイテム ID。
Title	string	SKU タイトル。
説明	string	SKU の説明。
数量（Quantity）	integer	購入する新しいオファーの数量。
対象	TransitionEligibilityDetail の一覧	移行の適格性の詳細の一覧。
SubscriptionEligibilities	TargetSubscriptionEligibilityDetail の一覧	移行の対象となるサブスクリプションの一覧。

個々のターゲットサブスクリプションの適格性の詳細リソースの動作について説明します。

プロパティ	タイプ	説明
IsEligible	boolean	適格性が有効かどうかを返します。
SubscriptionId	string	サブスクリプションの ID を返します。
SubscriptionFriendlyName	string	サブスクリプションのフレンドリ名を返します。
SubscriptionTermDuration	string	サブスクリプションの期間を返します。
SubscriptionBillingCycle	BillingCycleType	サブスクリプションの支払いサイクルの種類を返します。
エラー	TargetSubscriptionErrors の一覧	ターゲットサブスクリプションが移行の対象にならない理由。

個々のターゲットサブスクリプションの適格性の詳細リソースの動作について説明します。

プロパティ	Type	説明
IsEligible	boolean	適格性が有効かどうかを返します。
SubscriptionId	string	サブスクリプションの ID を返します。
SubscriptionFriendlyName	string	サブスクリプションのフレンドリ名を返します。
SubscriptionTermDuration	string	サブスクリプションの期間を返します。
SubscriptionBillingCycle	BillingCycleType	サブスクリプションの支払いサイクルの種類を返します。
エラー	TargetSubscriptionErrors の一覧	ターゲットサブスクリプションが移行の対象にならない理由。

個々のサブスクリプション移行リソースの動作について説明します。

プロパティ	タイプ	説明
FromCatalogItemId	string	From カタログ項目 ID。
FromSubscriptionId	string	From サブスクリプション ID。
ToCatalogItemId	string	To カタログ項目 ID。
ToSubscriptionId	string	To サブスクリプション ID。これは、サブスクリプションが変更された場合にのみ設定されます。現在必要なのはレガシアップグレードだけですが、最新の部分移行も必要です。
数量（Quantity）	integer	ターゲットカタログ項目に移行する数量。
TermDuration	string	サブスクリプションの期間。
BillingCycle	string	サブスクリプションの支払いサイクル。
TransitionType	string	遷移の種類。使用可能な値 - `transition_only`、 `transition_with_license_transfer`。
Events	TransitionEvents の一覧	遷移のイベント。
promotionId	string	移行に適用された昇格 ID。

サブスクリプションで発生したさまざまなイベントについて説明します。

プロパティ	タイプ	説明
氏名	string	遷移イベントの名前。使用可能な値 - `Conversion` または `LicenseReassignment`。
状態	string	遷移イベントの状態。使用可能な値 - `Started`、 `Completed` 、または `Failed`。
Timestamp	DateTime	イベントの UTC タイムスタンプ。
エラー	TransitionErrors の一覧	エラーに対応するメタデータ属性。

サブスクリプション譲渡の適格性に関するエラーを表します。切り替えを実行できない理由を示します。

プロパティ	タイプ	説明
コード	TransitionErrorCode	問題に関連付けられているエラーコード。
説明	string	エラーを説明するわかりやすいテキスト。

ターゲットサブスクリプションに移行する資格がない場合のエラーを表します。理由を提供します。

プロパティ	タイプ	説明
コード	TargetSubscriptionErrorCode	問題に関連付けられているエラーコード。
説明	string	エラーを説明するわかりやすいテキスト。