Manage orders - Create a transition for a subscription
Publique la solicitud de transición de una suscripción.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
customer_id
|
path | True |
string |
Identificador del cliente. |
subscription_id
|
path | True |
string |
Identificador de suscripción. |
version
|
path | True |
string |
Encabezado de la solicitud
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Nombre | Requerido | Tipo | Description |
---|---|---|---|
Authorization | True |
string |
Token de portador de autorización |
ms-correlationid |
string |
Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-correlationid, el servidor generará uno nuevo para cada solicitud. |
|
ms-cv |
string |
Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-cv, el servidor generará uno nuevo para cada solicitud. |
|
ms-requestid |
string |
Se usa para la idempoencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud. |
Cuerpo de la solicitud
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Nombre | Tipo | Description |
---|---|---|
attributes | ||
billingCycle |
string |
|
events |
Microsoft. |
|
fromCatalogItemId |
string |
|
fromSubscriptionId |
string |
|
promotionId |
string |
|
quantity |
integer |
|
termDuration |
string |
|
toCatalogItemId |
string |
|
toSubscriptionId |
string |
|
transitionType |
string |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Microsoft. |
La solicitud se realizó correctamente. El cuerpo de la respuesta contiene el resultado de la transición. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
400 Bad Request |
Faltaba o faltaba una entrada no válida. El cuerpo de la respuesta proporcionará los detalles del error. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
401 Unauthorized |
La solicitud no se autenticó. El cliente debe autenticarse primero con el servicio de API del asociado. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
403 Forbidden |
La solicitud se autenticó pero se rechazó, ya que el autor de la llamada no tiene los derechos para invocarla. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
404 Not Found |
El recurso no se encuentra o no está disponible con los parámetros de entrada especificados. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
500 Internal Server Error |
El servicio de API del asociado o una de sus dependencias no pudieron cumplir la solicitud. Los autores de llamadas pueden volver a intentarlo. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definiciones
Microsoft.Partner.Core.Collections.ResourceAttributes
Nombre | Tipo | Description |
---|---|---|
etag |
string |
|
objectType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Transition
Nombre | Tipo | Description |
---|---|---|
attributes | ||
billingCycle |
string |
|
events |
Microsoft. |
|
fromCatalogItemId |
string |
|
fromSubscriptionId |
string |
|
promotionId |
string |
|
quantity |
integer |
|
termDuration |
string |
|
toCatalogItemId |
string |
|
toSubscriptionId |
string |
|
transitionType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError
Nombre | Tipo | Description |
---|---|---|
code |
enum:
|
|
description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent
Nombre | Tipo | Description |
---|---|---|
attributes | ||
errors |
Microsoft. |
|
name |
string |
|
status |
string |
|
timestamp |
string |