Reservation Order - Calculate
değerinin ReservationOrder
fiyatını hesaplayın.
Bir ReservationOrder
yerleştirmek için fiyatı hesaplayın.
POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Desteklenen sürüm. |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
location |
string |
Ayrılmış kaynağın bulunduğu Azure bölgesi. |
properties.appliedScopeProperties |
Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor |
|
properties.appliedScopeType |
Uygulanan Kapsamın türü. |
|
properties.appliedScopes |
string[] |
Avantajın uygulanacağı aboneliklerin listesi. AppliedScopeType öğesinin Shared olup olmadığını belirtmeyin. Bu özellik, Single AppliedScopeType yerine appliedScopeProperties tarafından kullanım dışı bırakılacak ve değiştirilecektir. |
properties.billingPlan |
Faturalama planlarını temsil edin. |
|
properties.billingScopeId |
string |
Rezervasyon veya tasarruf planı satın almak için ücretlendirilecek abonelik |
properties.displayName |
string |
Rezervasyonun kolay adı |
properties.quantity |
integer |
Rezervasyonun parçası olan sku'ların miktarı. |
properties.renew |
boolean |
Bunu true olarak ayarlamak, son kullanma tarihi saatinde otomatik olarak yeni bir rezervasyon satın alır. |
properties.reservedResourceProperties |
Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir. |
|
properties.reservedResourceType |
Ayrılmış kaynağın türü. |
|
properties.reviewDateTime |
string |
Bu, Azure hibrit avantajının gözden geçirilmesi gereken tarih saatidir. |
properties.term |
Rezervasyon terimini temsil edin. |
|
sku |
SKU'nun adı |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Satın alma için ayrıntılı fiyat bilgileri |
|
Other Status Codes |
Beklenmeyen hata |
Örnekler
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
}
}
]
}
}
Tanımlar
Name | Description |
---|---|
Applied |
Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor |
Applied |
Uygulanan Kapsamın türü. |
Billing |
Yenileme satın alma işlemi için müşterinin yerel para birimi cinsinden tahsil edilecek para birimi ve tutar. Vergi dahil değildir. |
Calculate |
Rezervasyonun fiyatını hesaplama yanıtı. |
Calculate |
Fiyat yanıtı hesaplama özellikleri |
Error |
Hata bilgileri |
Error |
Hizmetin gelen isteği işleyememe nedenini açıklayan hata kodu |
Extended |
Hata kodu ve hata iletisi de dahil olmak üzere genişletilmiş hata bilgileri |
Extended |
|
Instance |
Bunu açmak, rezervasyon indirimini aynı VM boyut grubundaki diğer VM'lere uygular. Yalnızca VirtualMachines ayrılmış kaynak türü için belirtin. |
Payment |
Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler. |
Payment |
Ödemenin tamamlanıp tamamlanmadığını, başarısız olduğunu, iptal edilip edilmediğini veya gelecekte zamanlandığını açıklar. |
Price |
Tutarı ve para birimi kodunu içeren fiyatlandırma bilgileri |
Pricing |
Microsoft'un kayıt için kullandığı tutar. Para iadesi limitini hesaplamak için para iadesi sırasında kullanılır. Vergi dahil değildir. Bu, süresi dolmadan 30 gün önce kilitlenmiş fiyattır. |
Purchase |
Rezervasyon satın alma isteği |
Reservation |
Faturalama planlarını temsil edin. |
Reservation |
|
Reservation |
Rezervasyon terimini temsil edin. |
Reserved |
Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir. |
Reserved |
Ayrılmış kaynağın türü. |
Sku |
SKU'nun adı |
AppliedScopeProperties
Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor
Name | Tür | Description |
---|---|---|
displayName |
string |
Görünen ad |
managementGroupId |
string |
Avantajın uygulanması gereken yönetim grubunun tam tanımlayıcısı. |
resourceGroupId |
string |
Kaynak grubunun tam tanımlayıcısı. |
subscriptionId |
string |
Aboneliğin tam tanımlayıcısı. |
tenantId |
string |
Tasarruf planının avantajı uygulaması gereken Kiracı Kimliği. |
AppliedScopeType
Uygulanan Kapsamın türü.
Name | Tür | Description |
---|---|---|
ManagementGroup |
string |
|
Shared |
string |
|
Single |
string |
BillingCurrencyTotal
Yenileme satın alma işlemi için müşterinin yerel para birimi cinsinden tahsil edilecek para birimi ve tutar. Vergi dahil değildir.
Name | Tür | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
Bu satın alma kaydı tarafından kullanılan para birimi için ISO 4217 3 harfli para birimi kodu. |
CalculatePriceResponse
Rezervasyonun fiyatını hesaplama yanıtı.
Name | Tür | Description |
---|---|---|
properties |
Fiyat yanıtı hesaplama özellikleri |
CalculatePriceResponseProperties
Fiyat yanıtı hesaplama özellikleri
Name | Tür | Description |
---|---|---|
billingCurrencyTotal |
Müşterinin yerel para birimi cinsinden ücretlendirileceği para birimi ve tutar. Vergi dahil değildir. |
|
grandTotal |
number |
Fiyatlandırma para birimi cinsinden toplam tutar. |
isBillingPartnerManaged |
boolean |
Faturalama Microsoft İş Ortağı tarafından yönetiliyorsa true. Yalnızca CSP hesapları için kullanılır. |
isTaxIncluded |
boolean |
Verginin genel toplama dahil olup olmadığı |
netTotal |
number |
Fiyatlandırma para birimi cinsinden net toplam tutar. |
paymentSchedule |
Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler. |
|
pricingCurrencyTotal |
Microsoft'un kayıt için kullandığı tutar. Para iadesi limitini hesaplamak için para iadesi sırasında kullanılır. Vergi dahil değildir. |
|
reservationOrderId |
string |
Fiyat hesaplandıktan sonra verilebilen rezervasyon siparişini temsil eden GUID. |
skuDescription |
string |
Satın alınan sku'nun açıklaması. |
skuTitle |
string |
Satın alınan sku'nun başlığı. |
taxTotal |
number |
Fiyatlandırma para birimi cinsinden vergi tutarı. |
Error
Hata bilgileri
Name | Tür | Description |
---|---|---|
error |
Hata kodu ve hata iletisi de dahil olmak üzere genişletilmiş hata bilgileri |
ErrorResponseCode
Hizmetin gelen isteği işleyememe nedenini açıklayan hata kodu
Name | Tür | Description |
---|---|---|
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
Hata kodu ve hata iletisi de dahil olmak üzere genişletilmiş hata bilgileri
Name | Tür | Description |
---|---|---|
code |
Hizmetin gelen isteği işleyememe nedenini açıklayan hata kodu |
|
message |
string |
ExtendedStatusInfo
Name | Tür | Description |
---|---|---|
message |
string |
Durum kodu hakkında ayrıntılı bilgi veren ileti. |
statusCode |
InstanceFlexibility
Bunu açmak, rezervasyon indirimini aynı VM boyut grubundaki diğer VM'lere uygular. Yalnızca VirtualMachines ayrılmış kaynak türü için belirtin.
Name | Tür | Description |
---|---|---|
Off |
string |
|
On |
string |
PaymentDetail
Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler.
Name | Tür | Description |
---|---|---|
billingAccount |
string |
Bu ödeme için ücretlendirilen Hesabı gösterir. |
billingCurrencyTotal |
Faturalama para birimi cinsinden ücretlendirilen tutar. Vergi dahil değildir. Gelecekteki ödemeler için null |
|
dueDate |
string |
Ödemenin yapılması gereken tarih. |
extendedStatusInfo | ||
paymentDate |
string |
İşlemin tamamlandığı tarih. Zamanlandığında null olur. |
pricingCurrencyTotal |
Fiyatlandırma para birimi cinsinden tutar. Vergi dahil değildir. |
|
status |
Ödemenin tamamlanıp tamamlanmadığını, başarısız olduğunu, iptal edilip edilmediğini veya gelecekte zamanlandığını açıklar. |
PaymentStatus
Ödemenin tamamlanıp tamamlanmadığını, başarısız olduğunu, iptal edilip edilmediğini veya gelecekte zamanlandığını açıklar.
Name | Tür | Description |
---|---|---|
Cancelled |
string |
|
Failed |
string |
|
Scheduled |
string |
|
Succeeded |
string |
Price
Tutarı ve para birimi kodunu içeren fiyatlandırma bilgileri
Name | Tür | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
Bu satın alma kaydı tarafından kullanılan para birimi için ISO 4217 3 harfli para birimi kodu. |
PricingCurrencyTotal
Microsoft'un kayıt için kullandığı tutar. Para iadesi limitini hesaplamak için para iadesi sırasında kullanılır. Vergi dahil değildir. Bu, süresi dolmadan 30 gün önce kilitlenmiş fiyattır.
Name | Tür | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
Bu satın alma kaydı tarafından kullanılan para birimi için ISO 4217 3 harfli para birimi kodu. |
PurchaseRequest
Rezervasyon satın alma isteği
Name | Tür | Varsayılan değer | Description |
---|---|---|---|
location |
string |
Ayrılmış kaynağın bulunduğu Azure bölgesi. |
|
properties.appliedScopeProperties |
Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor |
||
properties.appliedScopeType |
Uygulanan Kapsamın türü. |
||
properties.appliedScopes |
string[] |
Avantajın uygulanacağı aboneliklerin listesi. AppliedScopeType öğesinin Shared olup olmadığını belirtmeyin. Bu özellik, Single AppliedScopeType yerine appliedScopeProperties tarafından kullanım dışı bırakılacak ve değiştirilecektir. |
|
properties.billingPlan |
Faturalama planlarını temsil edin. |
||
properties.billingScopeId |
string |
Rezervasyon veya tasarruf planı satın almak için ücretlendirilecek abonelik |
|
properties.displayName |
string |
Rezervasyonun kolay adı |
|
properties.quantity |
integer |
Rezervasyonun parçası olan sku'ların miktarı. |
|
properties.renew |
boolean |
False |
Bunu true olarak ayarlamak, son kullanma tarihi saatinde otomatik olarak yeni bir rezervasyon satın alır. |
properties.reservedResourceProperties |
Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir. |
||
properties.reservedResourceType |
Ayrılmış kaynağın türü. |
||
properties.reviewDateTime |
string |
Bu, Azure hibrit avantajının gözden geçirilmesi gereken tarih saatidir. |
|
properties.term |
Rezervasyon terimini temsil edin. |
||
sku |
SKU'nun adı |
ReservationBillingPlan
Faturalama planlarını temsil edin.
Name | Tür | Description |
---|---|---|
Monthly |
string |
|
Upfront |
string |
ReservationStatusCode
Name | Tür | Description |
---|---|---|
Active |
string |
|
Expired |
string |
|
Merged |
string |
|
None |
string |
|
PaymentInstrumentError |
string |
|
Pending |
string |
|
Processing |
string |
|
PurchaseError |
string |
|
Split |
string |
|
Succeeded |
string |
ReservationTerm
Rezervasyon terimini temsil edin.
Name | Tür | Description |
---|---|---|
P1Y |
string |
|
P3Y |
string |
|
P5Y |
string |
ReservedResourceProperties
Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.
Name | Tür | Description |
---|---|---|
instanceFlexibility |
Bunu açmak, rezervasyon indirimini aynı VM boyut grubundaki diğer VM'lere uygular. Yalnızca VirtualMachines ayrılmış kaynak türü için belirtin. |
ReservedResourceType
Ayrılmış kaynağın türü.
Name | Tür | Description |
---|---|---|
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
SKU'nun adı
Name | Tür | Description |
---|---|---|
name |
string |