Dela via


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

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

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

ReservationBillingPlan

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

ReservedResourceProperties

Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt.

properties.reservedResourceType

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

ReservationTerm

Representerar reservationsperioden.

sku

SkuName

Namnet på sku

Svar

Name Typ Description
200 OK

CalculatePriceResponse

Detaljerad prisinformation för inköp ReservationOrder

Other Status Codes

Error

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

AppliedScopeType

Typ av tillämpat omfång.

BillingCurrencyTotal

Valuta och belopp som kunden debiteras i kundens lokala valuta för förnyelseköp. Skatt ingår inte.

CalculatePriceResponse

Svaret för att beräkna priset för reservationen.

CalculatePriceResponseProperties

Egenskaper för att beräkna prissvar

Error

Felinformation

ErrorResponseCode

Felkod som beskriver orsaken till att tjänsten inte kan bearbeta den inkommande begäran

ExtendedErrorInfo

Utökad felinformation inklusive felkod och felmeddelande

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

PaymentDetail

Information om betalning relaterad till en reservationsbeställning.

PaymentStatus

Beskriver om betalningen slutförs, misslyckas, avbryts eller schemaläggs i framtiden.

Price

Prisinformation som innehåller beloppet och valutakoden

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.

PurchaseRequest

Begäran om reservationsköp

ReservationBillingPlan

Representera faktureringsplanerna.

ReservationStatusCode
ReservationTerm

Representerar reservationsperioden.

ReservedResourceProperties

Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt.

ReservedResourceType

Typen av resurs som reserveras.

SkuName

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

CalculatePriceResponseProperties

Egenskaper för att beräkna prissvar

CalculatePriceResponseProperties

Egenskaper för att beräkna prissvar

Name Typ Description
billingCurrencyTotal

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

PaymentDetail[]

Information om betalning relaterad till en reservationsbeställning.

pricingCurrencyTotal

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

ExtendedErrorInfo

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

ErrorResponseCode

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

ReservationStatusCode

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

Price

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

ExtendedStatusInfo

paymentDate

string

Datum då transaktionen har slutförts. Är null när det är schemalagt.

pricingCurrencyTotal

Price

Belopp i prisvaluta. Skatt ingår inte.

status

PaymentStatus

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

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

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

ReservationBillingPlan

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

ReservedResourceProperties

Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt.

properties.reservedResourceType

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

ReservationTerm

Representerar reservationsperioden.

sku

SkuName

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

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