Reservation Order - Purchase

Referensi

Service:: Reserved VM Instances

API Version:: 2019-04-01

Beli ReservationOrder dan buat sumber daya di bawah URI yang ditentukan.

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}?api-version=2019-04-01

Parameter URI

Name	In	Required	Type	Description
reservationOrderId	path	True	string	Id Pesanan reservasi
api-version	query	True	string	Versi yang didukung untuk dokumen ini adalah 2019-04-01

Isi Permintaan

Name	Type	Description
location	string	Wilayah Azure tempat sumber daya yang dipesan berada.
properties.appliedScopeType	AppliedScopeType	Jenis Cakupan yang Diterapkan.
properties.appliedScopes	string[]	Daftar langganan yang akan diterapkan manfaatnya. Jangan tentukan apakah AppliedScopeType dibagikan.
properties.billingPlan	ReservationBillingPlan	Mewakili paket penagihan.
properties.billingScopeId	string	Langganan yang akan dikenakan biaya untuk membeli Reservasi
properties.displayName	string	Nama reservasi yang mudah diingat
properties.instanceFlexibility	InstanceFlexibility	Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
properties.quantity	integer	Kuantitas SKU yang merupakan bagian dari Reservasi. Harus lebih besar dari nol.
properties.renew	boolean	Mengatur ini ke true akan secara otomatis membeli reservasi baru pada tanggal kedaluwarsa.
properties.reservedResourceProperties	ReservedResourceProperties	Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.
properties.reservedResourceType	ReservedResourceType	Jenis sumber daya yang sedang dicadangkan.
properties.term	ReservationTerm	Mewakili jangka waktu Reservasi.
sku	SkuName

Respons

Name	Type	Description
200 OK	ReservationOrderResponse	Sumber daya telah dibuat
202 Accepted	ReservationOrderResponse	Permintaan diterima dan sedang diproses. Tautan hasil operasi ada di header lokasi.
Other Status Codes	Error	Kesalahan tidak terduga

Contoh

Purchase

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/a075419f-44cc-497f-b68a-14ee811d48b9?api-version=2019-04-01

{
  "sku": {
    "name": "standard_D1"
  },
  "location": "westus",
  "properties": {
    "reservedResourceType": "VirtualMachines",
    "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    "term": "P1Y",
    "billingPlan": "Monthly",
    "quantity": 1,
    "displayName": "TestReservationOrder",
    "appliedScopes": null,
    "appliedScopeType": "Shared",
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    },
    "renew": false
  }
}

Sample Response

Status code:: 200

{
  "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "type": "Microsoft.Capacity/reservationOrders",
  "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "etag": 7,
  "properties": {
    "displayName": "cabri",
    "requestDateTime": "2017-08-30T03:49:19.0252126Z",
    "createdDateTime": "2017-08-30T03:51:49.8083758Z",
    "expiryDate": "2018-08-30",
    "term": "P1Y",
    "billingPlan": "Monthly",
    "provisioningState": "Succeeded",
    "reservations": [
      {
        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
      }
    ],
    "originalQuantity": 7
  }
}

Status code:: 202

{
  "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "type": "Microsoft.Capacity/reservationOrders",
  "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "etag": 7,
  "properties": {
    "displayName": "cabri",
    "billingPlan": "Monthly",
    "requestDateTime": "2017-08-30T03:49:19.0252126Z",
    "createdDateTime": "2017-08-30T03:51:49.8083758Z",
    "expiryDate": "2018-08-30",
    "term": "P1Y",
    "provisioningState": "Succeeded",
    "reservations": [
      {
        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
      }
    ],
    "originalQuantity": 7
  }
}

Definisi

AppliedScopeProperties
AppliedScopeType	Jenis Cakupan yang Diterapkan.
BillingCurrencyTotal	Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk.
Error
ErrorResponseCode
ExtendedErrorInfo
ExtendedStatusInfo
InstanceFlexibility	Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
PaymentDetail	Informasi tentang pembayaran yang terkait dengan pesanan reservasi.
PaymentStatus	Menjelaskan apakah pembayaran selesai, gagal, dibatalkan, atau dijadwalkan di masa mendatang.
Price
PricingCurrencyTotal	Jumlah yang digunakan Microsoft untuk rekaman. Digunakan selama pengembalian dana untuk menghitung batas pengembalian dana. Pajak tidak termasuk. Ini adalah harga terkunci 30 hari sebelum kedaluwarsa.
PurchaseRequest
RenewPropertiesResponse
ReservationBillingPlan	Mewakili paket penagihan.
ReservationMergeProperties
ReservationOrderBillingPlanInformation	Informasi yang menjelaskan jenis paket penagihan untuk reservasi ini.
ReservationOrderResponse
ReservationProperties
ReservationResponse
ReservationSplitProperties
ReservationStatusCode
ReservationSwapProperties
ReservationTerm	Mewakili jangka waktu Reservasi.
ReservedResourceProperties	Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.
ReservedResourceType	Jenis sumber daya yang sedang dicadangkan.
SkuName

