다음을 통해 공유

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 매개 변수

Name In(다음 안에) 필수 형식 Description
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"

Name 필수 형식 Description
Authorization True

string

권한 부여 전달자 토큰
ms-correlationid

string

내부적으로 요청을 추적하는 데 사용됩니다. ms-correlationid가 제공되지 않으면 서버는 각 요청에 대해 새 상관 관계를 생성합니다.
ms-cv

string

내부적으로 요청을 추적하는 데 사용됩니다. ms-cv 제공되지 않으면 서버는 각 요청에 대해 새 ms-cv 생성합니다.
ms-requestid

string

요청의 idempotency에 사용됩니다. ms-requestid가 제공되지 않으면 서버는 각 요청에 대해 새 요청을 생성합니다.

요청 본문

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name 형식 Description
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

응답

Name 형식 Description
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"

정의

Name Description
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]
Name 형식 Description
body

string

headers

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

method

string

uri

string

Microsoft.Partner.Core.Collections.ResourceAttributes

Name 형식 Description
etag

string

objectType

string

Name 형식 Description
next

Microsoft.Partner.Core.Collections.Link

previous

Microsoft.Partner.Core.Collections.Link

self

Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Core.Web.Exceptions.ServiceFault

Name 형식 Description
code

integer

data

string[]

description

string

source

string

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

Name 형식 Description
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

Name 형식 Description
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

country

string

id

string

links

Microsoft.Partner.Core.Collections.ResourceLinks

locale

string

name

string

rank

integer

Name 형식 Description
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

Name 형식 Description
id

string

name

string

unit

string

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

Name 형식 Description
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

Name 형식 Description
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

Name 형식 Description
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

Name 형식 Description
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

email

string

errors

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

name

string

userObjectId

string

SupportedBillingCycles

Name 형식 Description
annual

string

monthly

string

none

string

one_time

string

triennial

string

unknown

string

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

Name 형식 Description
key

string

value

string