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 |
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 |
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 |
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 |
Vlastnosti specifické pro každý rezervovaný typ prostředku. Nepožaduje se, pokud není k dispozici. |
|
properties.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 |
Představuje dobu rezervace. |
|
sku |
Název skladové položky |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Podrobné informace o cenách pro nákup |
|
Other Status Codes |
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 |
---|---|
Applied |
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. |
Applied |
Typ použitého oboru. |
Billing |
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. |
Calculate |
Odpověď na počítanou cenu rezervace. |
Calculate |
Vlastnosti pro odpověď na výpočet ceny |
Error |
Informace o chybě |
Error |
Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek |
Extended |
Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy |
Extended |
|
Instance |
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. |
Payment |
Informace o platbě související s objednávkou rezervace. |
Payment |
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 |
Pricing |
Čá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. |
Purchase |
Žádost o nákup rezervace |
Reservation |
Představuje fakturační plány. |
Reservation |
|
Reservation |
Představuje dobu rezervace. |
Reserved |
Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici. |
Reserved |
Typ prostředku, který je rezervován. |
Sku |
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 |
Vlastnosti pro odpověď na výpočet ceny |
CalculatePriceResponseProperties
Vlastnosti pro odpověď na výpočet ceny
Name | Typ | Description |
---|---|---|
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 |
Informace o platbě související s objednávkou rezervace. |
|
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 |
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 |
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 |
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 |
Úč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 | ||
paymentDate |
string |
Datum, kdy je transakce dokončena. Má hodnotu null, pokud je naplánovaná. |
pricingCurrencyTotal |
Částka v cenové měně. Daň není zahrnuta. |
|
status |
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 |
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 |
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 |
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 |
Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici. |
||
properties.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 |
Představuje dobu rezervace. |
||
sku |
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 |
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 |