Bagikan melalui

Manage orders - Perform a subscription upgrade

  • Referensi
Layanan:
Partner Center Rest
Versi API:
v1

Melakukan peningkatan langganan.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
customer_id
 path True

string

Id pelanggan.
subscription_id
 path True

string

Id langganan.
version
 path True

string

Header Permintaan

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

Nama Diperlukan Jenis Deskripsi
Authorization True

string

Token Pembawa Otorisasi
ms-correlationid

string

Digunakan untuk melacak permintaan secara internal. Jika ms-correlationid tidak disediakan, server akan menghasilkan yang baru untuk setiap permintaan
ms-cv

string

Digunakan untuk melacak permintaan secara internal. Jika ms-cv tidak disediakan, server akan menghasilkan yang baru untuk setiap permintaan
ms-requestid

string

Digunakan untuk idempotensi permintaan. Jika ms-requestid tidak disediakan, server akan menghasilkan yang baru untuk setiap permintaan

Isi Permintaan

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

Nama Jenis Deskripsi
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

isEligible

boolean

quantity

integer (int32)

targetOffer

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

upgradeErrors

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

upgradeType enum:
  • none (int32)
  • upgrade_only (int32)
  • upgrade_with_license_transfer (int32)

Respons

Nama Jenis Deskripsi
200 OK

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

Permintaan berhasil. Hasil peningkatan dikembalikan dalam isi respons.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Ada input yang hilang atau tidak valid. Isi respons akan memberikan detail kesalahan.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

Permintaan tidak diautentikasi. Klien perlu mengautentikasi dengan layanan API mitra terlebih dahulu.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

Permintaan diautentikasi tetapi ditolak karena pemanggil tidak memiliki hak untuk memanggilnya.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

Sumber daya tidak ditemukan atau tidak tersedia dengan parameter input yang diberikan.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

Layanan API mitra atau salah satu dependensinya gagal memenuhi permintaan. Penelepon dapat mencoba kembali ini.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definisi

Nama Deskripsi
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]
Objek
Nama Jenis Deskripsi
body

string

headers

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

method

string

uri

string

Microsoft.Partner.Core.Collections.ResourceAttributes

Objek
Nama Jenis Deskripsi
etag

string

objectType

string

Objek
Nama Jenis Deskripsi
next

Microsoft.Partner.Core.Collections.Link

previous

Microsoft.Partner.Core.Collections.Link

self

Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Core.Web.Exceptions.ServiceFault

Objek
Nama Jenis Deskripsi
code

integer (int32)

data

string[]

description

string

source

string

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

Objek
Nama Jenis Deskripsi
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 (int32)

minimumQuantity

integer (int32)

name

string

product

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

reselleeQualifications

string[]

resellerQualifications

string[]

salesGroupId

string

supportedBillingCycles

SupportedBillingCycles[] (int32)

supportedCatalogTypes

string[]

term

integer (int32)

termUnitOfMeasure

string

unitType

string

upgradeTargetOffers

string[]

uri

string

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

Objek
Nama Jenis Deskripsi
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

country

string

id

string

links

Microsoft.Partner.Core.Collections.ResourceLinks

locale

string

name

string

rank

integer (int32)

Objek
Nama Jenis Deskripsi
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

Objek
Nama Jenis Deskripsi
id

string

name

string

unit

string

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

Objek
Nama Jenis Deskripsi
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

isEligible

boolean

quantity

integer (int32)

targetOffer

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

upgradeErrors

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

upgradeType enum:
  • none (int32)
  • upgrade_only (int32)
  • upgrade_with_license_transfer (int32)

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

Objek
Nama Jenis Deskripsi
additionalDetails

string

attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

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

string

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

Objek
Nama Jenis Deskripsi
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 (int32)
  • upgrade_only (int32)
  • upgrade_with_license_transfer (int32)

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

Objek
Nama Jenis Deskripsi
attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

email

string

errors

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

name

string

userObjectId

string (uuid)

SupportedBillingCycles

Enumeration
Nilai Deskripsi
annual
monthly
none
one_time
triennial
unknown

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

Objek
Nama Jenis Deskripsi
key

string

value

string