Partager via


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

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

Réponses

Nom Type Description
200 OK

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

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

Nom 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

Nom Type Description
etag

string

objectType

string

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

Nom Type 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

Nom Type Description
code enum:
  • 0
  • 1
  • 10
  • 11
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
description

string

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

Nom Type Description
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

errors

Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError[]

name

string

status

string

timestamp

string