AppliedScopeProperties

Name	Type	Description
displayName	string	Nama tampilan grup manajemen
managementGroupId	string	ID grup manajemen format /providers/Microsoft.Management/managementGroups/{managementGroupId}
tenantId	string	ID penyewa dari jenis cakupan yang diterapkan

AppliedScopeType

Jenis Cakupan yang Diterapkan.

Name	Type	Description
Shared	string
Single	string

BillingCurrencyTotal

Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk.

Name	Type	Description
amount	number
currencyCode	string

Error

Name	Type	Description
error	ExtendedErrorInfo

ErrorResponseCode

Name	Type	Description
ActivateQuoteFailed	string
AppliedScopesNotAssociatedWithCommerceAccount	string
AuthorizationFailed	string
BadRequest	string
BillingCustomerInputError	string
BillingError	string
BillingPaymentInstrumentHardError	string
BillingPaymentInstrumentSoftError	string
BillingScopeIdCannotBeChanged	string
BillingTransientError	string
CalculatePriceFailed	string
CapacityUpdateScopesFailed	string
ClientCertificateThumbprintNotSet	string
CreateQuoteFailed	string
Forbidden	string
FulfillmentConfigurationError	string
FulfillmentError	string
FulfillmentOutOfStockError	string
FulfillmentTransientError	string
HttpMethodNotSupported	string
InternalServerError	string
InvalidAccessToken	string
InvalidFulfillmentRequestParameters	string
InvalidHealthCheckType	string
InvalidLocationId	string
InvalidRefundQuantity	string
InvalidRequestContent	string
InvalidRequestUri	string
InvalidReservationId	string
InvalidReservationOrderId	string
InvalidSingleAppliedScopesCount	string
InvalidSubscriptionId	string
InvalidTenantId	string
MissingAppliedScopesForSingle	string
MissingTenantId	string
NoValidReservationsToReRate	string
NonsupportedAccountId	string
NotSpecified	string
NotSupportedCountry	string
OperationCannotBePerformedInCurrentState	string
OperationFailed	string
PatchValuesSameAsExisting	string
PaymentInstrumentNotFound	string
PurchaseError	string
ReRateOnlyAllowedForEA	string
ReservationIdNotInReservationOrder	string
ReservationOrderCreationFailed	string
ReservationOrderIdAlreadyExists	string
ReservationOrderNotEnabled	string
ReservationOrderNotFound	string
RiskCheckFailed	string
RoleAssignmentCreationFailed	string
ServerTimeout	string
UnauthenticatedRequestsThrottled	string
UnsupportedReservationTerm	string

ExtendedErrorInfo

Name	Type	Description
code	ErrorResponseCode
message	string

ExtendedStatusInfo

Name	Type	Description
message	string	Pesan yang memberikan informasi terperinci tentang kode status.
statusCode	ReservationStatusCode

InstanceFlexibility

Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.

Name	Type	Description
Off	string
On	string

PaymentDetail

Informasi tentang pembayaran yang terkait dengan pesanan reservasi.

Name	Type	Description
billingAccount	string	Menampilkan Akun yang ditagih untuk pembayaran ini.
billingCurrencyTotal	Price	Jumlah yang dibebankan dalam mata uang Penagihan. Pajak tidak termasuk. Null untuk pembayaran di masa mendatang
dueDate	string	Tanggal saat pembayaran perlu dilakukan.
extendedStatusInfo	ExtendedStatusInfo
paymentDate	string	Tanggal ketika transaksi selesai. Null ketika dijadwalkan.
pricingCurrencyTotal	Price	Jumlah dalam mata uang harga. Pajak tidak termasuk.
status	PaymentStatus	Menjelaskan apakah pembayaran selesai, gagal, dibatalkan, atau dijadwalkan di masa mendatang.

