Manage orders - Get upgrades for a subscription
サブスクリプションのアップグレードを取得します。
GET https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/upgradesURI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
顧客 ID。 |
|
subscription_id
|
path | True |
string |
サブスクリプション ID。 |
|
version
|
path | True |
string |
要求ヘッダー
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| Authorization | True |
string |
承認ベアラー トークン |
| ms-correlationid |
string |
要求を内部的に追跡するために使用されます。 ms-correlationid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
|
| ms-cv |
string |
要求を内部的に追跡するために使用されます。 ms-cv が指定されていない場合、サーバーは要求ごとに新しい ms-cv を生成します |
|
| ms-requestid |
string |
要求のべき等性に使用されます。 ms-requestid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
要求が成功しました。 応答本文にはアップグレードが含まれています。 Media Types: "application/json", "text/json" |
|
| 400 Bad Request |
入力が見つからないか無効でした。 応答本文には、エラーの詳細が表示されます。 Media Types: "application/json", "text/json" |
|
| 401 Unauthorized |
要求が認証されませんでした。 クライアントは、最初にパートナー API サービスで認証する必要があります。 Media Types: "application/json", "text/json" |
|
| 403 Forbidden |
要求は認証されましたが、呼び出し元に呼び出す権限がないため拒否されました。 Media Types: "application/json", "text/json" |
|
| 404 Not Found |
リソースが見つからないか、指定された入力パラメーターで使用できません。 Media Types: "application/json", "text/json" |
|
| 500 Internal Server Error |
パートナー API サービスまたはその依存関係の 1 つが要求を満たできませんでした。 呼び出し元はこれを再試行できます。 Media Types: "application/json", "text/json" |
定義
Microsoft.Partner.Core.Collections.Link
| 名前 | 型 | 説明 |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
Microsoft.Partner.Core.Collections.ResourceAttributes
| 名前 | 型 | 説明 |
|---|---|---|
| etag |
string |
|
| objectType |
string |
Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade]
| 名前 | 型 | 説明 |
|---|---|---|
| attributes | ||
| items |
Microsoft. |
|
| links | ||
| totalCount |
integer |
Microsoft.Partner.Core.Collections.ResourceLinks
| 名前 | 型 | 説明 |
|---|---|---|
| next | ||
| previous | ||
| self |
Microsoft.Partner.Providers.Catalog.V1.Models.Offer
| 名前 | 型 | 説明 |
|---|---|---|
| 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
| 名前 | 型 | 説明 |
|---|---|---|
| attributes | ||
| country |
string |
|
| id |
string |
|
| links | ||
| locale |
string |
|
| name |
string |
|
| rank |
integer |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks
| 名前 | 型 | 説明 |
|---|---|---|
| learnMore | ||
| next | ||
| previous | ||
| self |
Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string |
|
| name |
string |
|
| unit |
string |
Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade
| 名前 | 型 | 説明 |
|---|---|---|
| attributes | ||
| isEligible |
boolean |
|
| quantity |
integer |
|
| targetOffer | ||
| upgradeErrors |
Microsoft. |
|
| upgradeType |
enum:
|
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError
| 名前 | 型 | 説明 |
|---|---|---|
| additionalDetails |
string |
|
| attributes | ||
| code |
enum:
|
|
| description |
string |
SupportedBillingCycles
| 名前 | 型 | 説明 |
|---|---|---|
| annual |
string |
|
| monthly |
string |
|
| none |
string |
|
| one_time |
string |
|
| triennial |
string |
|
| unknown |
string |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| 名前 | 型 | 説明 |
|---|---|---|
| key |
string |
|
| value |
string |