Reservation Order - Calculate
Beräkna priset för en ReservationOrder
.
Beräkna priset för att placera en ReservationOrder
.
POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Version som stöds. |
Begärandetext
Name | Typ | Description |
---|---|---|
location |
string |
Den Azure-region där den reserverade resursen finns. |
properties.appliedScopeProperties |
Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup |
|
properties.appliedScopeType |
Typ av tillämpat omfång. |
|
properties.appliedScopes |
string[] |
Lista över de prenumerationer som förmånen ska tillämpas på. Ange inte om AppliedScopeType är Delad. Den här egenskapen kommer att bli inaktuell och ersättas av appliedScopeProperties i stället för Single AppliedScopeType. |
properties.billingPlan |
Representera faktureringsplanerna. |
|
properties.billingScopeId |
string |
Prenumeration som debiteras för köp av reservation eller sparplan |
properties.displayName |
string |
Eget namn på reservationen |
properties.quantity |
integer |
Antal sku:er som ingår i reservationen. |
properties.renew |
boolean |
Om du ställer in detta på true köps automatiskt en ny reservation på förfallodatumtiden. |
properties.reservedResourceProperties |
Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt. |
|
properties.reservedResourceType |
Typen av resurs som reserveras. |
|
properties.reviewDateTime |
string |
Det här är den tidpunkt då Azure Hybrid-förmånen behöver granskas. |
properties.term |
Representerar reservationsperioden. |
|
sku |
Namnet på sku |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Detaljerad prisinformation för inköp |
|
Other Status Codes |
Oväntat fel |
Exempel
CalculatePrice
Exempelbegäran
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"
}
}
}
Exempelsvar
{
"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
}
}
]
}
}
Definitioner
Name | Description |
---|---|
Applied |
Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup |
Applied |
Typ av tillämpat omfång. |
Billing |
Valuta och belopp som kunden debiteras i kundens lokala valuta för förnyelseköp. Skatt ingår inte. |
Calculate |
Svaret för att beräkna priset för reservationen. |
Calculate |
Egenskaper för att beräkna prissvar |
Error |
Felinformation |
Error |
Felkod som beskriver orsaken till att tjänsten inte kan bearbeta den inkommande begäran |
Extended |
Utökad felinformation inklusive felkod och felmeddelande |
Extended |
|
Instance |
Om du aktiverar detta tillämpas reservationsrabatten på andra virtuella datorer i samma VM-storleksgrupp. Ange endast för reserverad resurstyp för VirtualMachines. |
Payment |
Information om betalning relaterad till en reservationsbeställning. |
Payment |
Beskriver om betalningen slutförs, misslyckas, avbryts eller schemaläggs i framtiden. |
Price |
Prisinformation som innehåller beloppet och valutakoden |
Pricing |
Belopp som Microsoft använder för posten. Används under återbetalning för att beräkna återbetalningsgränsen. Skatt ingår inte. Det här är låst pris 30 dagar innan det upphör att gälla. |
Purchase |
Begäran om reservationsköp |
Reservation |
Representera faktureringsplanerna. |
Reservation |
|
Reservation |
Representerar reservationsperioden. |
Reserved |
Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt. |
Reserved |
Typen av resurs som reserveras. |
Sku |
Namnet på sku |
AppliedScopeProperties
Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup
Name | Typ | Description |
---|---|---|
displayName |
string |
Visningsnamn |
managementGroupId |
string |
Fullständigt kvalificerad identifierare för den hanteringsgrupp där förmånen måste tillämpas. |
resourceGroupId |
string |
Fullständigt kvalificerad identifierare för resursgruppen. |
subscriptionId |
string |
Fullständigt kvalificerad identifierare för prenumerationen. |
tenantId |
string |
Klientorganisations-ID där sparplanen ska tillämpa förmånen. |
AppliedScopeType
Typ av tillämpat omfång.
Name | Typ | Description |
---|---|---|
ManagementGroup |
string |
|
Shared |
string |
|
Single |
string |
BillingCurrencyTotal
Valuta och belopp som kunden debiteras i kundens lokala valuta för förnyelseköp. Skatt ingår inte.
Name | Typ | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
ISO 4217 3-bokstavs valutakod för den valuta som används av den här inköpsposten. |
CalculatePriceResponse
Svaret för att beräkna priset för reservationen.
Name | Typ | Description |
---|---|---|
properties |
Egenskaper för att beräkna prissvar |
CalculatePriceResponseProperties
Egenskaper för att beräkna prissvar
Name | Typ | Description |
---|---|---|
billingCurrencyTotal |
Valuta och belopp som kunden debiteras i kundens lokala valuta. Skatt ingår inte. |
|
grandTotal |
number |
Totalt belopp i prisvaluta. |
isBillingPartnerManaged |
boolean |
Sant om faktureringen hanteras av Microsoft Partner. Används endast för CSP-konton. |
isTaxIncluded |
boolean |
Om skatt ingår i totalsumman eller inte |
netTotal |
number |
Totalt nettobelopp i prisvalutan. |
paymentSchedule |
Information om betalning relaterad till en reservationsbeställning. |
|
pricingCurrencyTotal |
Belopp som Microsoft använder för posten. Används under återbetalning för att beräkna återbetalningsgränsen. Skatt ingår inte. |
|
reservationOrderId |
string |
GUID som representerar reservationsbeställning som kan göras efter beräkning av priset. |
skuDescription |
string |
Beskrivning av den SKU som köps. |
skuTitle |
string |
Namn på den SKU som köps. |
taxTotal |
number |
Skattebelopp i prisvaluta. |
Error
Felinformation
Name | Typ | Description |
---|---|---|
error |
Utökad felinformation inklusive felkod och felmeddelande |
ErrorResponseCode
Felkod som beskriver orsaken till att tjänsten inte kan bearbeta den inkommande begäran
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
Utökad felinformation inklusive felkod och felmeddelande
Name | Typ | Description |
---|---|---|
code |
Felkod som beskriver orsaken till att tjänsten inte kan bearbeta den inkommande begäran |
|
message |
string |
ExtendedStatusInfo
Name | Typ | Description |
---|---|---|
message |
string |
Meddelandet innehåller detaljerad information om statuskoden. |
statusCode |
InstanceFlexibility
Om du aktiverar detta tillämpas reservationsrabatten på andra virtuella datorer i samma VM-storleksgrupp. Ange endast för reserverad resurstyp för VirtualMachines.
Name | Typ | Description |
---|---|---|
Off |
string |
|
On |
string |
PaymentDetail
Information om betalning relaterad till en reservationsbeställning.
Name | Typ | Description |
---|---|---|
billingAccount |
string |
Visar det konto som debiteras för den här betalningen. |
billingCurrencyTotal |
Belopp som debiteras i faktureringsvalutan. Skatt ingår inte. Är null för framtida betalningar |
|
dueDate |
string |
Datum då betalningen måste göras. |
extendedStatusInfo | ||
paymentDate |
string |
Datum då transaktionen har slutförts. Är null när det är schemalagt. |
pricingCurrencyTotal |
Belopp i prisvaluta. Skatt ingår inte. |
|
status |
Beskriver om betalningen slutförs, misslyckas, avbryts eller schemaläggs i framtiden. |
PaymentStatus
Beskriver om betalningen slutförs, misslyckas, avbryts eller schemaläggs i framtiden.
Name | Typ | Description |
---|---|---|
Cancelled |
string |
|
Failed |
string |
|
Scheduled |
string |
|
Succeeded |
string |
Price
Prisinformation som innehåller beloppet och valutakoden
Name | Typ | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
ISO 4217 3-bokstavs valutakod för den valuta som används av den här inköpsposten. |
PricingCurrencyTotal
Belopp som Microsoft använder för posten. Används under återbetalning för att beräkna återbetalningsgränsen. Skatt ingår inte. Det här är låst pris 30 dagar innan det upphör att gälla.
Name | Typ | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
ISO 4217 3-bokstavs valutakod för den valuta som används av den här inköpsposten. |
PurchaseRequest
Begäran om reservationsköp
Name | Typ | Standardvärde | Description |
---|---|---|---|
location |
string |
Den Azure-region där den reserverade resursen finns. |
|
properties.appliedScopeProperties |
Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup |
||
properties.appliedScopeType |
Typ av tillämpat omfång. |
||
properties.appliedScopes |
string[] |
Lista över de prenumerationer som förmånen ska tillämpas på. Ange inte om AppliedScopeType är Delad. Den här egenskapen kommer att bli inaktuell och ersättas av appliedScopeProperties i stället för Single AppliedScopeType. |
|
properties.billingPlan |
Representera faktureringsplanerna. |
||
properties.billingScopeId |
string |
Prenumeration som debiteras för köp av reservation eller sparplan |
|
properties.displayName |
string |
Eget namn på reservationen |
|
properties.quantity |
integer |
Antal sku:er som ingår i reservationen. |
|
properties.renew |
boolean |
False |
Om du anger värdet true köps automatiskt en ny reservation på förfallodatumtiden. |
properties.reservedResourceProperties |
Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt. |
||
properties.reservedResourceType |
Typen av resurs som reserveras. |
||
properties.reviewDateTime |
string |
Det här är den tidpunkt då Azure Hybrid-förmånen behöver granskas. |
|
properties.term |
Representerar reservationsperioden. |
||
sku |
Namnet på sku |
ReservationBillingPlan
Representera faktureringsplanerna.
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
Representerar reservationsperioden.
Name | Typ | Description |
---|---|---|
P1Y |
string |
|
P3Y |
string |
|
P5Y |
string |
ReservedResourceProperties
Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt.
Name | Typ | Description |
---|---|---|
instanceFlexibility |
Om du aktiverar detta tillämpas reservationsrabatten på andra virtuella datorer i samma VM-storleksgrupp. Ange endast för reserverad resurstyp för VirtualMachines. |
ReservedResourceType
Typen av resurs som reserveras.
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
Namnet på sku
Name | Typ | Description |
---|---|---|
name |
string |