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

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

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

ReservationBillingPlan

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

ReservedResourceProperties

Az egyes fenntartott erőforrástípusokra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható.

properties.reservedResourceType

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

ReservationTerm

A foglalás időtartamát jelöli.

sku

SkuName

A termékváltozat neve

Válaszok

Name Típus Description
200 OK

CalculatePriceResponse

Részletes árinformációk vásárláshoz ReservationOrder

Other Status Codes

Error

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

AppliedScopeType

Az Alkalmazott hatókör típusa.

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.

CalculatePriceResponse

A foglalás árának kiszámítására adott válasz.

CalculatePriceResponseProperties

Az árválasz kiszámításának tulajdonságai

Error

Hibainformációk

ErrorResponseCode

Hibakód, amely leírja, hogy a szolgáltatás miért nem tudja feldolgozni a bejövő kérést

ExtendedErrorInfo

Bővített hibainformációk, beleértve a hibakódot és a hibaüzenetet

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

PaymentDetail

A foglalási rendeléshez kapcsolódó fizetéssel kapcsolatos információk.

PaymentStatus

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

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.

PurchaseRequest

Foglalásvásárlási kérelem

ReservationBillingPlan

A számlázási csomagok ábrázolása.

ReservationStatusCode
ReservationTerm

A foglalás időtartamát jelöli.

ReservedResourceProperties

Az egyes fenntartott erőforrástípusokra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható.

ReservedResourceType

A lefoglalt erőforrás típusa.

SkuName

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

CalculatePriceResponseProperties

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

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

PaymentDetail[]

A foglalási rendeléshez kapcsolódó fizetéssel kapcsolatos információk.

pricingCurrencyTotal

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

ExtendedErrorInfo

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

ErrorResponseCode

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

ReservationStatusCode

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

Price

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

ExtendedStatusInfo

paymentDate

string

A tranzakció befejezésének dátuma. Az ütemezéskor null értékű.

pricingCurrencyTotal

Price

Összeg a díjszabás pénznemében. Az adót nem tartalmazza.

status

PaymentStatus

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

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

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

ReservationBillingPlan

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

ReservedResourceProperties

Az egyes fenntartott erőforrástípusokra jellemző tulajdonságok. Nem kötelező, ha nem alkalmazható.

properties.reservedResourceType

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

ReservationTerm

A foglalás időtartamát jelöli.

sku

SkuName

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

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