Reservation Order - Calculate
Hitung harga untuk ReservationOrder
.
Hitung harga untuk menempatkan ReservationOrder
.
POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
api-version
|
query | True |
string |
Versi yang didukung. |
Isi Permintaan
Nama | Jenis | Deskripsi |
---|---|---|
location |
string |
Wilayah Azure tempat sumber daya yang dipesan berada. |
properties.appliedScopeProperties |
Properti khusus untuk jenis cakupan yang diterapkan. Tidak diperlukan jika tidak berlaku. Diperlukan dan perlu menyediakan tenantId dan managementGroupId jika AppliedScopeType adalah ManagementGroup |
|
properties.appliedScopeType |
Jenis Cakupan yang Diterapkan. |
|
properties.appliedScopes |
string[] |
Daftar langganan yang akan diterapkan manfaatnya. Jangan tentukan apakah AppliedScopeType dibagikan. Properti ini akan ditolak dan digantikan oleh appliedScopeProperties sebagai gantinya untuk Single AppliedScopeType. |
properties.billingPlan |
Mewakili paket penagihan. |
|
properties.billingScopeId |
string |
Langganan yang akan dikenakan untuk membeli reservasi atau paket penghematan |
properties.displayName |
string |
Nama reservasi yang mudah diingat |
properties.quantity |
integer |
Kuantitas sku yang merupakan bagian dari reservasi. |
properties.renew |
boolean |
Mengatur ini ke true akan secara otomatis membeli reservasi baru pada tanggal kedaluwarsa. |
properties.reservedResourceProperties |
Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku. |
|
properties.reservedResourceType |
Jenis sumber daya yang sedang dicadangkan. |
|
properties.reviewDateTime |
string |
Ini adalah tanggal-waktu ketika manfaat hibrid Azure perlu ditinjau. |
properties.term |
Mewakili jangka waktu reservasi. |
|
sku |
Nama sku |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Info harga terperinci untuk pembelian |
|
Other Status Codes |
Kesalahan tidak terduga |
Contoh
CalculatePrice
Sample Request
POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-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"
}
}
}
Sample Response
{
"properties": {
"billingCurrencyTotal": {
"currencyCode": "USD",
"amount": 46
},
"reservationOrderId": "6d9cec54-7de8-abcd-9de7-80f5d634f2d2",
"skuTitle": "Reserved VM Instance, Standard_D1, US West, 1 Year",
"skuDescription": "standard_D1",
"pricingCurrencyTotal": {
"currencyCode": "USD",
"amount": 46
},
"paymentSchedule": [
{
"dueDate": "2019-05-14",
"pricingCurrencyTotal": {
"currencyCode": "USD",
"amount": 46
},
"billingCurrencyTotal": {
"currencyCode": "EUR",
"amount": 40
}
},
{
"dueDate": "2019-06-14",
"pricingCurrencyTotal": {
"currencyCode": "USD",
"amount": 46
}
},
{
"dueDate": "2019-07-14",
"pricingCurrencyTotal": {
"currencyCode": "USD",
"amount": 46
}
}
]
}
}
Definisi
Nama | Deskripsi |
---|---|
Applied |
Properti khusus untuk jenis cakupan yang diterapkan. Tidak diperlukan jika tidak berlaku. Diperlukan dan perlu menyediakan tenantId dan managementGroupId jika AppliedScopeType adalah ManagementGroup |
Applied |
Jenis Cakupan yang Diterapkan. |
Billing |
Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk. |
Calculate |
Respons menghitung harga untuk reservasi. |
Calculate |
Properti untuk menghitung respons harga |
Error |
Informasi kesalahan |
Error |
Kode kesalahan yang menjelaskan alasan layanan tidak dapat memproses permintaan masuk |
Extended |
Informasi kesalahan yang diperluas termasuk kode kesalahan dan pesan kesalahan |
Extended |
|
Instance |
Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines. |
Payment |
Informasi tentang pembayaran yang terkait dengan pesanan reservasi. |
Payment |
Menjelaskan apakah pembayaran selesai, gagal, dibatalkan, atau dijadwalkan di masa mendatang. |
Price |
Informasi harga yang berisi jumlah dan kode mata uang |
Pricing |
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. |
Purchase |
Permintaan untuk pembelian reservasi |
Reservation |
Mewakili paket penagihan. |
Reservation |
|
Reservation |
Mewakili jangka waktu reservasi. |
Reserved |
Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku. |
Reserved |
Jenis sumber daya yang sedang dicadangkan. |
Sku |
Nama sku |
AppliedScopeProperties
Properti khusus untuk jenis cakupan yang diterapkan. Tidak diperlukan jika tidak berlaku. Diperlukan dan perlu menyediakan tenantId dan managementGroupId jika AppliedScopeType adalah ManagementGroup
Nama | Jenis | Deskripsi |
---|---|---|
displayName |
string |
Nama tampilan |
managementGroupId |
string |
Pengidentifikasi grup manajemen yang sepenuhnya memenuhi syarat di mana manfaat harus diterapkan. |
resourceGroupId |
string |
Pengidentifikasi grup sumber daya yang sepenuhnya memenuhi syarat. |
subscriptionId |
string |
Pengidentifikasi langganan yang sepenuhnya memenuhi syarat. |
tenantId |
string |
ID penyewa tempat paket penghematan harus menerapkan manfaat. |
AppliedScopeType
Jenis Cakupan yang Diterapkan.
Nama | Jenis | Deskripsi |
---|---|---|
ManagementGroup |
string |
|
Shared |
string |
|
Single |
string |
BillingCurrencyTotal
Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk.
Nama | Jenis | Deskripsi |
---|---|---|
amount |
number |
|
currencyCode |
string |
Kode mata uang ISO 4217 3 huruf untuk mata uang yang digunakan oleh catatan pembelian ini. |
CalculatePriceResponse
Respons menghitung harga untuk reservasi.
Nama | Jenis | Deskripsi |
---|---|---|
properties |
Properti untuk menghitung respons harga |
CalculatePriceResponseProperties
Properti untuk menghitung respons harga
Nama | Jenis | Deskripsi |
---|---|---|
billingCurrencyTotal |
Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan. Pajak tidak termasuk. |
|
grandTotal |
number |
Jumlah total dalam mata uang harga. |
isBillingPartnerManaged |
boolean |
Benar jika penagihan dikelola oleh Mitra Microsoft. Hanya digunakan untuk akun CSP. |
isTaxIncluded |
boolean |
Apakah pajak termasuk dalam total keseluruhan atau tidak |
netTotal |
number |
Jumlah total bersih dalam mata uang harga. |
paymentSchedule |
Informasi tentang pembayaran yang terkait dengan pesanan reservasi. |
|
pricingCurrencyTotal |
Jumlah yang digunakan Microsoft untuk rekaman. Digunakan selama pengembalian dana untuk menghitung batas pengembalian dana. Pajak tidak termasuk. |
|
reservationOrderId |
string |
GUID yang mewakili pesanan reservasi yang dapat ditempatkan setelah menghitung harga. |
skuDescription |
string |
Deskripsi sku yang sedang dibeli. |
skuTitle |
string |
Judul sku yang sedang dibeli. |
taxTotal |
number |
Jumlah pajak dalam mata uang harga. |
Error
Informasi kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
error |
Informasi kesalahan yang diperluas termasuk kode kesalahan dan pesan kesalahan |
ErrorResponseCode
Kode kesalahan yang menjelaskan alasan layanan tidak dapat memproses permintaan masuk
Nama | Jenis | Deskripsi |
---|---|---|
ActivateQuoteFailed |
string |
|
AppliedScopesNotAssociatedWithCommerceAccount |
string |
|
AppliedScopesSameAsExisting |
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 |
|
RefundLimitExceeded |
string |
|
ReservationIdNotInReservationOrder |
string |
|
ReservationOrderCreationFailed |
string |
|
ReservationOrderIdAlreadyExists |
string |
|
ReservationOrderNotEnabled |
string |
|
ReservationOrderNotFound |
string |
|
RiskCheckFailed |
string |
|
RoleAssignmentCreationFailed |
string |
|
SelfServiceRefundNotSupported |
string |
|
ServerTimeout |
string |
|
UnauthenticatedRequestsThrottled |
string |
|
UnsupportedReservationTerm |
string |
ExtendedErrorInfo
Informasi kesalahan yang diperluas termasuk kode kesalahan dan pesan kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
code |
Kode kesalahan yang menjelaskan alasan layanan tidak dapat memproses permintaan masuk |
|
message |
string |
ExtendedStatusInfo
Nama | Jenis | Deskripsi |
---|---|---|
message |
string |
Pesan yang memberikan informasi terperinci tentang kode status. |
statusCode |
InstanceFlexibility
Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
Nama | Jenis | Deskripsi |
---|---|---|
Off |
string |
|
On |
string |
PaymentDetail
Informasi tentang pembayaran yang terkait dengan pesanan reservasi.
Nama | Jenis | Deskripsi |
---|---|---|
billingAccount |
string |
Menampilkan Akun yang ditagih untuk pembayaran ini. |
billingCurrencyTotal |
Jumlah yang dibebankan dalam mata uang Penagihan. Pajak tidak termasuk. Null untuk pembayaran di masa mendatang |
|
dueDate |
string |
Tanggal pembayaran perlu dilakukan. |
extendedStatusInfo | ||
paymentDate |
string |
Tanggal ketika transaksi selesai. Null ketika dijadwalkan. |
pricingCurrencyTotal |
Jumlah dalam mata uang harga. Pajak tidak termasuk. |
|
status |
Menjelaskan apakah pembayaran selesai, gagal, dibatalkan, atau dijadwalkan di masa mendatang. |
PaymentStatus
Menjelaskan apakah pembayaran selesai, gagal, dibatalkan, atau dijadwalkan di masa mendatang.
Nama | Jenis | Deskripsi |
---|---|---|
Cancelled |
string |
|
Failed |
string |
|
Scheduled |
string |
|
Succeeded |
string |
Price
Informasi harga yang berisi jumlah dan kode mata uang
Nama | Jenis | Deskripsi |
---|---|---|
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.
Nama | Jenis | Deskripsi |
---|---|---|
amount |
number |
|
currencyCode |
string |
Kode mata uang ISO 4217 3 huruf untuk mata uang yang digunakan oleh catatan pembelian ini. |
PurchaseRequest
Permintaan untuk pembelian reservasi
Nama | Jenis | Nilai Default | Deskripsi |
---|---|---|---|
location |
string |
Wilayah Azure tempat sumber daya yang dipesan berada. |
|
properties.appliedScopeProperties |
Properti khusus untuk jenis cakupan yang diterapkan. Tidak diperlukan jika tidak berlaku. Diperlukan dan perlu menyediakan tenantId dan managementGroupId jika AppliedScopeType adalah ManagementGroup |
||
properties.appliedScopeType |
Jenis Cakupan yang Diterapkan. |
||
properties.appliedScopes |
string[] |
Daftar langganan yang akan diterapkan manfaatnya. Jangan tentukan apakah AppliedScopeType dibagikan. Properti ini akan ditolak dan digantikan oleh appliedScopeProperties sebagai gantinya untuk Single AppliedScopeType. |
|
properties.billingPlan |
Mewakili paket penagihan. |
||
properties.billingScopeId |
string |
Langganan yang akan dikenakan untuk membeli reservasi atau paket penghematan |
|
properties.displayName |
string |
Nama reservasi yang mudah diingat |
|
properties.quantity |
integer |
Kuantitas sku yang merupakan bagian dari reservasi. |
|
properties.renew |
boolean |
False |
Mengatur ini ke true akan secara otomatis membeli reservasi baru pada tanggal kedaluwarsa. |
properties.reservedResourceProperties |
Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku. |
||
properties.reservedResourceType |
Jenis sumber daya yang sedang dicadangkan. |
||
properties.reviewDateTime |
string |
Ini adalah tanggal-waktu ketika manfaat hibrid Azure perlu ditinjau. |
|
properties.term |
Mewakili jangka waktu reservasi. |
||
sku |
Nama sku |
ReservationBillingPlan
Mewakili paket penagihan.
Nama | Jenis | Deskripsi |
---|---|---|
Monthly |
string |
|
Upfront |
string |
ReservationStatusCode
Nama | Jenis | Deskripsi |
---|---|---|
Active |
string |
|
Expired |
string |
|
Merged |
string |
|
None |
string |
|
PaymentInstrumentError |
string |
|
Pending |
string |
|
Processing |
string |
|
PurchaseError |
string |
|
Split |
string |
|
Succeeded |
string |
ReservationTerm
Mewakili jangka waktu reservasi.
Nama | Jenis | Deskripsi |
---|---|---|
P1Y |
string |
|
P3Y |
string |
|
P5Y |
string |
ReservedResourceProperties
Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.
Nama | Jenis | Deskripsi |
---|---|---|
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.
Nama | Jenis | Deskripsi |
---|---|---|
AVS |
string |
|
AppService |
string |
|
AzureDataExplorer |
string |
|
AzureFiles |
string |
|
BlockBlob |
string |
|
CosmosDb |
string |
|
DataFactory |
string |
|
Databricks |
string |
|
DedicatedHost |
string |
|
ManagedDisk |
string |
|
MariaDb |
string |
|
MySql |
string |
|
NetAppStorage |
string |
|
PostgreSql |
string |
|
RedHat |
string |
|
RedHatOsa |
string |
|
RedisCache |
string |
|
SapHana |
string |
|
SqlAzureHybridBenefit |
string |
|
SqlDataWarehouse |
string |
|
SqlDatabases |
string |
|
SqlEdge |
string |
|
SuseLinux |
string |
|
VMwareCloudSimple |
string |
|
VirtualMachineSoftware |
string |
|
VirtualMachines |
string |
SkuName
Nama sku
Nama | Jenis | Deskripsi |
---|---|---|
name |
string |