Reservation Order - Calculate
Egy ár kiszámítása.ReservationOrder
Számítsa ki a elhelyezésének ReservationOrder
árát.
POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Támogatott verzió. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
location |
string |
Az Azure-régió, ahol a fenntartott erőforrás található. |
properties.appliedScopeProperties |
Az alkalmazott hatókörtípusra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható. Kötelező, és meg kell adnia a tenantId és a managementGroupId azonosítót, ha az AppliedScopeType a ManagementGroup |
|
properties.appliedScopeType |
Az Alkalmazott hatókör típusa. |
|
properties.appliedScopes |
string[] |
Azoknak az előfizetéseknek a listája, amelyeket az előny alkalmaz. Ne adja meg, hogy az AppliedScopeType meg van-e osztva. Ez a tulajdonság elavult lesz, és az appliedScopeProperties helyett az AppliedScopeType lesz lecserélve. |
properties.billingPlan |
A számlázási csomagok ábrázolása. |
|
properties.billingScopeId |
string |
Foglalás vagy megtakarítási csomag megvásárlásáért felszámított előfizetés |
properties.displayName |
string |
A foglalás rövid neve |
properties.quantity |
integer |
A foglalás részét képező termékváltozatok mennyisége. |
properties.renew |
boolean |
Ha ezt true (igaz) értékre állítja, a rendszer automatikusan megvásárol egy új foglalást a lejárati dátumon. |
properties.reservedResourceProperties |
Az egyes fenntartott erőforrástípusokra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható. |
|
properties.reservedResourceType |
A lefoglalt erőforrás típusa. |
|
properties.reviewDateTime |
string |
Ez az a dátum-idő, amikor felül kell vizsgálni az Azure-beli hibrid előnyt. |
properties.term |
A foglalás időtartamát jelöli. |
|
sku |
A termékváltozat neve |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
Részletes árinformációk vásárláshoz |
|
Other Status Codes |
Váratlan hiba |
Példák
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
}
}
]
}
}
Definíciók
Name | Description |
---|---|
Applied |
Az alkalmazott hatókörtípusra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható. Kötelező, és meg kell adnia a tenantId és a managementGroupId azonosítót, ha az AppliedScopeType a ManagementGroup |
Applied |
Az Alkalmazott hatókör típusa. |
Billing |
A megújítási vásárlásért az ügyfél helyi pénznemében felszámított pénznem és összeg. Az adó nem tartalmazza az adót. |
Calculate |
A foglalás árának kiszámítására adott válasz. |
Calculate |
Az árválasz kiszámításának tulajdonságai |
Error |
Hibainformációk |
Error |
Hibakód, amely leírja, hogy a szolgáltatás miért nem tudja feldolgozni a bejövő kérést |
Extended |
Bővített hibainformációk, beleértve a hibakódot és a hibaüzenetet |
Extended |
|
Instance |
Ha bekapcsolja ezt a beállítást, a foglalási kedvezményt az ugyanazon virtuálisgép-méretcsoportban lévő többi virtuális gépre alkalmazza. Csak a VirtualMachines fenntartott erőforrástípusát adja meg. |
Payment |
A foglalási rendeléshez kapcsolódó fizetéssel kapcsolatos információk. |
Payment |
Azt ismerteti, hogy a kifizetés befejeződött, meghiúsult, törölve vagy ütemezve lesz-e a jövőben. |
Price |
Az összeget és a pénznemkódot tartalmazó díjszabási információk |
Pricing |
A Microsoft által a rekordhoz használt mennyiség. A visszatérítés során a visszatérítési korlát kiszámításához használatos. Az adó nem tartalmazza az adót. Ez 30 nappal a lejárat előtt zárolt ár. |
Purchase |
Foglalásvásárlási kérelem |
Reservation |
A számlázási csomagok ábrázolása. |
Reservation |
|
Reservation |
A foglalás időtartamát jelöli. |
Reserved |
Az egyes fenntartott erőforrástípusokra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható. |
Reserved |
A lefoglalt erőforrás típusa. |
Sku |
A termékváltozat neve |
AppliedScopeProperties
Az alkalmazott hatókörtípusra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható. Kötelező, és meg kell adnia a tenantId és a managementGroupId azonosítót, ha az AppliedScopeType a ManagementGroup
Name | Típus | Description |
---|---|---|
displayName |
string |
Megjelenített név |
managementGroupId |
string |
Annak a felügyeleti csoportnak a teljes azonosítója, ahol a kedvezményt alkalmazni kell. |
resourceGroupId |
string |
Az erőforráscsoport teljes azonosítója. |
subscriptionId |
string |
Az előfizetés teljes azonosítója. |
tenantId |
string |
Bérlőazonosító, ahol a megtakarítási csomagnak előnyösnek kell lennie. |
AppliedScopeType
Az Alkalmazott hatókör típusa.
Name | Típus | Description |
---|---|---|
ManagementGroup |
string |
|
Shared |
string |
|
Single |
string |
BillingCurrencyTotal
A megújítási vásárlásért az ügyfél helyi pénznemében felszámított pénznem és összeg. Az adó nem tartalmazza az adót.
Name | Típus | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
Az iso 4217 3 betűs pénznemkód a vásárlási rekord által használt pénznemhez. |
CalculatePriceResponse
A foglalás árának kiszámítására adott válasz.
Name | Típus | Description |
---|---|---|
properties |
Az árválasz kiszámításának tulajdonságai |
CalculatePriceResponseProperties
Az árválasz kiszámításának tulajdonságai
Name | Típus | Description |
---|---|---|
billingCurrencyTotal |
Az ügyfél által felszámított pénznem és összeg az ügyfél helyi pénznemében lesz felszámítva. Az adó nem tartalmazza az adót. |
|
grandTotal |
number |
Teljes összeg a díjszabás pénznemében. |
isBillingPartnerManaged |
boolean |
Igaz, ha a számlázást a Microsoft Partner kezeli. Csak CSP-fiókokhoz használható. |
isTaxIncluded |
boolean |
Azt jelzi, hogy az adó beleszámítva van-e a végösszegbe |
netTotal |
number |
Nettó teljes összeg a díjszabás pénznemében. |
paymentSchedule |
A foglalási rendeléshez kapcsolódó fizetéssel kapcsolatos információk. |
|
pricingCurrencyTotal |
A Microsoft által a rekordhoz használt mennyiség. A visszatérítés során a visszatérítési korlát kiszámításához használatos. Az adó nem tartalmazza az adót. |
|
reservationOrderId |
string |
A foglalási sorrendet képviselő GUID, amely az ár kiszámítása után helyezhető el. |
skuDescription |
string |
A megvásárolt termékváltozat leírása. |
skuTitle |
string |
A megvásárolni kívánt termékváltozat címe. |
taxTotal |
number |
Az adó összege a díjszabás pénznemében. |
Error
Hibainformációk
Name | Típus | Description |
---|---|---|
error |
Bővített hibainformációk, beleértve a hibakódot és a hibaüzenetet |
ErrorResponseCode
Hibakód, amely leírja, hogy a szolgáltatás miért nem tudja feldolgozni a bejövő kérést
Name | Típus | 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
Bővített hibainformációk, beleértve a hibakódot és a hibaüzenetet
Name | Típus | Description |
---|---|---|
code |
Hibakód, amely leírja, hogy a szolgáltatás miért nem tudja feldolgozni a bejövő kérést |
|
message |
string |
ExtendedStatusInfo
Name | Típus | Description |
---|---|---|
message |
string |
Az állapotkódra vonatkozó részletes információkat tartalmazó üzenet. |
statusCode |
InstanceFlexibility
Ha bekapcsolja ezt a beállítást, a foglalási kedvezményt az ugyanazon virtuálisgép-méretcsoportban lévő többi virtuális gépre alkalmazza. Csak a VirtualMachines fenntartott erőforrástípusát adja meg.
Name | Típus | Description |
---|---|---|
Off |
string |
|
On |
string |
PaymentDetail
A foglalási rendeléshez kapcsolódó fizetéssel kapcsolatos információk.
Name | Típus | Description |
---|---|---|
billingAccount |
string |
A fizetésért felszámított fiókot jeleníti meg. |
billingCurrencyTotal |
A számlázási pénznemben felszámított összeg. Az adót nem tartalmazza. Null értékű a jövőbeli kifizetések esetében |
|
dueDate |
string |
A fizetés teljesítésének dátuma. |
extendedStatusInfo | ||
paymentDate |
string |
A tranzakció befejezésének dátuma. Az ütemezéskor null értékű. |
pricingCurrencyTotal |
Összeg a díjszabás pénznemében. Az adót nem tartalmazza. |
|
status |
Azt ismerteti, hogy a kifizetés befejeződött, meghiúsult, törölve vagy ütemezve lesz-e a jövőben. |
PaymentStatus
Azt ismerteti, hogy a kifizetés befejeződött, meghiúsult, törölve vagy ütemezve lesz-e a jövőben.
Name | Típus | Description |
---|---|---|
Cancelled |
string |
|
Failed |
string |
|
Scheduled |
string |
|
Succeeded |
string |
Price
Az összeget és a pénznemkódot tartalmazó díjszabási információk
Name | Típus | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
Az iso 4217 3 betűs pénznemkód a vásárlási rekord által használt pénznemhez. |
PricingCurrencyTotal
A Microsoft által a rekordhoz használt mennyiség. A visszatérítés során a visszatérítési korlát kiszámításához használatos. Az adó nem tartalmazza az adót. Ez 30 nappal a lejárat előtt zárolt ár.
Name | Típus | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
Az iso 4217 3 betűs pénznemkód a vásárlási rekord által használt pénznemhez. |
PurchaseRequest
Foglalásvásárlási kérelem
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
location |
string |
Az Azure-régió, ahol a fenntartott erőforrás található. |
|
properties.appliedScopeProperties |
Az alkalmazott hatókörtípusra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható. Kötelező, és meg kell adnia a tenantId és a managementGroupId azonosítót, ha az AppliedScopeType a ManagementGroup |
||
properties.appliedScopeType |
Az Alkalmazott hatókör típusa. |
||
properties.appliedScopes |
string[] |
Azoknak az előfizetéseknek a listája, amelyeket az előny alkalmaz. Ne adja meg, hogy az AppliedScopeType meg van-e osztva. Ez a tulajdonság elavult lesz, és az appliedScopeProperties helyett az AppliedScopeType lesz lecserélve. |
|
properties.billingPlan |
A számlázási csomagok ábrázolása. |
||
properties.billingScopeId |
string |
Foglalás vagy megtakarítási csomag megvásárlásáért felszámított előfizetés |
|
properties.displayName |
string |
A foglalás rövid neve |
|
properties.quantity |
integer |
A foglalás részét képező termékváltozatok mennyisége. |
|
properties.renew |
boolean |
False |
Ha ezt igaz értékre állítja, a rendszer automatikusan megvásárol egy új foglalást a lejárati dátumon. |
properties.reservedResourceProperties |
Az egyes fenntartott erőforrástípusokra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható. |
||
properties.reservedResourceType |
A lefoglalt erőforrás típusa. |
||
properties.reviewDateTime |
string |
Ez az a dátum-idő, amikor felül kell vizsgálni az Azure hibrid előnyét. |
|
properties.term |
A foglalás időtartamát jelöli. |
||
sku |
A termékváltozat neve |
ReservationBillingPlan
A számlázási csomagok ábrázolása.
Name | Típus | Description |
---|---|---|
Monthly |
string |
|
Upfront |
string |
ReservationStatusCode
Name | Típus | Description |
---|---|---|
Active |
string |
|
Expired |
string |
|
Merged |
string |
|
None |
string |
|
PaymentInstrumentError |
string |
|
Pending |
string |
|
Processing |
string |
|
PurchaseError |
string |
|
Split |
string |
|
Succeeded |
string |
ReservationTerm
A foglalás időtartamát jelöli.
Name | Típus | Description |
---|---|---|
P1Y |
string |
|
P3Y |
string |
|
P5Y |
string |
ReservedResourceProperties
Az egyes fenntartott erőforrástípusokra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható.
Name | Típus | Description |
---|---|---|
instanceFlexibility |
Ha bekapcsolja ezt a beállítást, a foglalási kedvezményt az ugyanazon virtuálisgép-méretcsoportban lévő többi virtuális gépre alkalmazza. Csak a VirtualMachines fenntartott erőforrástípusát adja meg. |
ReservedResourceType
A lefoglalt erőforrás típusa.
Name | Típus | 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
A termékváltozat neve
Name | Típus | Description |
---|---|---|
name |
string |