Manage orders - Create a transition for a subscription
Stellen Sie die Übergangsanforderung für ein Abonnement bereit.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
customer_id
|
path | True |
string |
Die Kunden-ID. |
subscription_id
|
path | True |
string |
Die Abonnement-ID. |
version
|
path | True |
string |
Anforderungsheader
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Authorization | True |
string |
Autorisierungs-Bearertoken |
ms-correlationid |
string |
Wird für die interne Nachverfolgung von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue. |
|
ms-cv |
string |
Wird für die interne Nachverfolgung von Anforderungen verwendet. Wenn kein ms-cv bereitgestellt wird, generiert der Server für jede Anforderung eine neue. |
|
ms-requestid |
string |
Wird für Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue. |
Anforderungstext
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Name | Typ | Beschreibung |
---|---|---|
attributes | ||
billingCycle |
string |
|
events |
Microsoft. |
|
fromCatalogItemId |
string |
|
fromSubscriptionId |
string |
|
promotionId |
string |
|
quantity |
integer |
|
termDuration |
string |
|
toCatalogItemId |
string |
|
toSubscriptionId |
string |
|
transitionType |
string |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Microsoft. |
Die Anforderung wurde erfolgreich gesendet. Der Antworttext enthält das Übergangsergebnis. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
400 Bad Request |
Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
401 Unauthorized |
Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
403 Forbidden |
Die Anforderung wurde authentifiziert, aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
404 Not Found |
Die Ressource ist mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
500 Internal Server Error |
Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer können dies wiederholen. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definitionen
Microsoft.Partner.Core.Collections.ResourceAttributes
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
|
objectType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Transition
Name | Typ | Beschreibung |
---|---|---|
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 | Typ | Beschreibung |
---|---|---|
code |
enum:
|
|
description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent
Name | Typ | Beschreibung |
---|---|---|
attributes | ||
errors |
Microsoft. |
|
name |
string |
|
status |
string |
|
timestamp |
string |