Manage orders - Perform a subscription upgrade
Provede upgrade předplatného.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/upgrades
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 k internímu sledování požadavků. Pokud není zadaný identifikátor ms-correlationid, server vygeneruje pro každý požadavek nový. |
|
ms-cv |
string |
Používá se k internímu sledování požadavků. Pokud ms-cv není zadaný, server vygeneruje pro každou žádost nový. |
|
ms-requestid |
string |
Používá se pro idempotenci požadavků. Pokud není zadaný identifikátor ms-requestid, server pro každou žádost vygeneruje nový. |
Text požadavku
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
Name | Typ | Description |
---|---|---|
attributes | ||
isEligible |
boolean |
|
quantity |
integer |
|
targetOffer | ||
upgradeErrors |
Microsoft. |
|
upgradeType |
enum:
|
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Microsoft. |
Požadavek byl úspěšný. Výsledek upgradu se vrátí v textu odpovědi. 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á práva k jeho vyvolání. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
404 Not Found |
Prostředek se s danými vstupními parametry nenašel nebo není k dispozici. 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
Microsoft.Partner.Core.Collections.Link
Name | Typ | Description |
---|---|---|
body |
string |
|
headers |
System. |
|
method |
string |
|
uri |
string |
Microsoft.Partner.Core.Collections.ResourceAttributes
Name | Typ | Description |
---|---|---|
etag |
string |
|
objectType |
string |
Microsoft.Partner.Core.Collections.ResourceLinks
Name | Typ | Description |
---|---|---|
next | ||
previous | ||
self |
Microsoft.Partner.Core.Web.Exceptions.ServiceFault
Name | Typ | Description |
---|---|---|
code |
integer |
|
data |
string[] |
|
description |
string |
|
source |
string |
Microsoft.Partner.Providers.Catalog.V1.Models.Offer
Name | Typ | Description |
---|---|---|
acquisitionType |
string |
|
actions |
string[] |
|
additionalProperties |
object |
|
attributes | ||
billing |
string |
|
category | ||
conversionTargetOffers |
string[] |
|
description |
string |
|
hasAddOns |
boolean |
|
id |
string |
|
isAutoRenewable |
boolean |
|
isAvailableForPurchase |
boolean |
|
isInternal |
boolean |
|
isMicrosoftProduct |
boolean |
|
isTrial |
boolean |
|
links | ||
maximumQuantity |
integer |
|
minimumQuantity |
integer |
|
name |
string |
|
product | ||
reselleeQualifications |
string[] |
|
resellerQualifications |
string[] |
|
salesGroupId |
string |
|
supportedBillingCycles | ||
supportedCatalogTypes |
string[] |
|
term |
integer |
|
termUnitOfMeasure |
string |
|
unitType |
string |
|
upgradeTargetOffers |
string[] |
|
uri |
string |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferCategory
Name | Typ | Description |
---|---|---|
attributes | ||
country |
string |
|
id |
string |
|
links | ||
locale |
string |
|
name |
string |
|
rank |
integer |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks
Name | Typ | Description |
---|---|---|
learnMore | ||
next | ||
previous | ||
self |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct
Name | Typ | Description |
---|---|---|
id |
string |
|
name |
string |
|
unit |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade
Name | Typ | Description |
---|---|---|
attributes | ||
isEligible |
boolean |
|
quantity |
integer |
|
targetOffer | ||
upgradeErrors |
Microsoft. |
|
upgradeType |
enum:
|
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError
Name | Typ | Description |
---|---|---|
additionalDetails |
string |
|
attributes | ||
code |
enum:
|
|
description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeResult
Name | Typ | Description |
---|---|---|
attributes | ||
licenseErrors |
Microsoft. |
|
sourceSubscriptionId |
string |
|
targetSubscriptionId |
string |
|
upgradeErrors |
Microsoft. |
|
upgradeType |
enum:
|
Microsoft.Partner.Services.Subscriptions.V1.Models.UserLicenseError
Name | Typ | Description |
---|---|---|
attributes | ||
string |
||
errors | ||
name |
string |
|
userObjectId |
string |
SupportedBillingCycles
Name | Typ | Description |
---|---|---|
annual |
string |
|
monthly |
string |
|
none |
string |
|
one_time |
string |
|
triennial |
string |
|
unknown |
string |
System.Collections.Generic.KeyValuePair[System.String,System.String]
Name | Typ | Description |
---|---|---|
key |
string |
|
value |
string |