Manage orders - Create a transition for a subscription
Opublikuj żądanie przeniesienia dla subskrypcji.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
Identyfikator klienta. |
|
subscription_id
|
path | True |
string |
Identyfikator subskrypcji. |
|
version
|
path | True |
string |
Nagłówek żądania
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| Authorization | True |
string |
Token elementu nośnego autoryzacji |
| ms-correlationid |
string |
Służy do śledzenia żądań wewnętrznie. Jeśli nie podano identyfikatora ms-correlationid, serwer wygeneruje nowy dla każdego żądania |
|
| ms-cv |
string |
Służy do śledzenia żądań wewnętrznie. Jeśli nie podano ms-cv, serwer wygeneruje nowy dla każdego żądania |
|
| ms-requestid |
string |
Służy do idempotentności żądań. Jeśli nie podano identyfikatora ms-requestid, serwer wygeneruje nowy dla każdego żądania |
Treść żądania
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nazwa | Typ | Opis |
|---|---|---|
| attributes | ||
| billingCycle |
string |
|
| events |
Microsoft. |
|
| fromCatalogItemId |
string |
|
| fromSubscriptionId |
string |
|
| promotionId |
string |
|
| quantity |
integer (int32) |
|
| termDuration |
string |
|
| toCatalogItemId |
string |
|
| toSubscriptionId |
string |
|
| transitionType |
string |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Microsoft. |
Żądanie zakończyło się pomyślnie. Treść odpowiedzi zawiera wynik przejścia. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
| 400 Bad Request |
Brak danych wejściowych lub nieprawidłowy. Treść odpowiedzi udostępni szczegóły błędu. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
Żądanie nie zostało uwierzytelnione. Klient musi najpierw uwierzytelnić się za pomocą usługi interfejsu API partnera. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
Żądanie zostało uwierzytelnione, ale zostało odrzucone, ponieważ obiekt wywołujący nie ma praw do jego wywołania. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
Zasób nie został znaleziony lub niedostępny z podanymi parametrami wejściowymi. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
Usługa interfejsu API partnera lub jedna z jego zależności nie spełniła żądania. Osoby wywołujące mogą ponowić próbę. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definicje
Microsoft.Partner.Core.Collections.ResourceAttributes
| Nazwa | Typ | Opis |
|---|---|---|
| etag |
string |
|
| objectType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Transition
| Nazwa | Typ | Opis |
|---|---|---|
| attributes | ||
| billingCycle |
string |
|
| events |
Microsoft. |
|
| fromCatalogItemId |
string |
|
| fromSubscriptionId |
string |
|
| promotionId |
string |
|
| quantity |
integer (int32) |
|
| termDuration |
string |
|
| toCatalogItemId |
string |
|
| toSubscriptionId |
string |
|
| transitionType |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionError
| Nazwa | Typ | Opis |
|---|---|---|
| code |
enum:
|
|
| description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.TransitionEvent
| Nazwa | Typ | Opis |
|---|---|---|
| attributes | ||
| errors |
Microsoft. |
|
| name |
string |
|
| status |
string |
|
| timestamp |
string (date-time) |