Sdílet prostřednictvím


Reservation Order - Calculate

Výpočet ceny pro ReservationOrder.
Vypočítejte cenu pro umístění .ReservationOrder

POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
api-version
query True

string

Podporovaná verze.

Text požadavku

Name Typ Description
location

string

Oblast Azure, ve které se nachází rezervovaný prostředek.

properties.appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Nepožaduje se, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup

properties.appliedScopeType

AppliedScopeType

Typ použitého oboru.

properties.appliedScopes

string[]

Seznam předplatných, na která se výhoda použije. Nezadávejte, jestli je AppliedScopeType shared. Tato vlastnost bude vyřazena a nahrazena appliedScopeProperties místo pro Single AppliedScopeType.

properties.billingPlan

ReservationBillingPlan

Představuje fakturační plány.

properties.billingScopeId

string

Předplatné, které se bude účtovat za nákup rezervace nebo úspory

properties.displayName

string

Popisný název rezervace

properties.quantity

integer

Množství skladových položek, které jsou součástí rezervace.

properties.renew

boolean

Pokud tuto hodnotu nastavíte na hodnotu true, automaticky si koupíte novou rezervaci k datu vypršení platnosti.

properties.reservedResourceProperties

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Nepožaduje se, pokud není k dispozici.

properties.reservedResourceType

ReservedResourceType

Typ prostředku, který je rezervován.

properties.reviewDateTime

string

Toto je datum a čas, kdy je potřeba zkontrolovat zvýhodněné hybridní využití Azure.

properties.term

ReservationTerm

Představuje dobu rezervace.

sku

SkuName

Název skladové položky

Odpovědi

Name Typ Description
200 OK

CalculatePriceResponse

Podrobné informace o cenách pro nákup ReservationOrder

Other Status Codes

Error

Neočekávaná chyba

Příklady

CalculatePrice

Ukázkový požadavek

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"
    }
  }
}

Ukázková odpověď

{
  "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
        }
      }
    ]
  }
}

Definice

Name Description
AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

AppliedScopeType

Typ použitého oboru.

BillingCurrencyTotal

Měna a částka, které budou zákazníkovi účtovány v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.

CalculatePriceResponse

Odpověď na počítanou cenu rezervace.

CalculatePriceResponseProperties

Vlastnosti pro odpověď na výpočet ceny

Error

Informace o chybě

ErrorResponseCode

Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek

ExtendedErrorInfo

Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

ExtendedStatusInfo
InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

PaymentDetail

Informace o platbě související s objednávkou rezervace.

PaymentStatus

Popisuje, jestli je platba dokončená, neúspěšná, zrušená nebo naplánovaná v budoucnu.

Price

Informace o cenách obsahující částku a kód měny

PricingCurrencyTotal

Částka, kterou Microsoft používá k záznamu. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.

PurchaseRequest

Žádost o nákup rezervace

ReservationBillingPlan

Představuje fakturační plány.

ReservationStatusCode
ReservationTerm

Představuje dobu rezervace.

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici.

ReservedResourceType

Typ prostředku, který je rezervován.

SkuName

Název skladové položky

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

Name Typ Description
displayName

string

Zobrazované jméno

managementGroupId

string

Plně kvalifikovaný identifikátor skupiny pro správu, ve které musí být výhoda uplatněna.

resourceGroupId

string

Plně kvalifikovaný identifikátor skupiny prostředků.

subscriptionId

string

Plně kvalifikovaný identifikátor předplatného.

tenantId

string

ID tenanta, u kterého by plán úspory měl použít výhodu

AppliedScopeType

Typ použitého oboru.

Name Typ Description
ManagementGroup

string

Shared

string

Single

string

BillingCurrencyTotal

Měna a částka, které budou zákazníkovi účtovány v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.

Name Typ Description
amount

number

currencyCode

string

3písmenný kód měny ISO 4217 pro měnu používanou tímto záznamem o nákupu.

CalculatePriceResponse

Odpověď na počítanou cenu rezervace.

Name Typ Description
properties

CalculatePriceResponseProperties

Vlastnosti pro odpověď na výpočet ceny

CalculatePriceResponseProperties

Vlastnosti pro odpověď na výpočet ceny

Name Typ Description
billingCurrencyTotal

BillingCurrencyTotal

Měna a částka, která bude zákazníkovi účtována v místní měně zákazníka. Daň není zahrnuta.

grandTotal

number

Celková částka v měně s cenami.

isBillingPartnerManaged

boolean

Hodnota True, pokud fakturaci spravuje partner Microsoftu. Používá se pouze pro účty CSP.

