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 매개 변수

Name	In(다음 안에)	필수	형식	Description
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"

Name	필수	형식	Description
Authorization	True	string	권한 부여 전달자 토큰
ms-correlationid		string	내부적으로 요청을 추적하는 데 사용됩니다. ms-correlationid가 제공되지 않으면 서버는 각 요청에 대해 새 상관 관계를 생성합니다.
ms-cv		string	내부적으로 요청을 추적하는 데 사용됩니다. ms-cv 제공되지 않으면 서버는 각 요청에 대해 새 ms-cv 생성합니다.
ms-requestid		string	요청의 idempotency에 사용됩니다. ms-requestid가 제공되지 않으면 서버는 각 요청에 대해 새 요청을 생성합니다.

요청 본문

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

Name	형식	Description
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

응답

Name	형식	Description
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 서비스 또는 해당 종속성 중 하나가 요청을 충족하지 못했습니다. 호출자는 이를 다시 시도할 수 있습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml"

정의

Name	Description
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

Name	형식	Description
etag	string
objectType	string

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

Name	형식	Description
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

Name	형식	Description
code	enum: 0 1 10 11 2 3 4 5 6 7 8 9
description	string

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

Name	형식	Description
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
errors	Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError[]
name	string
status	string
timestamp	string