Dela via


Manage orders - Create a transition for a subscription

Publicera övergångsbegäran för en prenumeration.

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

URI-parametrar

Name I Obligatorisk Typ Description
customer_id
path True

string

Kund-ID: t.

subscription_id
path True

string

Prenumerations-ID:t.

version
path True

string

Begärandehuvud

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

Name Obligatorisk Typ Description
Authorization True

string

Token för auktoriseringsbärare

ms-correlationid

string

Används för att spåra begäranden internt. Om ett ms-correlationid inte anges genererar servern en ny för varje begäran

ms-cv

string

Används för att spåra begäranden internt. Om en ms-cv inte tillhandahålls genererar servern en ny för varje begäran

ms-requestid

string

Används för idempotens för begäranden. Om ett ms-requestid inte har angetts genererar servern en ny för varje begäran

Begärandetext

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

Svar

Name Typ Description
200 OK

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

Begäran lyckades. Svarstexten innehåller övergångsresultatet.

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

400 Bad Request

Det saknades eller ogiltiga indata. Svarstexten innehåller felinformationen.

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

401 Unauthorized

Begäran autentiserades inte. Klienten måste autentisera med partner-API-tjänsten först.

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

403 Forbidden

Begäran autentiserades men nekades eftersom anroparen inte har behörighet att anropa den.

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

404 Not Found

Resursen hittades inte eller är inte tillgänglig med de angivna indataparametrarna.

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

500 Internal Server Error

Partner-API-tjänsten eller något av dess beroenden kunde inte uppfylla begäran. Anropare kan försöka igen.

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

Definitioner

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