Udostępnij za pośrednictwem


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 ms-cv nie zostanie podany, serwer wygeneruje nowy dla każdego żądania

ms-requestid

string

Służy do idempotentności żądań. Jeśli parametr ms-requestid nie zostanie podany, 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

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

Odpowiedzi

Nazwa Typ Opis
200 OK

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

Żą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łowych danych wejściowych. 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 uprawnień do jego wywołania.

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

404 Not Found

Zasób nie został znaleziony lub nie jest dostę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 jej 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

Nazwa Opis
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

Nazwa Typ Opis
etag

string

objectType

string

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

Nazwa Typ Opis
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

Nazwa Typ Opis
code enum:
  • 0
  • 1
  • 10
  • 11
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
description

string

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

Nazwa Typ Opis
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

errors

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

name

string

status

string

timestamp

string