Manage orders - Create a transition for a subscription
Post de overgangsaanvraag voor een abonnement.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
customer_id
|
path | True |
string |
De klant-id. |
subscription_id
|
path | True |
string |
De abonnements-id. |
version
|
path | True |
string |
Aanvraagkoptekst
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Name | Vereist | Type | Description |
---|---|---|---|
Authorization | True |
string |
Bearer-token voor autorisatie |
ms-correlationid |
string |
Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid is opgegeven, genereert de server een nieuwe voor elke aanvraag |
|
ms-cv |
string |
Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-cv is opgegeven, genereert de server een nieuwe voor elke aanvraag |
|
ms-requestid |
string |
Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag |
Aanvraagbody
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Name | Type | Description |
---|---|---|
attributes | ||
billingCycle |
string |
|
events |
Microsoft. |
|
fromCatalogItemId |
string |
|
fromSubscriptionId |
string |
|
promotionId |
string |
|
quantity |
integer |
|
termDuration |
string |
|
toCatalogItemId |
string |
|
toSubscriptionId |
string |
|
transitionType |
string |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Microsoft. |
De aanvraag is geslaagd. De hoofdtekst van het antwoord bevat het overgangsresultaat. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
400 Bad Request |
Er is een ontbrekende of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
401 Unauthorized |
De aanvraag is niet geverifieerd. De client moet eerst worden geverifieerd met de partner-API-service. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
403 Forbidden |
De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
404 Not Found |
De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
500 Internal Server Error |
De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen dit opnieuw proberen. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definities
Microsoft.Partner.Core.Collections.ResourceAttributes
Name | Type | Description |
---|---|---|
etag |
string |
|
objectType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Transition
Name | 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
Name | Type | Description |
---|---|---|
code |
enum:
|
|
description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent
Name | Type | Description |
---|---|---|
attributes | ||
errors |
Microsoft. |
|
name |
string |
|
status |
string |
|
timestamp |
string |