Manage orders - Create a transfer

サービス:
Partner Center Rest
API バージョン:
v1

新しい転送エンティティを作成します。

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/transfers

URI パラメーター

名前 / 必須 型 説明
customer_id
 path True

string

顧客識別子。
version
 path True

string

APIのバージョン番号です。

要求ヘッダー

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

名前 必須 型 説明
Authorization True

string

承認ベアラー トークン
ms-correlationid

string

要求を内部的に追跡するために使用されます。 ms-correlationid が指定されていない場合、サーバーは要求ごとに新しいものを生成します
ms-cv

string

要求を内部的に追跡するために使用されます。 ms-cv が指定されていない場合、サーバーは要求ごとに新しい ms-cv を生成します
ms-requestid

string

要求のべき等性に使用されます。 ms-requestid が指定されていない場合、サーバーは要求ごとに新しいものを生成します

要求本文

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

名前 型 説明
alternateId

string

移転事業体の代替識別子。 価値は通常GUIDです。
attributes

ResourceAttributes

譲渡事業体に関連する追加の属性。
completedTime

string (date-time)

譲渡事業体の完了時間。 ISO 8601の日付時間形式を使用しています。
createdTime

string (date-time)

移転エンティティが作成された日時(ISO 8601形式)。 ISO 8601の日付時間形式を使用しています。
customerEmailId

string

顧客のメールアドレスの一意識別子。 価値は通常GUIDです。
customerName

string

移転事業体の顧客名です。
customerTenantId

string

顧客テナントの一意識別子。 価値は通常GUIDです。
expirationTime

string (date-time)

譲渡事業体の有効期限です。 ISO 8601の日付時間形式を使用しています。
id

string

移転事業体の一意識別子。 価値は通常GUIDです。
ignoreEligibilityCheck

boolean

この譲渡機関が適格性チェックを無視しているかどうか。
lastModifiedTime

string (date-time)

移管事業体の最後の修正時間。 ISO 8601の日付時間形式を使用しています。
lastModifiedUser

string

最後に転送エンティティを修正したユーザーです。
lineItems

TransferLineItem[]

この移転エンティティに関連する項目のコレクション。
links

ResourceLinks

関連リソースへのリンク。
participants

StringStringKeyValuePair[]

この項目に関連する参加者。
partnerOnRecord

string

譲渡事業体のパートナーが記録されています。
partnertenantid

string

移転事業体の一意識別子。 価値は通常GUIDです。
sourcePartnerEmailId

string

送信先パートナーのメールアドレスの一意識別子。 価値は通常GUIDです。
sourcePartnerName

string

譲渡事業体の元のパートナー名。
sourcePartnerTenantId

string

ソースパートナーテナントの一意識別子。 価値は通常GUIDです。
status

string

譲渡事業体の現在の状況。
targetPartnerEmailId

string

ターゲットパートナーのメールアドレスの一意識別子。 価値は通常GUIDです。
targetPartnerName

string

譲渡事業体のターゲットパートナー名。
targetPartnerTenantId

string

ターゲットパートナーテナントの一意識別子。 価値は通常GUIDです。
targetProductTypes

string[]

この移転エンティティに関連するターゲット製品タイプの集合。
transferDirection enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)

譲渡主体の譲渡指示です。 可能な値は0、1、2です。
transferType enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
  • 3 (int32)
  • 4 (int32)
  • 5 (int32)

整数として送られる転送の種類。 可能な値は以下の通りです:0(不明)、1(EaToCsp)、2(DirectToIndirect)、3(ModernAzure)、4(PartnerToPartner)、5(NewCommerce)。

応答

名前 型 説明
201 Created

TransferEntity

要求が成功しました。 応答本文には、転送情報が含まれています。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

入力が見つからないか無効でした。 応答本文には、エラーの詳細が表示されます。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

要求が認証されませんでした。 クライアントは、最初にパートナー API サービスで認証する必要があります。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

要求は認証されましたが、呼び出し元に呼び出す権限がないため拒否されました。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

リソースが見つからないか、指定された入力パラメーターで使用できません。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

パートナー API サービスまたはその依存関係の 1 つが要求を満たできませんでした。 呼び出し元はこれを再試行できます。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

定義

名前 説明
LastKnownBillingDetails

最後に知られている請求情報リソースを表しています。
LastKnownBillingPeriod

