Sdílet prostřednictvím


Manage orders - Create a transition for a subscription

Po odeslání žádosti o převod předplatného

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/transitions

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
customer_id
path True

string

ID zákazníka.

subscription_id
path True

string

ID předplatného.

version
path True

string

Hlavička požadavku

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Vyžadováno Typ Description
Authorization True

string

Nosný token autorizace

ms-correlationid

string

Používá se pro interní sledování požadavků. Pokud ms-correlationid není zadaný, server pro každý požadavek vygeneruje nový.

ms-cv

string

Používá se pro interní sledování požadavků. Pokud ms-cv není k dispozici, server pro každý požadavek vygeneruje nový.

ms-requestid

string

Používá se pro idempotenci požadavků. Pokud ms-requestid není zadaný, server pro každý požadavek vygeneruje nový.

Text požadavku

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Typ Description
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

Odpovědi

Name Typ Description
200 OK

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

Žádost byla úspěšná. Text odpovědi obsahuje výsledek přechodu.

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

400 Bad Request

Chybí nebo je neplatný vstup. Text odpovědi poskytne podrobnosti o chybě.

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

401 Unauthorized

Požadavek nebyl ověřen. Klient se musí nejprve ověřit ve službě partnerského rozhraní API.

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

403 Forbidden

Požadavek byl ověřen, ale byl odmítnut, protože volající nemá oprávnění k jejímu vyvolání.

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

404 Not Found

Prostředek nebyl nalezen nebo není k dispozici s danými vstupními parametry.

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

500 Internal Server Error

Službě partnerského rozhraní API nebo některé z jejích závislostí se nepodařilo požadavek splnit. Volající to můžou zkusit znovu.

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

Definice

Name Description
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

Name Typ Description
etag

string

objectType

string

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

Name Typ Description
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

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

string

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

Name Typ Description
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

errors

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

name

string

status

string

timestamp

string