Manage orders - Create a transition for a subscription
Poste a solicitação de transição para uma assinatura.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
A ID do cliente. |
|
subscription_id
|
path | True |
string |
A ID da assinatura. |
|
version
|
path | True |
string |
Cabeçalho da solicitação
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| Authorization | True |
string |
Token de portador de autorização |
| ms-correlationid |
string |
Usado para acompanhar solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação |
|
| ms-cv |
string |
Usado para acompanhar solicitações internamente. Se um ms-cv não for fornecido, o servidor gerará um novo para cada solicitação |
|
| ms-requestid |
string |
Usado para idempotency de solicitações. Se uma ms-requestid não for fornecida, o servidor gerará uma nova para cada solicitação |
Corpo da solicitação
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nome | Tipo | Description |
|---|---|---|
| attributes | ||
| billingCycle |
string |
|
| events |
Microsoft. |
|
| fromCatalogItemId |
string |
|
| fromSubscriptionId |
string |
|
| promotionId |
string |
|
| quantity |
integer (int32) |
|
| termDuration |
string |
|
| toCatalogItemId |
string |
|
| toSubscriptionId |
string |
|
| transitionType |
string |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Microsoft. |
A solicitação foi bem-sucedida. O corpo da resposta contém o resultado da transição. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
| 400 Bad Request |
Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
A solicitação não foi autenticada. Primeiro, o cliente precisa se autenticar com o serviço de API do parceiro. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
A solicitação foi autenticada, mas foi recusada, pois o chamador não tem os direitos de invocá-la. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
O recurso não foi encontrado ou não está disponível com os parâmetros de entrada especificados. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem repetir isso. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definições
Microsoft.Partner.Core.Collections.ResourceAttributes
| Nome | Tipo | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Transition
| Nome | Tipo | Description |
|---|---|---|
| attributes | ||
| billingCycle |
string |
|
| events |
Microsoft. |
|
| fromCatalogItemId |
string |
|
| fromSubscriptionId |
string |
|
| promotionId |
string |
|
| quantity |
integer (int32) |
|
| termDuration |
string |
|
| toCatalogItemId |
string |
|
| toSubscriptionId |
string |
|
| transitionType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError
| Nome | Tipo | Description |
|---|---|---|
| code |
enum:
|
|
| description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent
| Nome | Tipo | Description |
|---|---|---|
| attributes | ||
| errors |
Microsoft. |
|
| name |
string |
|
| status |
string |
|
| timestamp |
string (date-time) |