Manage orders - Get upgrades for a subscription
Ruft die Upgrades für ein Abonnement ab.
GET https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/upgradesURI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
Die Kunden-ID. |
|
subscription_id
|
path | True |
string |
Die Abonnement-ID. |
|
version
|
path | True |
string |
Anforderungsheader
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| Authorization | True |
string |
Autorisierungs-Bearertoken |
| ms-correlationid |
string |
Wird für die interne Nachverfolgung von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue. |
|
| ms-cv |
string |
Wird für die interne Nachverfolgung von Anforderungen verwendet. Wenn kein ms-cv bereitgestellt wird, generiert der Server für jede Anforderung eine neue. |
|
| ms-requestid |
string |
Wird für Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung wurde erfolgreich gesendet. Der Antworttext enthält die Upgrades. Media Types: "application/json", "text/json" |
|
| 400 Bad Request |
Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails. Media Types: "application/json", "text/json" |
|
| 401 Unauthorized |
Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren. Media Types: "application/json", "text/json" |
|
| 403 Forbidden |
Die Anforderung wurde authentifiziert, aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Media Types: "application/json", "text/json" |
|
| 404 Not Found |
Die Ressource ist mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Media Types: "application/json", "text/json" |
|
| 500 Internal Server Error |
Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer können dies wiederholen. Media Types: "application/json", "text/json" |
Definitionen
Microsoft.Partner.Core.Collections.Link
| Name | Typ | Beschreibung |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
Microsoft.Partner.Core.Collections.ResourceAttributes
| Name | Typ | Beschreibung |
|---|---|---|
| etag |
string |
|
| objectType |
string |
Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade]
| Name | Typ | Beschreibung |
|---|---|---|
| attributes | ||
| items |
Microsoft. |
|
| links | ||
| totalCount |
integer |
Microsoft.Partner.Core.Collections.ResourceLinks
| Name | Typ | Beschreibung |
|---|---|---|
| next | ||
| previous | ||
| self |
Microsoft.Partner.Providers.Catalog.V1.Models.Offer
| Name | Typ | Beschreibung |
|---|---|---|
| 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 | Beschreibung |
|---|---|---|
| attributes | ||
| country |
string |
|
| id |
string |
|
| links | ||
| locale |
string |
|
| name |
string |
|
| rank |
integer |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks
| Name | Typ | Beschreibung |
|---|---|---|
| learnMore | ||
| next | ||
| previous | ||
| self |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
|
| name |
string |
|
| unit |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade
| Name | Typ | Beschreibung |
|---|---|---|
| attributes | ||
| isEligible |
boolean |
|
| quantity |
integer |
|
| targetOffer | ||
| upgradeErrors |
Microsoft. |
|
| upgradeType |
enum:
|
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError
| Name | Typ | Beschreibung |
|---|---|---|
| additionalDetails |
string |
|
| attributes | ||
| code |
enum:
|
|
| description |
string |
SupportedBillingCycles
| Name | Typ | Beschreibung |
|---|---|---|
| annual |
string |
|
| monthly |
string |
|
| none |
string |
|
| one_time |
string |
|
| triennial |
string |
|
| unknown |
string |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| Name | Typ | Beschreibung |
|---|---|---|
| key |
string |
|
| value |
string |