Share via


Reservation Order - Calculate

değerinin ReservationOrderfiyatını hesaplayın.
Bir ReservationOrderyerleş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

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

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

ReservationBillingPlan

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

ReservedResourceProperties

Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.

properties.reservedResourceType

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

ReservationTerm

Rezervasyon terimini temsil edin.

sku

SkuName

SKU'nun adı

Yanıtlar

Name Tür Description
200 OK

CalculatePriceResponse

Satın alma için ayrıntılı fiyat bilgileri ReservationOrder

Other Status Codes

Error

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
AppliedScopeProperties

Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor

AppliedScopeType

Uygulanan Kapsamın türü.

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.

CalculatePriceResponse

Rezervasyonun fiyatını hesaplama yanıtı.

CalculatePriceResponseProperties

Fiyat yanıtı hesaplama özellikleri

Error

Hata bilgileri

ErrorResponseCode

Hizmetin gelen isteği işleyememe nedenini açıklayan hata kodu

ExtendedErrorInfo

Hata kodu ve hata iletisi de dahil olmak üzere genişletilmiş hata bilgileri

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

PaymentDetail

Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler.

PaymentStatus

Ö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

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.

PurchaseRequest

Rezervasyon satın alma isteği

ReservationBillingPlan

Faturalama planlarını temsil edin.

ReservationStatusCode
ReservationTerm

Rezervasyon terimini temsil edin.

ReservedResourceProperties

Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.

ReservedResourceType

Ayrılmış kaynağın türü.

SkuName

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

CalculatePriceResponseProperties

Fiyat yanıtı hesaplama özellikleri

CalculatePriceResponseProperties

Fiyat yanıtı hesaplama özellikleri

Name Tür Description
billingCurrencyTotal

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

PaymentDetail[]

Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler.

pricingCurrencyTotal

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

ExtendedErrorInfo

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

ErrorResponseCode

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

ReservationStatusCode

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

Price

Faturalama para birimi cinsinden ücretlendirilen tutar. Vergi dahil değildir. Gelecekteki ödemeler için null

dueDate

string

Ödemenin yapılması gereken tarih.

extendedStatusInfo

ExtendedStatusInfo

paymentDate

string

İşlemin tamamlandığı tarih. Zamanlandığında null olur.

pricingCurrencyTotal

Price

Fiyatlandırma para birimi cinsinden tutar. Vergi dahil değildir.

status

PaymentStatus

Ö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

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

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

ReservationBillingPlan

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

ReservedResourceProperties

Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.

properties.reservedResourceType

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

ReservationTerm

Rezervasyon terimini temsil edin.

sku

SkuName

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

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