Manage orders - Perform a subscription upgrade
Wykonuje uaktualnienie subskrypcji.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/upgradesParametry 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 nie podano ms-cv, serwer wygeneruje nowy dla każdego żądania |
|
| ms-requestid |
string |
Służy do idempotentności żądań. Jeśli nie podano identyfikatora ms-requestid, 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 | ||
| isEligible |
boolean |
|
| quantity |
integer |
|
| targetOffer | ||
| upgradeErrors |
Microsoft. |
|
| upgradeType |
enum:
|
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Microsoft. |
Żądanie zakończyło się pomyślnie. Wynik uaktualnienia jest zwracany w treści odpowiedzi. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
| 400 Bad Request |
Brak danych wejściowych lub nieprawidłowy. 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 praw do jego wywołania. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
Zasób nie został znaleziony lub niedostę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 jego 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
Microsoft.Partner.Core.Collections.Link
| Nazwa | Typ | Opis |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
Microsoft.Partner.Core.Collections.ResourceAttributes
| Nazwa | Typ | Opis |
|---|---|---|
| etag |
string |
|
| objectType |
string |
Microsoft.Partner.Core.Collections.ResourceLinks
| Nazwa | Typ | Opis |
|---|---|---|
| next | ||
| previous | ||
| self |
Microsoft.Partner.Core.Web.Exceptions.ServiceFault
| Nazwa | Typ | Opis |
|---|---|---|
| code |
integer |
|
| data |
string[] |
|
| description |
string |
|
| source |
string |
Microsoft.Partner.Providers.Catalog.V1.Models.Offer
| Nazwa | Typ | Opis |
|---|---|---|
| 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
| Nazwa | Typ | Opis |
|---|---|---|
| attributes | ||
| country |
string |
|
| id |
string |
|
| links | ||
| locale |
string |
|
| name |
string |
|
| rank |
integer |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks
| Nazwa | Typ | Opis |
|---|---|---|
| learnMore | ||
| next | ||
| previous | ||
| self |
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 | ||
| isEligible |
boolean |
|
| quantity |
integer |
|
| targetOffer | ||
| upgradeErrors |
Microsoft. |
|
| upgradeType |
enum:
|
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError
| Nazwa | Typ | Opis |
|---|---|---|
| additionalDetails |
string |
|
| attributes | ||
| code |
enum:
|
|
| description |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeResult
| Nazwa | Typ | Opis |
|---|---|---|
| attributes | ||
| licenseErrors |
Microsoft. |
|
| sourceSubscriptionId |
string |
|
| targetSubscriptionId |
string |
|
| upgradeErrors |
Microsoft. |
|
| upgradeType |
enum:
|
Microsoft.Partner.Services.Subscriptions.V1.Models.UserLicenseError
| Nazwa | Typ | Opis |
|---|---|---|
| attributes | ||
|
string |
||
| errors | ||
| name |
string |
|
| userObjectId |
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 |