パートナーは、顧客の現在のパートナーへの転送を作成します。 現在または移行元のパートナーが譲渡を受け入れ、転送を完了するためにそれを送信します。
TransferEntity
新しいコマース転送の transferEntity について説明します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| ID | 文字列 | transferEntity の正常な作成時に指定される transferEntity 識別子。 |
| 状態 | 文字列 | transferEntity のステータス。 指定できる値は、"Active" (削除/送信可能) と "Completed" (既に完了) です。 transferEntity が正常に作成された場合に適用されます。 |
| 転送タイプ | 文字列 | 転送の種類を表す数値。 3 件が ModernAzure に解決され、5 件が NewCommerce に解決されます。 パートナー間で新しいコマース転送を実行するパートナーは、どちらの方法も使用できますが、方法5を標準として選択するべきです。 |
| 顧客メールID | 文字列 | 通知に使用される顧客の電子メールを識別します。 |
| createdTime | 日付と時間 | transferEntity が作成された日付 (日時形式)。 transferEntity が正常に作成された場合に適用されます。 |
| 最終更新時刻 | 日付と時間 | transferEntity が最後に更新された日付 (日時形式)。 transferEntity が正常に作成された場合に適用されます。 |
| 完了時間 | 日付と時間 | transferEntity が完了した日付 (日時形式)。 transferEntity の正常な完了時に適用されます。 |
| 顧客名 | 文字列 | 任意 サブスクリプションが譲渡される顧客の名前。 |
| customerTenantId | 文字列 | 顧客を識別する GUID 形式の顧客 ID。 transferEntity が正常に作成された場合に適用されます。 |
| partnertenantid | 文字列 | パートナーを識別する GUID 形式のパートナー ID。 |
| sourcePartnerName | 文字列 | 省略可能。 譲渡を開始するパートナーの組織の名前。 |
| targetPartnerName | 文字列 | 省略可能。 譲渡の対象となるパートナーの組織の名前。 |
| partnerOnRecord | 文字列 | 省略可能。 間接プロバイダーが譲渡された明細品目に割り当てている指名パートナー。 |
| ターゲット製品タイプ | 文字列 | 省略可能。 転送のために送信できるサブスクリプションの種類を指定する文字列のコレクション。 Null はすべての種類と見なされます。 値には、AzureSubscription、AzureReservation、AzureSavingsPlan、OnlineServicesNCE、Software、SaaS などがあります。 |
| ターゲットパートナーテナントID (targetPartnerTenantId) | 文字列 | 転送の対象となるパートナーを識別する GUID 形式のパートナー ID。 |
| 対象パートナーメールID | 文字列 | 転送の対象となるパートナーを識別する GUID 形式のパートナー ID。 この ID は targetPartnerTenantId と同じです |
| transferDirection | 文字列 | 転送の方向を表す数値。 1 は、転送を受け入れるパートナーの着信転送を表します。 2 は、転送を作成するパートナーの送信転送を表します。 |
| 適格性チェックを無視 | 文字列 | この値は false にする必要があります。 |
| 最終更新者 | 文字列 | 転送を変更する最後のユーザーを識別する GUID 形式のユーザー ID |
| lineItems | オブジェクトの配列 | TransferLineItem リソースの配列。 |
TransferLineItem
新しいコマースの transferEntity に含まれる 1 つの項目を表します。 ソースパートナーには、転送しようとするアイテムの取引明細が表示されます。 ターゲット パートナーは、新しく作成された明細項目を完了後に見ることができます。 ターゲット パートナーは、品目 ID を使用して、譲渡の結果として新しく作成されたサブスクリプションを理解するのに役立ちます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| ID | 文字列 | 転送明細項目の一意識別子。 transferEntity が正常に作成された場合に適用されます。 |
| フレンドリーネーム | 文字列 | サブスクリプションの名前。 |
| サブスクリプションID | 文字列 | サブスクリプション識別子です。 |
| 量 | 整数 (int) | ライセンスまたはインスタンスの数。 |
| billingCycle | オブジェクト | 現在の期間に設定支払いサイクルの種類。 |
| 製品タイプ | 文字列 | 転送された製品の種類を表す文字列。 |
| 状態 | 文字列 | "transferEntity"内の明細項目のステータス。 |
| sourceSubscriptionTermStartDate | 日時 | この値は、ターゲット パートナーに転送されたソース サブスクリプションの作成日時 (UTC) を表します。 |
| 価格 | 価格の一覧 | 転送済みの明細項目の価格値のコレクション。 新しいコマース ライセンスベースの転送品目にのみ適用されます。 |
料金
Price は、品目のコストを説明する値を表します。 価格には 4 つの値が含まれています。
| プロパティ | タイプ | 説明 |
|---|---|---|
| listPrice | 浮動小数点整数 | 価格修飾子を適用しない 、次の請求期間 の単一単価。 この金額は課税前です。 税込の国/地域では、この価格には税金が含まれます。それ以外の場合は無効です。 請求期間あたりの単価。 新しいコマース ライセンスベースの転送品目にのみ適用されます。 |
| 割引価格 | 浮動小数点整数 | 適用できるすべての価格修飾子を適用した後の ListPrice。 この金額は課税前です。 税込の国/地域では、この価格には税金が含まれます。それ以外の場合は無効です。 新しいコマース ライセンスベースの転送品目にのみ適用されます。 |
| 価格 | 浮動小数点整数 | 残りの請求サイクルの日割り単位の請求金額。 すべての割引が適用され、すべての配分が実行された後の、目標請求通貨の単一数量価格。 この金額は課税前です。 税込の国/地域では、この価格には税金が含まれます。それ以外の場合は無効です。 これは UX の UnitPrice です。 次のユニットの請求金額。 新しいコマース ライセンスベースの転送品目にのみ適用されます。 |
| 合計価格 | 浮動小数点整数 | 数量、割引、および按分が適用された品目の価格 (ターゲット請求通貨)。 契約期間の残りの期間。 この金額は課税前です。 税込の国/地域では、この価格には税金が含まれます。それ以外の場合は無効です。 これは UX の TotalPrice です。 新しいコマース ライセンスベースの転送品目にのみ適用されます。 |
| 通貨コード | 文字列 | 価格通貨の省略形。 新しいコマース ライセンスベースの転送品目にのみ適用されます。 |
従来のライセンスに基づく転送のためのTransferEntity
transferEntity について説明します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| ID | 文字列 | transferEntity の正常な作成時に指定される transferEntity 識別子。 |
| 作成時間 | 日付と時間 | transferEntity が作成された日付 (日時形式)。 transferEntity が正常に作成された場合に適用されます。 |
| 最終更新時刻 | 日付と時間 | transferEntity が最後に更新された日付 (日時形式)。 transferEntity が正常に作成された場合に適用されます。 |
| lastModifiedUser | 文字列 | transferEntity を最後に更新したユーザー。 transferEntity が正常に作成された場合に適用されます。 |
| 顧客名 | 文字列 | 省略可能。 サブスクリプションが譲渡される顧客の名前。 |
| カスタマーテナントID | 文字列 | 顧客を識別する GUID 形式の顧客 ID。 transferEntity が正常に作成された場合に適用されます。 |
| partnertenantid（パートナーテナントID） | 文字列 | パートナーを識別する GUID 形式のパートナー ID。 |
| sourcePartnerName | 文字列 | 省略可能。 譲渡を開始するパートナーの組織の名前。 |
| sourcePartnerTenantId | 文字列 | 転送を開始するパートナーを識別する GUID 形式のパートナー ID。 |
| targetPartnerName | 文字列 | 省略可能。 譲渡の対象となるパートナーの組織の名前。 |
| targetPartnerTenantId（ターゲットパートナーテナントID） | 文字列 | 転送の対象となるパートナーを識別する GUID 形式のパートナー ID。 |
| lineItems | オブジェクトの配列 | TransferLineItem リソースの配列。 |
| 状態 | 文字列 | transferEntity の状態。 指定できる値は、"Active" (削除/送信可能) と "Completed" (既に完了) です。 transferEntity が正常に作成された場合に適用されます。 |
従来のライセンスベースの転送用の TransferLineItem
transferEntity に含まれる 1 つの項目を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| ID | 文字列 | 転送明細の一意識別番号。 transferEntity が正常に作成された場合に適用されます。 |
| サブスクリプションID | 文字列 | サブスクリプション識別子です。 |
| 量 | 整数 (int) | ライセンスまたはインスタンスの数。 |
| billingCycle | オブジェクト | 現在の期間に設定支払いサイクルの種類。 |
| フレンドリーネーム | 文字列 | 省略可能。 あいまいさを解消するためにパートナーによって定義された項目のフレンドリ名。 |
| 記録上のパートナーID | 文字列 | 譲渡が受け入れられた際の購入記録にある PartnerId。 |
| offerId | 文字列 | オファーの識別子。 |
| アドオンアイテム | TransferLineItem オブジェクトの一覧 | 転送される基本サブスクリプションに含まれるアドオンの項目コレクションである transferEntity が一緒に転送されます。 transferEntity が正常に作成された場合に適用されます。 |
| 転送エラー | 文字列 | エラーが発生した場合に、transferEntity が受け入れられた後に適用されます。 |
| 状態 | 文字列 | "transferEntity"内の明細項目のステータス。 |
トランスファーサブミットリザルト (TransferSubmitResult)
従来のライセンスベースの転送に対する譲渡承諾の結果を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| 注文 | Order オブジェクトの一覧。 | 注文の集計。 |
| 転送エラー | TransferError オブジェクトの一覧。 | 転送エラーのコレクション。 |
TransferError
従来のライセンス ベースの転送が受け入れられたときに発生するエラーを表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| transferGroupId | 文字列 | エラーが発生した注文の注文グループ ID。 |
| コード | 整数 (int) | エラー コード。 |
| 説明 | 文字列 | エラーの説明。 |
| lineItems | TransferLineItem オブジェクトの一覧 | 転送エラーの一部である「transferEntity」項目のコレクション。 |
TransferErrorCode
従来のライセンスベースの転送における注文エラーの種類を示す値を持つ [Enum/dotnet/api/system.enum)。
| 価値 | 位置 | 説明 |
|---|---|---|
| パートナートークンが見つかりません | 800001 | 要求コンテキストにパートナー トークンがありません。 |
| 無効な入力 | 800002 | 要求入力が無効です。 |
| サービスエクセプション (ServiceException) | 800003 | 予期しないサービス エラー。 |
| 無効なオファーID | 800004 | オファー ID が無効です。 |
| 注文作成エラー | 800005 | 注文の作成ができませんでした。 |
| MpnIdNotFound (MPN ID が見つかりません) | 800015 | PartnerID が見つかりません。 |
| NotValidIndirectResellerMpnId (間接再販業者のMPN IDが無効です) | 800016 | PartnerID は有効な間接リセラーではありません。 |
| TransferIdNotFound (転送IDが見つかりません) | 900100 | 転送要求が見つかりません。 |
| 進行中の場合は転送できません | 900101 | 転送要求は既に進行中です。 |
| ステータスが完了している場合は転送できません | 900102 | 転送要求は既に完了しています。 |
| オーダー作成エラー (TransferCreateOrderError) | 900103 | 転送注文が成功しません。 |
| 別のリクエストによって処理された転送 | 900104 | 転送は別の要求によって処理されています。 |