PaymentStatus

Menjelaskan apakah pembayaran selesai, gagal, dibatalkan, atau dijadwalkan di masa mendatang.

Name	Type	Description
Cancelled	string
Failed	string
Scheduled	string
Succeeded	string

Price

Name	Type	Description
amount	number
currencyCode	string	Kode mata uang ISO 4217 3 huruf untuk mata uang yang digunakan oleh catatan pembelian ini.

PricingCurrencyTotal

Jumlah yang digunakan Microsoft untuk rekaman. Digunakan selama pengembalian dana untuk menghitung batas pengembalian dana. Pajak tidak termasuk. Ini adalah harga terkunci 30 hari sebelum kedaluwarsa.

Name	Type	Description
amount	number
currencyCode	string

PurchaseRequest

Name	Type	Default Value	Description
location	string		Wilayah Azure tempat sumber daya yang dipesan berada.
properties.appliedScopeType	AppliedScopeType		Jenis Cakupan yang Diterapkan.
properties.appliedScopes	string[]		Daftar langganan yang akan diterapkan manfaatnya. Jangan tentukan apakah AppliedScopeType dibagikan.
properties.billingPlan	ReservationBillingPlan		Mewakili paket penagihan.
properties.billingScopeId	string		Langganan yang akan dikenakan biaya untuk membeli Reservasi
properties.displayName	string		Nama reservasi yang mudah diingat
properties.instanceFlexibility	InstanceFlexibility		Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
properties.quantity	integer		Kuantitas SKU yang merupakan bagian dari Reservasi. Harus lebih besar dari nol.
properties.renew	boolean	False	Mengatur ini ke true akan secara otomatis membeli reservasi baru pada tanggal kedaluwarsa.
properties.reservedResourceProperties	ReservedResourceProperties		Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.
properties.reservedResourceType	ReservedResourceType		Jenis sumber daya yang sedang dicadangkan.
properties.term	ReservationTerm		Mewakili jangka waktu Reservasi.
sku	SkuName

RenewPropertiesResponse

Name	Type	Description
billingCurrencyTotal	BillingCurrencyTotal	Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk.
pricingCurrencyTotal	PricingCurrencyTotal	Jumlah yang digunakan Microsoft untuk rekaman. Digunakan selama pengembalian dana untuk menghitung batas pengembalian dana. Pajak tidak termasuk. Ini adalah harga terkunci 30 hari sebelum kedaluwarsa.
purchaseProperties	PurchaseRequest

ReservationBillingPlan

Mewakili paket penagihan.

Name	Type	Description
Monthly	string
Upfront	string

ReservationMergeProperties

Name	Type	Description
mergeDestination	string	Id Sumber Daya Reservasi Dibuat karena penggabungan. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	Id Sumber Daya dari Reservasi Sumber digabungkan untuk membentuk Reservasi ini. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationOrderBillingPlanInformation

Informasi yang menjelaskan jenis paket penagihan untuk reservasi ini.

Name	Type	Description
nextPaymentDueDate	string	Untuk paket penagihan berulang, menunjukkan tanggal kapan pembayaran berikutnya akan diproses. Null ketika total dilunasi.
pricingCurrencyTotal	Price	Jumlah uang yang harus dibayarkan untuk Pesanan. Pajak tidak termasuk.
startDate	string	Tanggal saat paket penagihan telah dimulai.
transactions	PaymentDetail[]	Informasi tentang pembayaran yang terkait dengan pesanan reservasi.

ReservationOrderResponse

Name	Type	Description
etag	integer
id	string	Pengidentifikasi reservasi
name	string	Nama reservasi
properties.benefitStartTime	string	Ini adalah DateTime ketika manfaat reservasi dimulai.
properties.billingPlan	ReservationBillingPlan	Mewakili paket penagihan.
properties.createdDateTime	string	Ini adalah DateTime ketika reservasi dibuat.
properties.displayName	string	Nama yang mudah diingat bagi pengguna untuk dengan mudah mengidentifikasi reservasi.
properties.expiryDate	string	Ini adalah tanggal ketika Reservasi akan kedaluwarsa.
properties.originalQuantity	integer	Kuantitas SKU yang merupakan bagian dari Reservasi. Harus lebih besar dari nol.
properties.planInformation	ReservationOrderBillingPlanInformation	Informasi yang menjelaskan jenis paket penagihan untuk reservasi ini.
properties.provisioningState	string	Status reservasi saat ini.
properties.requestDateTime	string	Ini adalah DateTime ketika reservasi awalnya diminta untuk dibeli.
properties.reservations	ReservationResponse[]
properties.term	ReservationTerm	Mewakili jangka waktu Reservasi.
type	string	Jenis sumber daya. "Microsoft.Capacity/reservations"

