Manage orders - Create a transfer
建立新的傳輸實體。
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/transfers
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
客戶標識碼。 |
|
version
|
path | True |
string |
要求標頭
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| Authorization | True |
string |
授權持有人令牌 |
| ms-correlationid |
string |
用於在內部追蹤要求。 如果未提供 ms-correlationid,伺服器會為每個要求產生新的要求 |
|
| ms-cv |
string |
用於在內部追蹤要求。 如果未提供 ms-cv,伺服器將會為每個要求產生新的要求 |
|
| ms-requestid |
string |
用於要求等冪性。 如果未提供 ms-requestid,伺服器將會為每個要求產生新的要求 |
要求本文
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| 名稱 | 類型 | Description |
|---|---|---|
| alternateId |
string |
|
| attributes | ||
| completedTime |
string (date-time) |
|
| createdTime |
string (date-time) |
|
| customerEmailId |
string |
|
| customerName |
string |
|
| customerTenantId |
string |
|
| expirationTime |
string (date-time) |
|
| id |
string |
|
| ignoreEligibilityCheck |
boolean |
|
| lastModifiedTime |
string (date-time) |
|
| lastModifiedUser |
string |
|
| lineItems |
Microsoft. |
|
| links | ||
| participants |
System. |
|
| partnerOnRecord |
string |
|
| partnertenantid |
string |
|
| sourcePartnerEmailId |
string |
|
| sourcePartnerName |
string |
|
| sourcePartnerTenantId |
string |
|
| status |
string |
|
| targetPartnerEmailId |
string |
|
| targetPartnerName |
string |
|
| targetPartnerTenantId |
string |
|
| targetProductTypes |
string[] |
|
| transferDirection |
enum:
|
|
| transferType |
enum:
|
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 201 Created |
Microsoft. |
要求成功。 回應本文包含傳輸資訊。 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 服務或其其中一個相依性無法滿足要求。 來電者可能會重試此狀況。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
定義
Microsoft.Partner.Core.Collections.Link
| 名稱 | 類型 | Description |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
Microsoft.Partner.Core.Collections.ResourceAttributes
| 名稱 | 類型 | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
Microsoft.Partner.Core.Collections.ResourceLinks
| 名稱 | 類型 | Description |
|---|---|---|
| next | ||
| previous | ||
| self |
Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingDetails
| 名稱 | 類型 | Description |
|---|---|---|
| billingAmount |
number (double) |
|
| billingCycle |
enum:
|
|
| billingPeriod |
Microsoft. |
|
| billingType |
enum:
|
|
| currency |
string |
Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingPeriod
| 名稱 | 類型 | Description |
|---|---|---|
| endDate |
string (date-time) |
|
| startDate |
string (date-time) |
Microsoft.Partner.Services.Transfers.V2.Models.TransferEntity
| 名稱 | 類型 | Description |
|---|---|---|
| alternateId |
string |
|
| attributes | ||
| completedTime |
string (date-time) |
|
| createdTime |
string (date-time) |
|
| customerEmailId |
string |
|
| customerName |
string |
|
| customerTenantId |
string |
|
| expirationTime |
string (date-time) |
|
| id |
string |
|
| ignoreEligibilityCheck |
boolean |
|
| lastModifiedTime |
string (date-time) |
|
| lastModifiedUser |
string |
|
| lineItems |
Microsoft. |
|
| links | ||
| participants |
System. |
|
| partnerOnRecord |
string |
|
| partnertenantid |
string |
|
| sourcePartnerEmailId |
string |
|
| sourcePartnerName |
string |
|
| sourcePartnerTenantId |
string |
|
| status |
string |
|
| targetPartnerEmailId |
string |
|
| targetPartnerName |
string |
|
| targetPartnerTenantId |
string |
|
| targetProductTypes |
string[] |
|
| transferDirection |
enum:
|
|
| transferType |
enum:
|
Microsoft.Partner.Services.Transfers.V2.Models.TransferItemType
| 值 | Description |
|---|---|
| AzureSubscription | |
| AzureReservation | |
| LegacyAzureSubscription | |
| AzureSavingsPlan | |
| OnlineServicesNCE |
Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItem
| 名稱 | 類型 | Description |
|---|---|---|
| addonItems |
Microsoft. |
|
| billingCycle |
enum:
|
|
| billingDetails |
Microsoft. |
|
| currencyCode |
string |
|
| errors |
Microsoft. |
|
| friendlyName |
string |
|
| id |
integer (int32) |
|
| offerId |
string |
|
| orderId |
string |
|
| partnerIdOnRecord |
string |
|
| price |
Microsoft. |
|
| productType |
Microsoft. |
|
| quantity |
integer (int32) |
|
| status |
string |
|
| subscriptionId |
string |
|
| transferError |
string |
|
| transferGroupId |
string |
Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemError
| 名稱 | 類型 | Description |
|---|---|---|
| code |
string |
|
| description |
string |
Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemPrice
| 名稱 | 類型 | Description |
|---|---|---|
| currencyCode |
string |
|
| discountedPrice |
number (double) |
|
| extendedPrice |
number (double) |
|
| listPrice |
number (double) |
|
| price |
number (double) |
|
| proratedPrice |
number (double) |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| 名稱 | 類型 | Description |
|---|---|---|
| key |
string |
|
| value |
string |