Manage orders - Convert a trial subscription to paid
Converte una sottoscrizione di valutazione nella conversione di destinazione.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/conversions
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 | ||
billingCycle |
enum:
|
|
offerId |
string |
|
orderId |
string |
|
quantity |
integer |
|
targetOfferId |
string |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Microsoft. |
La richiesta ha avuto esito positivo. Il risultato della conversione viene restituito nel corpo della risposta. 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
Microsoft.Partner.Core.Collections.ResourceAttributes
Nome | Tipo | Descrizione |
---|---|---|
etag |
string |
|
objectType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Conversion
Nome | Tipo | Descrizione |
---|---|---|
attributes | ||
billingCycle |
enum:
|
|
offerId |
string |
|
orderId |
string |
|
quantity |
integer |
|
targetOfferId |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionError
Nome | Tipo | Descrizione |
---|---|---|
attributes | ||
code |
enum:
|
|
description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionResult
Nome | Tipo | Descrizione |
---|---|---|
attributes | ||
error |
Microsoft. |
|
offerId |
string |
|
subscriptionId |
string |
|
targetOfferId |
string |