Manage orders - Create a transition for a subscription

サービス:

Partner Center Rest

API バージョン:

v1

サブスクリプションの移行要求を投稿します。

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions

URI パラメーター

名前	/	必須	型	説明
customer_id	path	True	string	顧客 ID。
subscription_id	path	True	string	サブスクリプション ID。
version	path	True	string

要求ヘッダー

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"

名前	型	説明
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
billingCycle	string
events	Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent[]
fromCatalogItemId	string
fromSubscriptionId	string
promotionId	string
quantity	integer
termDuration	string
toCatalogItemId	string
toSubscriptionId	string
transitionType	string

応答

名前	型	説明
200 OK	Microsoft.Partner.Services.Subscriptions.V1.Models.Transition	要求が成功しました。 応答本文には、遷移の結果が含まれています。 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"

定義

名前	説明
Microsoft.Partner.Core.Collections.ResourceAttributes
Microsoft.Partner.Services.Subscriptions.V1.Models.Transition
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent

Microsoft.Partner.Core.Collections.ResourceAttributes

名前	型	説明
etag	string
objectType	string

Microsoft.Partner.Services.Subscriptions.V1.Models.Transition

名前	型	説明
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
billingCycle	string
events	Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent[]
fromCatalogItemId	string
fromSubscriptionId	string
promotionId	string
quantity	integer
termDuration	string
toCatalogItemId	string
toSubscriptionId	string
transitionType	string

Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError

名前	型	説明
code	enum: 0 1 10 11 2 3 4 5 6 7 8 9
description	string

Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent

名前	型	説明
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
errors	Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError[]
name	string
status	string
timestamp	string