ReservationProperties

Name	Type	Default Value	Description
appliedScopeProperties	AppliedScopeProperties
appliedScopeType	AppliedScopeType		Jenis Cakupan yang Diterapkan.
appliedScopes	string[]		Daftar langganan yang akan diterapkan manfaatnya. Jangan tentukan apakah AppliedScopeType dibagikan.
archived	boolean		Properti untuk menentukan apakah reservasi diarsipkan atau tidak
benefitStartTime	string		Ini adalah DateTime ketika manfaat reservasi dimulai.
billingPlan	ReservationBillingPlan		Mewakili paket penagihan.
billingScopeId	string		Langganan yang akan dikenakan biaya untuk membeli Reservasi
capabilities	string		Mencantumkan Kemampuan reservasi
displayName	string		Nama yang mudah diingat bagi pengguna untuk mengidentifikasi reservasi dengan mudah
effectiveDateTime	string		TanggalWaktu Reservasi dimulai saat versi ini berlaku.
expiryDate	string		Ini adalah tanggal ketika Reservasi akan kedaluwarsa.
extendedStatusInfo	ExtendedStatusInfo
instanceFlexibility	InstanceFlexibility		Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
lastUpdatedDateTime	string		DateTime terakhir kali Reservasi diperbarui.
mergeProperties	ReservationMergeProperties
provisioningState	string		Status reservasi saat ini.
quantity	integer		Kuantitas SKU yang merupakan bagian dari Reservasi. Harus lebih besar dari nol.
renew	boolean	False	Mengatur ini ke true akan secara otomatis membeli reservasi baru pada tanggal kedaluwarsa.
renewDestination	string		Id Reservasi reservasi yang dibeli karena perpanjangan. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse
renewSource	string		Id Reservasi reservasi tempat reservasi ini diperpanjang. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Jenis sumber daya yang sedang dicadangkan.
skuDescription	string		Deskripsi SKU dalam bahasa Inggris.
splitProperties	ReservationSplitProperties
swapProperties	ReservationSwapProperties
term	ReservationTerm		Mewakili jangka waktu Reservasi.

ReservationResponse

Name	Type	Description
etag	integer
id	string	Pengidentifikasi reservasi
location	string	Wilayah Azure tempat sumber daya yang dipesan berada.
name	string	Nama reservasi
properties	ReservationProperties
sku	SkuName
type	string	Jenis sumber daya. "Microsoft.Capacity/reservationOrders/reservations"

ReservationSplitProperties

Name	Type	Description
splitDestinations	string[]	Daftar Id Sumber Daya tujuan yang dibuat karena pemisahan. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	Id Sumber Daya Reservasi tempat ini dibagi. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationStatusCode

Name	Type	Description
Active	string
Expired	string
Merged	string
None	string
PaymentInstrumentError	string
Pending	string
PurchaseError	string
Split	string
Succeeded	string

ReservationSwapProperties

Name	Type	Description
swapDestination	string	Id Sumber Daya Reservasi tempat sumber daya asli ditukar. Format Id sumber daya adalah /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	ID Sumber Daya dari Reservasi Sumber yang ditukar. Format Id sumber daya adalah /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Mewakili jangka waktu Reservasi.

Name	Type	Description
P1Y	string
P3Y	string

ReservedResourceProperties

Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.

Name	Type	Description
instanceFlexibility	InstanceFlexibility	Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.

ReservedResourceType

Jenis sumber daya yang sedang dicadangkan.

Name	Type	Description
AppService	string
AzureDataExplorer	string
BlockBlob	string
CosmosDb	string
Databricks	string
DedicatedHost	string
ManagedDisk	string
MariaDb	string
MySql	string
PostgreSql	string
RedHat	string
RedHatOsa	string
RedisCache	string
SapHana	string
SqlAzureHybridBenefit	string
SqlDataWarehouse	string
SqlDatabases	string
SuseLinux	string
VMwareCloudSimple	string
VirtualMachines	string

SkuName

Name	Type	Description
name	string