Manage orders - Perform a subscription upgrade
Выполняет обновление подписки.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/upgradesПараметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
Идентификатор клиента. |
|
subscription_id
|
path | True |
string |
Идентификатор подписки. |
|
version
|
path | True |
string |
Заголовок запроса
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Имя | Обязательно | Тип | Описание |
|---|---|---|---|
| Authorization | True |
string |
Маркер носителя авторизации |
| ms-correlationid |
string |
Используется для отслеживания запросов внутри системы. Если ms-correlationid не указан, сервер создаст новый для каждого запроса. |
|
| ms-cv |
string |
Используется для отслеживания запросов внутри системы. Если ms-cv не предоставлено, сервер создаст новый для каждого запроса. |
|
| ms-requestid |
string |
Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создаст новый для каждого запроса. |
Текст запроса
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Имя | Тип | Описание |
|---|---|---|
| attributes | ||
| isEligible |
boolean |
|
| quantity |
integer |
|
| targetOffer | ||
| upgradeErrors |
Microsoft. |
|
| upgradeType |
enum:
|
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Microsoft. |
Запрос выполнен успешно. Результат обновления возвращается в тексте ответа. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
| 400 Bad Request |
Отсутствуют или недопустимые входные данные. Текст ответа предоставит сведения об ошибке. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
Запрос не прошел проверку подлинности. Сначала клиент должен пройти проверку подлинности с помощью службы API партнеров. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
Запрос прошел проверку подлинности, но был отклонен, так как вызывающий объект не имеет прав на его вызов. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
Ресурс не найден или недоступен с заданными входными параметрами. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить это. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Определения
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.ResourceLinks
| Имя | Тип | Описание |
|---|---|---|
| next | ||
| previous | ||
| self |
Microsoft.Partner.Core.Web.Exceptions.ServiceFault
| Имя | Тип | Описание |
|---|---|---|
| code |
integer |
|
| data |
string[] |
|
| description |
string |
|
| source |
string |
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 |
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeResult
| Имя | Тип | Описание |
|---|---|---|
| attributes | ||
| licenseErrors |
Microsoft. |
|
| sourceSubscriptionId |
string |
|
| targetSubscriptionId |
string |
|
| upgradeErrors |
Microsoft. |
|
| upgradeType |
enum:
|
Microsoft.Partner.Services.Subscriptions.V1.Models.UserLicenseError
| Имя | Тип | Описание |
|---|---|---|
| attributes | ||
|
string |
||
| errors | ||
| name |
string |
|
| userObjectId |
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 |