Condividi tramite


Manage orders - Create a transition for a subscription

Pubblicare la richiesta di transizione per una sottoscrizione.

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions

Parametri dell'URI

Nome In Necessario Tipo Descrizione
customer_id
path True

string

ID cliente.

subscription_id
path True

string

ID sottoscrizione.

version
path True

string

Intestazione della richiesta

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Nome Necessario Tipo Descrizione
Authorization True

string

Token di connessione dell'autorizzazione

ms-correlationid

string

Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo elemento per ogni richiesta

ms-cv

string

Usato per tenere traccia delle richieste internamente. Se non viene specificata una ms-cv, il server genererà un nuovo per ogni richiesta

ms-requestid

string

Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà un nuovo per ogni richiesta

Corpo della richiesta

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Nome Tipo Descrizione
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

Risposte

Nome Tipo Descrizione
200 OK

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

La richiesta ha avuto esito positivo. Il corpo della risposta contiene il risultato della transizione.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

La risorsa non viene trovata o non è disponibile con i parametri di input specificati.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definizioni

Nome Descrizione
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

Nome Tipo Descrizione
etag

string

objectType

string

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

Nome Tipo Descrizione
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

Nome Tipo Descrizione
code enum:
  • 0
  • 1
  • 10
  • 11
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
description

string

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

Nome Tipo Descrizione
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

errors

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

name

string

status

string

timestamp

string