最後に知られている請求期間リソースを表します。
Link

リンクリソースを表します。
ResourceAttributes

リソース属性のリソースを表します。
ResourceLinks

リソースリンクリソースを表します。
StringStringKeyValuePair

鍵対リソースを表します。
TransferEntity

移転事業体リソースを表します。
TransferItemType

転送されるアイテムの種類を表し、整数として送信されます。 可能な値は以下の通りです:0(AzureSubscription)、1(AzureReservation)、2(ModernAzureSubscription)、3(LegacyAzureSubscription)、4(AzureSavingsPlan)、5(OnlineServicesNCE)、6(Software)、7(SaaS)。
TransferLineItem

転送項目リソースを表します。
TransferLineItemError

転送行項目のエラーリソースを表します。
TransferLineItemPrice

移転項目価格リソースを表します。

LastKnownBillingDetails

Object

最後に知られている請求情報リソースを表しています。

名前 型 説明
billingAmount

number (double)

最後に知られている請求額の請求額。
billingCycle enum:
  • annual
  • monthly
  • none
  • one_time
  • unknown

請求頻度。 可能な値は「不明」「月ごと」「年次」「なし」「1回」one_time」などがあります。
billingPeriod

LastKnownBillingPeriod

最後に知られている請求情報に関連する追加の請求期間。
billingType enum:
  • license
  • none
  • usage

最後に知られている請求情報の請求タイプ。 可能な値には「なし」「使用」「ライセンス」などがあります。
currency

string

3文字のISO通貨コード。

LastKnownBillingPeriod

Object

最後に知られている請求期間リソースを表します。

名前 型 説明
endDate

string (date-time)

この記録の終了日(ISO 8601形式)。 ISO 8601の日付時間形式を使用しています。
startDate

string (date-time)

この記録の開始日はISO 8601形式です。 ISO 8601の日付時間形式を使用しています。
Object

リンクリソースを表します。

名前 型 説明
body

string

リンクの本体だ。
headers

StringStringKeyValuePair[]

このリンクに関連するヘッダーの集合。
method

string

リンクの方法について。
uri

string

関連リソースのURIです。

ResourceAttributes

Object

リソース属性のリソースを表します。

名前 型 説明
etag

string

並行制御に使われるエンティティタグ。
objectType

string

リソース属性のオブジェクトタイプです。
Object

リソースリンクリソースを表します。

名前 型 説明
next

Link

リソースリンクに関連する追加の次。
previous

Link

リソースリンクに関連する追加の過去。
self

Link

リソースリンクには関連した追加情報もあります。

StringStringKeyValuePair

Object

鍵対リソースを表します。

名前 型 説明
key

string

キー値ペアの鍵です。
value

string

鍵値ペアの価値です。

TransferEntity

Object

移転事業体リソースを表します。

名前 型 説明
alternateId

string

移転事業体の代替識別子。 価値は通常GUIDです。
attributes

ResourceAttributes

譲渡事業体に関連する追加の属性。
completedTime

string (date-time)

譲渡事業体の完了時間。 ISO 8601の日付時間形式を使用しています。
createdTime

string (date-time)

移転エンティティが作成された日時(ISO 8601形式)。 ISO 8601の日付時間形式を使用しています。
customerEmailId

string

顧客のメールアドレスの一意識別子。 価値は通常GUIDです。
customerName

string

移転事業体の顧客名です。
customerTenantId

string

顧客テナントの一意識別子。 価値は通常GUIDです。
expirationTime

string (date-time)

譲渡事業体の有効期限です。 ISO 8601の日付時間形式を使用しています。
id

string

移転事業体の一意識別子。 価値は通常GUIDです。
ignoreEligibilityCheck

boolean

この譲渡機関が適格性チェックを無視しているかどうか。
lastModifiedTime

string (date-time)

移管事業体の最後の修正時間。 ISO 8601の日付時間形式を使用しています。
lastModifiedUser

string

最後に転送エンティティを修正したユーザーです。
lineItems

TransferLineItem[]

この移転エンティティに関連する項目のコレクション。
links

ResourceLinks

関連リソースへのリンク。
participants

StringStringKeyValuePair[]

この項目に関連する参加者。
partnerOnRecord

string

譲渡事業体のパートナーが記録されています。
partnertenantid

string

