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	Идентификатор клиента.
subscription_id	path	True	string	Идентификатор подписки.
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-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 партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить это. 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