isTaxIncluded

boolean

Zda je daň zahrnuta do celkového součtu

netTotal

number

Čistá celková částka v cenové měně.

paymentSchedule

PaymentDetail[]

Informace o platbě související s objednávkou rezervace.

pricingCurrencyTotal

PricingCurrencyTotal

Částka, kterou Microsoft používá k záznamu. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta.

reservationOrderId

string

Identifikátor GUID představující objednávku rezervace, kterou je možné zadat po výpočtu ceny.

skuDescription

string

Popis kupované skladové položky

skuTitle

string

Název kupované skladové položky

taxTotal

number

Částka daně v cenové měně.

Error

Informace o chybě

Name Typ Description
error

ExtendedErrorInfo

Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

ErrorResponseCode

Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek

Name Typ 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

Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

Name Typ Description
code

ErrorResponseCode

Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek

message

string

ExtendedStatusInfo

Name Typ Description
message

string

Zpráva s podrobnými informacemi o stavovém kódu.

statusCode

ReservationStatusCode

InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

Name Typ Description
Off

string

On

string

PaymentDetail

Informace o platbě související s objednávkou rezervace.

Name Typ Description
billingAccount

string

Zobrazuje účet, kterému se tato platba naúčtuje.

billingCurrencyTotal

Price

Účtovaná částka ve fakturační měně. Daň není zahrnuta. Je null pro budoucí platby

dueDate

string

Datum, kdy je potřeba provést platbu.

extendedStatusInfo

ExtendedStatusInfo

paymentDate

string

Datum, kdy je transakce dokončena. Má hodnotu null, pokud je naplánovaná.

pricingCurrencyTotal

Price

Částka v cenové měně. Daň není zahrnuta.

status

PaymentStatus

Popisuje, jestli je platba dokončená, neúspěšná, zrušená nebo naplánovaná v budoucnu.

PaymentStatus

Popisuje, jestli je platba dokončená, neúspěšná, zrušená nebo naplánovaná v budoucnu.

Name Typ Description
Cancelled

string

Failed

string

Scheduled

string

Succeeded

string

Price

Informace o cenách obsahující částku a kód měny

Name Typ Description
amount

number

currencyCode

string

3písmenný kód měny ISO 4217 pro měnu používanou tímto záznamem o nákupu.

PricingCurrencyTotal

Částka, kterou Microsoft používá k záznamu. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.

Name Typ Description
amount

number

currencyCode

string

3písmenný kód měny ISO 4217 pro měnu používanou tímto záznamem o nákupu.

PurchaseRequest

Žádost o nákup rezervace

Name Typ Default value Description
location

string

Oblast Azure, ve které se nachází rezervovaný prostředek.

properties.appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

properties.appliedScopeType

AppliedScopeType

Typ použitého oboru.

properties.appliedScopes

string[]

Seznam předplatných, na která se výhoda použije. Nezadávejte, jestli je AppliedScopeType shared. Tato vlastnost bude vyřazena a nahrazena appliedScopeProperties místo pro Single AppliedScopeType.

properties.billingPlan

ReservationBillingPlan

Představuje fakturační plány.

properties.billingScopeId

string

Předplatné, které se bude účtovat za nákup rezervace nebo úspory

properties.displayName

string

Popisný název rezervace

properties.quantity

integer

Množství skladových položek, které jsou součástí rezervace.

properties.renew

boolean

False

Pokud tuto hodnotu nastavíte na true, automaticky se k datu vypršení platnosti zakoupí nová rezervace.

properties.reservedResourceProperties

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici.

properties.reservedResourceType

ReservedResourceType

Typ prostředku, který je rezervován.

properties.reviewDateTime

string

Jedná se o datum a čas, kdy je potřeba zkontrolovat Zvýhodněné hybridní využití Azure.

properties.term

ReservationTerm

Představuje dobu rezervace.

sku

SkuName

Název skladové položky

ReservationBillingPlan

Představuje fakturační plány.

Name Typ Description
Monthly

string

Upfront

string

ReservationStatusCode

Name Typ Description
Active

string

Expired

string

Merged

string

None

string

PaymentInstrumentError

string

Pending

string

Processing

string

PurchaseError

string

Split

string

Succeeded

string

ReservationTerm

Představuje dobu rezervace.

Name Typ Description
P1Y

string

P3Y

string

P5Y

string

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici.

Name Typ Description
instanceFlexibility

InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

ReservedResourceType

Typ prostředku, který je rezervován.

Name Typ 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

Název skladové položky

Name Typ Description
name

string