Bagikan melalui


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

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

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

ReservationBillingPlan

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

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.reviewDateTime

string

Ini adalah tanggal-waktu ketika manfaat hibrid Azure perlu ditinjau.

properties.term

ReservationTerm

Mewakili jangka waktu reservasi.

sku

SkuName

Nama sku

Respons

Nama Jenis Deskripsi
200 OK

CalculatePriceResponse

Info harga terperinci untuk pembelian ReservationOrder

Other Status Codes

Error

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
AppliedScopeProperties

Properti khusus untuk jenis cakupan yang diterapkan. Tidak diperlukan jika tidak berlaku. Diperlukan dan perlu menyediakan tenantId dan managementGroupId jika AppliedScopeType adalah ManagementGroup

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.

CalculatePriceResponse

Respons menghitung harga untuk reservasi.

CalculatePriceResponseProperties

Properti untuk menghitung respons harga

Error

Informasi kesalahan

ErrorResponseCode

Kode kesalahan yang menjelaskan alasan layanan tidak dapat memproses permintaan masuk

ExtendedErrorInfo

Informasi kesalahan yang diperluas termasuk kode kesalahan dan pesan kesalahan

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

Informasi harga yang berisi jumlah dan kode mata uang

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

Permintaan untuk pembelian reservasi

ReservationBillingPlan

Mewakili paket penagihan.

ReservationStatusCode
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

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

CalculatePriceResponseProperties

Properti untuk menghitung respons harga

CalculatePriceResponseProperties

Properti untuk menghitung respons harga

Nama Jenis Deskripsi
billingCurrencyTotal

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

PaymentDetail[]

Informasi tentang pembayaran yang terkait dengan pesanan reservasi.

pricingCurrencyTotal

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

ExtendedErrorInfo

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

ErrorResponseCode

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

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.

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

Price

Jumlah yang dibebankan dalam mata uang Penagihan. Pajak tidak termasuk. Null untuk pembayaran di masa mendatang

dueDate

string

Tanggal 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.

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

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

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

ReservationBillingPlan

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

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.reviewDateTime

string

Ini adalah tanggal-waktu ketika manfaat hibrid Azure perlu ditinjau.

properties.term

ReservationTerm

Mewakili jangka waktu reservasi.

sku

SkuName

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

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