通过

Manage orders - Perform a subscription upgrade

  • 参考
服务:
Partner Center Rest
API 版本:
v1

执行订阅升级。

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/upgrades

URI 参数

名称 在 必需 类型 说明
customer_id
 path True

string

客户 ID。
subscription_id
 path True

string

订阅 ID。
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

Microsoft.Partner.Core.Collections.ResourceAttributes

isEligible

boolean

quantity

integer

targetOffer

Microsoft.Partner.Providers.Catalog.V1.Models.Offer

upgradeErrors

Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError[]

upgradeType enum:
  • none
  • upgrade_only
  • upgrade_with_license_transfer

响应

名称 类型 说明
200 OK

Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeResult

请求成功。 升级结果在响应正文中返回。

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
Microsoft.Partner.Core.Collections.ResourceAttributes
Microsoft.Partner.Core.Collections.ResourceLinks
Microsoft.Partner.Core.Web.Exceptions.ServiceFault
Microsoft.Partner.Providers.Catalog.V1.Models.Offer
Microsoft.Partner.Providers.Catalog.V1.Models.OfferCategory
Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks
Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct
Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError
Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeResult
Microsoft.Partner.Services.Subscriptions.V1.Models.UserLicenseError
SupportedBillingCycles
System.Collections.Generic.KeyValuePair[System.String,System.String]
名称 类型 说明
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

Microsoft.Partner.Core.Collections.ResourceAttributes

名称 类型 说明
etag

string

objectType

string

名称 类型 说明
next

Microsoft.Partner.Core.Collections.Link

previous

Microsoft.Partner.Core.Collections.Link

self

Microsoft.Partner.Core.Collections.Link

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

Microsoft.Partner.Core.Collections.ResourceAttributes

billing

string

category

Microsoft.Partner.Providers.Catalog.V1.Models.OfferCategory

conversionTargetOffers

string[]

description

string

hasAddOns

boolean

id

string

isAutoRenewable

boolean

isAvailableForPurchase

boolean

isInternal

boolean

isMicrosoftProduct

boolean

isTrial

boolean

links

Microsoft.Partner.Providers.Catalog.V1.Models.OfferLinks

maximumQuantity

integer

minimumQuantity

integer

name

string

product

Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct

reselleeQualifications

string[]

resellerQualifications

string[]

salesGroupId

string

supportedBillingCycles

SupportedBillingCycles[]

supportedCatalogTypes

string[]

term

integer

termUnitOfMeasure

string

unitType

string

upgradeTargetOffers

string[]

uri

string

Microsoft.Partner.Providers.Catalog.V1.Models.OfferCategory

名称 类型 说明
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

country

string

id

string

links

Microsoft.Partner.Core.Collections.ResourceLinks

locale

string

name

string

rank

integer

名称 类型 说明
learnMore

Microsoft.Partner.Core.Collections.Link

next

Microsoft.Partner.Core.Collections.Link

previous

Microsoft.Partner.Core.Collections.Link

self

Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Providers.Catalog.V1.Models.OfferProduct

名称 类型 说明
id

string

name

string

unit

string

Microsoft.Partner.Services.Subscriptions.V1.Models.Upgrade

名称 类型 说明
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

isEligible

boolean

quantity

integer

targetOffer

Microsoft.Partner.Providers.Catalog.V1.Models.Offer

upgradeErrors

Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError[]

upgradeType enum:
  • none
  • upgrade_only
  • upgrade_with_license_transfer

Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError

名称 类型 说明
additionalDetails

string

attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

code enum:
  • 0
  • 1
  • 10
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
description

string

Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeResult

名称 类型 说明
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

licenseErrors

Microsoft.Partner.Services.Subscriptions.V1.Models.UserLicenseError[]

sourceSubscriptionId

string

targetSubscriptionId

string

upgradeErrors

Microsoft.Partner.Services.Subscriptions.V1.Models.UpgradeError[]

upgradeType enum:
  • none
  • upgrade_only
  • upgrade_with_license_transfer

Microsoft.Partner.Services.Subscriptions.V1.Models.UserLicenseError

名称 类型 说明
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

email

string

errors

Microsoft.Partner.Core.Web.Exceptions.ServiceFault[]

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