Udostępnij za pośrednictwem


Manage orders - Get upgrades for a subscription

Pobiera uaktualnienia dla subskrypcji.

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

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

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

Odpowiedzi

Nazwa Typ Opis
200 OK

Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade]

Żądanie zakończyło się pomyślnie. Treść odpowiedzi zawiera uaktualnienia.

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

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"

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"

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"

404 Not Found

Zasób nie został znaleziony lub nie jest dostępny z podanymi parametrami wejściowymi.

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

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"

Definicje

Nazwa Opis
Microsoft.Partner.Core.Collections.Link
Microsoft.Partner.Core.Collections.ResourceAttributes
Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade]
Microsoft.Partner.Core.Collections.ResourceLinks
Microsoft.Partner.Providers.Catalog.V1.Models.Offer
Microsoft.Partner.Providers.Catalog.V1.Models.OfferCategory
Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks
Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct
Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError
SupportedBillingCycles
System.Collections.Generic.KeyValuePair[System.String,System.String]
Nazwa Typ Opis
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

Microsoft.Partner.Core.Collections.ResourceAttributes

Nazwa Typ Opis
etag

string

objectType

string

Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade]

Nazwa Typ Opis
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

items

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

links

Microsoft.Partner.Core.Collections.ResourceLinks

totalCount

integer

Nazwa Typ Opis
next

Microsoft.Partner.Core.Collections.Link

previous

Microsoft.Partner.Core.Collections.Link

self

Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Providers.Catalog.V1.Models.Offer

Nazwa Typ Opis
acquisitionType

string

actions

string[]

additionalProperties

object

attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

billing

string

category

Microsoft.Partner.Providers.Catalog.V1.Models.OfferCategory

conversionTargetOffers

string[]

description

string

hasAddOns

boolean

id

string

isAutoRenewable

boolean

isAvailableForPurchase

boolean

isInternal

boolean

isMicrosoftProduct

boolean

isTrial

boolean

links

Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks

maximumQuantity

integer

minimumQuantity

integer

name

string

product

Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct

reselleeQualifications

string[]

resellerQualifications

string[]

salesGroupId

string

supportedBillingCycles

SupportedBillingCycles[]

supportedCatalogTypes

string[]

term

integer

termUnitOfMeasure

string

unitType

string

upgradeTargetOffers

string[]

uri

string

Microsoft.Partner.Providers.Catalog.V1.Models.OfferCategory

Nazwa Typ Opis
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

country

string

id

string

links

Microsoft.Partner.Core.Collections.ResourceLinks

locale

string

name

string

rank

integer

Nazwa Typ Opis
learnMore

Microsoft.Partner.Core.Collections.Link

next

Microsoft.Partner.Core.Collections.Link

previous

Microsoft.Partner.Core.Collections.Link

self

Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct

Nazwa Typ Opis
id

string

name

string

unit

string

Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade

Nazwa Typ Opis
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

isEligible

boolean

quantity

integer

targetOffer

Microsoft.Partner.Providers.Catalog.V1.Models.Offer

upgradeErrors

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

upgradeType enum:
  • none
  • upgrade_only
  • upgrade_with_license_transfer

Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError

Nazwa Typ Opis
additionalDetails

string

attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

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

string

SupportedBillingCycles

Nazwa Typ Opis
annual

string

monthly

string

none

string

one_time

string

triennial

string

unknown

string

System.Collections.Generic.KeyValuePair[System.String,System.String]

Nazwa Typ Opis
key

string

value

string