Manage orders - Create a transition for a subscription
Publiez la demande de transition d’un abonnement.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
customer_id
|
path | True |
string |
ID du client. |
subscription_id
|
path | True |
string |
ID d’abonnement. |
version
|
path | True |
string |
En-tête de la demande
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Nom | Obligatoire | Type | Description |
---|---|---|---|
Authorization | True |
string |
Jeton du porteur d’autorisation |
ms-correlationid |
string |
Utilisé pour le suivi des demandes en interne. Si un ms-correlationid n’est pas fourni, le serveur en génère un nouveau pour chaque requête |
|
ms-cv |
string |
Utilisé pour le suivi des demandes en interne. Si un ms-cv n’est pas fourni, le serveur en génère un nouveau pour chaque requête |
|
ms-requestid |
string |
Utilisé pour l’idempotency des requêtes. Si un ms-requestid n’est pas fourni, le serveur en génère un nouveau pour chaque requête |
Corps de la demande
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Nom | Type | Description |
---|---|---|
attributes | ||
billingCycle |
string |
|
events |
Microsoft. |
|
fromCatalogItemId |
string |
|
fromSubscriptionId |
string |
|
promotionId |
string |
|
quantity |
integer |
|
termDuration |
string |
|
toCatalogItemId |
string |
|
toSubscriptionId |
string |
|
transitionType |
string |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Microsoft. |
La demande a réussi. Le corps de la réponse contient le résultat de la transition. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
400 Bad Request |
Une entrée est manquante ou non valide. Le corps de la réponse fournit les détails de l’erreur. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
401 Unauthorized |
La demande n’a pas été authentifiée. Le client doit d’abord s’authentifier auprès du service d’API partenaire. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
403 Forbidden |
La demande a été authentifiée, mais a été refusée, car l’appelant n’a pas les droits de l’appeler. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
404 Not Found |
La ressource est introuvable ou non disponible avec les paramètres d’entrée donnés. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
500 Internal Server Error |
Le service d’API partenaire ou l’une de ses dépendances n’a pas pu répondre à la demande. Les appelants peuvent réessayer. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Définitions
Microsoft.Partner.Core.Collections.ResourceAttributes
Nom | Type | Description |
---|---|---|
etag |
string |
|
objectType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Transition
Nom | Type | 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
Nom | Type | Description |
---|---|---|
code |
enum:
|
|
description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent
Nom | Type | Description |
---|---|---|
attributes | ||
errors |
Microsoft. |
|
name |
string |
|
status |
string |
|
timestamp |
string |