移転事業体の一意識別子。 価値は通常GUIDです。
sourcePartnerEmailId

string

送信先パートナーのメールアドレスの一意識別子。 価値は通常GUIDです。
sourcePartnerName

string

譲渡事業体の元のパートナー名。
sourcePartnerTenantId

string

ソースパートナーテナントの一意識別子。 価値は通常GUIDです。
status

string

譲渡事業体の現在の状況。
targetPartnerEmailId

string

ターゲットパートナーのメールアドレスの一意識別子。 価値は通常GUIDです。
targetPartnerName

string

譲渡事業体のターゲットパートナー名。
targetPartnerTenantId

string

ターゲットパートナーテナントの一意識別子。 価値は通常GUIDです。
targetProductTypes

string[]

この移転エンティティに関連するターゲット製品タイプの集合。
transferDirection enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)

譲渡主体の譲渡指示です。 可能な値は0、1、2です。
transferType enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
  • 3 (int32)
  • 4 (int32)
  • 5 (int32)

整数として送られる転送の種類。 可能な値は以下の通りです:0(不明)、1(EaToCsp)、2(DirectToIndirect)、3(ModernAzure)、4(PartnerToPartner)、5(NewCommerce)。

TransferItemType

列挙

転送されるアイテムの種類を表し、整数として送信されます。 可能な値は以下の通りです:0(AzureSubscription)、1(AzureReservation)、2(ModernAzureSubscription)、3(LegacyAzureSubscription)、4(AzureSavingsPlan)、5(OnlineServicesNCE)、6(Software)、7(SaaS)。

値 説明
0
1
2
3
4
5
6
7

TransferLineItem

Object

転送項目リソースを表します。

名前 型 説明
addonItems

TransferLineItem[]

この転送ライン項目に関連するアドオンアイテムのコレクションです。
billingCycle enum:
  • annual
  • monthly
  • none
  • one_time
  • unknown

請求頻度。 可能な値は「不明」「月ごと」「年次」「なし」「1回」one_time」などがあります。
billingDetails

LastKnownBillingDetails

転送項目に関連する追加の請求情報。
currencyCode

string

3文字のISO通貨コード。
errors

TransferLineItemError[]

この転送項目に関連するエラーの集合。
friendlyName

string

このアイテムの親しみやすい表示名です。
id

integer (int32)

転送ライン項目の一意識別子。
offerId

string

オファーの一意識別子。 価値は通常GUIDです。
orderId

string

注文の一意識別子。 価値は通常GUIDです。
partnerIdOnRecord

string

移管項目のパートナーIDが記録されています。
price

TransferLineItemPrice

このアイテムに関連する価格。
productType

TransferItemType (int32)

転送項目に関連する追加の製品タイプ。
quantity

integer (int32)

単位の数。
sourceSubscriptionTermEndDate

string (date-time)

元のサブスクリプション期間が終了する日時(UTC単位)。
sourceSubscriptionTermStartDate

string (date-time)

ソースのサブスクリプション期間の開始日(ISO 8601形式)。 ISO 8601の日付時間形式を使用しています。
status

string

転送ライン項目の現在の状況。
subscriptionId

string

サブスクリプションの一意識別子(GUID)です。 価値は通常GUIDです。
transferError

string

転送項目の転送エラー。
transferGroupId

string

転送グループの一意識別子。 価値は通常GUIDです。

TransferLineItemError

Object

転送行項目のエラーリソースを表します。

名前 型 説明
code

string

転送項目エラーのコードです。
description

string

このアイテムの説明。

TransferLineItemPrice

Object

移転項目価格リソースを表します。

名前 型 説明
currencyCode

string

3文字のISO通貨コード。
discountedPrice

number (double)

譲渡項目の割引価格。
erpPrice

number (double)

推定小売価格(ERP)。 価格修正を適用する前にカタログに記載された単一の推定小売価格の単一数量で、項目の通貨で示されます。 これは、在庫期間が指定された時点での完全な期間小売価格です。 税金を含む国や地域では税金を含む金額は税引前です。 この物件は現在展開中で、すべてのパートナーに返却されるわけではありません。
extendedPrice

number (double)

譲渡項目価格の拡張価格。
listPrice

number (double)

割引が適用される前のリスト価格です。
price

number (double)

このアイテムに関連する価格。
proratedPrice

number (double)

譲渡項目価格の按分価格です。