Compartir a través de


Reservation Order - Calculate

Calcule el precio de un .ReservationOrder
Calcule el precio para colocar un ReservationOrder.

POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
api-version
query True

string

Versión admitida.

Cuerpo de la solicitud

Nombre Tipo Description
location

string

Región de Azure donde reside el recurso reservado.

properties.appliedScopeProperties

AppliedScopeProperties

Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y debe proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup

properties.appliedScopeType

AppliedScopeType

Tipo del ámbito aplicado.

properties.appliedScopes

string[]

Lista de las suscripciones a las que se aplicará la ventaja. No especifique si AppliedScopeType es Shared. Esta propiedad quedará en desuso y se reemplazará por appliedScopeProperties en su lugar para Single AppliedScopeType.

properties.billingPlan

ReservationBillingPlan

Representa los planes de facturación.

properties.billingScopeId

string

Suscripción que se cobrará por la reserva de compra o el plan de ahorro

properties.displayName

string

Nombre descriptivo de la reserva

properties.quantity

integer

Cantidad de las sku que forman parte de la reserva.

properties.renew

boolean

Si se establece en true, se adquirirá automáticamente una nueva reserva en la fecha de expiración.

properties.reservedResourceProperties

ReservedResourceProperties

Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable.

properties.reservedResourceType

ReservedResourceType

Tipo del recurso que se va a reservar.

properties.reviewDateTime

string

Esta es la fecha y hora en que se debe revisar la ventaja híbrida de Azure.

properties.term

ReservationTerm

Representa el plazo de reserva.

sku

SkuName

Nombre de la SKU

Respuestas

Nombre Tipo Description
200 OK

CalculatePriceResponse

Información detallada del precio para la compra ReservationOrder

Other Status Codes

Error

Error inesperado

Ejemplos

CalculatePrice

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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
        }
      }
    ]
  }
}

Definiciones

Nombre Description
AppliedScopeProperties

Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup

AppliedScopeType

Tipo del ámbito aplicado.

BillingCurrencyTotal

Moneda y cantidad que el cliente se cobrará en la moneda local del cliente para la compra de renovación. No se incluye el impuesto.

CalculatePriceResponse

Respuesta del cálculo del precio de la reserva.

CalculatePriceResponseProperties

Propiedades para calcular la respuesta de precios

Error

Información de error

ErrorResponseCode

Código de error que describe el motivo por el que el servicio no puede procesar la solicitud entrante

ExtendedErrorInfo

Información de error extendida, incluido el código de error y el mensaje de error

ExtendedStatusInfo
InstanceFlexibility

Al activar esto, se aplicará el descuento por reserva a otras máquinas virtuales del mismo grupo de tamaño de máquina virtual. Especifique solo para el tipo de recurso reservado VirtualMachines.

PaymentDetail

Información sobre el pago relacionado con un pedido de reserva.

PaymentStatus

Describe si el pago está completado, con errores, cancelados o programados en el futuro.

Price

Información de precios que contiene la cantidad y el código de moneda

PricingCurrencyTotal

Cantidad que Microsoft usa para el registro. Se usa durante el reembolso para calcular el límite de reembolso. No se incluye el impuesto. Este precio está bloqueado 30 días antes de la expiración.

PurchaseRequest

Solicitud de compra de reserva

ReservationBillingPlan

Representa los planes de facturación.

ReservationStatusCode
ReservationTerm

Representa el plazo de reserva.

ReservedResourceProperties

Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable.

ReservedResourceType

Tipo del recurso que se va a reservar.

SkuName

Nombre de la SKU

AppliedScopeProperties

Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup

Nombre Tipo Description
displayName

string

Nombre para mostrar

managementGroupId

string

Identificador completo del grupo de administración en el que se debe aplicar la ventaja.

resourceGroupId

string

Identificador completo del grupo de recursos.

subscriptionId

string

Identificador completo de la suscripción.

tenantId

string

Identificador de inquilino en el que el plan de ahorro debe aplicar la ventaja.

AppliedScopeType

Tipo del ámbito aplicado.

Nombre Tipo Description
ManagementGroup

string

Shared

string

Single

string

BillingCurrencyTotal

Moneda y cantidad que el cliente se cobrará en la moneda local del cliente para la compra de renovación. No se incluye el impuesto.

Nombre Tipo Description
amount

number

currencyCode

string

El código de moneda iso 4217 de 3 letras para la moneda utilizada por este registro de compra.

CalculatePriceResponse

Respuesta del cálculo del precio de la reserva.

Nombre Tipo Description
properties

CalculatePriceResponseProperties

Propiedades para calcular la respuesta de precios

CalculatePriceResponseProperties

Propiedades para calcular la respuesta de precios

Nombre Tipo Description
billingCurrencyTotal

BillingCurrencyTotal

Moneda y cantidad que se cobrará al cliente en la moneda local del cliente. No se incluye el impuesto.

grandTotal

number

Importe total en moneda de precios.

isBillingPartnerManaged

boolean

True si microsoft Partner administra la facturación. Solo se usa para las cuentas de CSP.

isTaxIncluded

boolean

Si se incluye o no impuestos en total general

netTotal

number

Importe total neto en moneda de precios.

paymentSchedule

PaymentDetail[]

Información sobre el pago relacionado con un pedido de reserva.

pricingCurrencyTotal

PricingCurrencyTotal

Cantidad que Microsoft usa para el registro. Se usa durante el reembolso para calcular el límite de reembolso. No se incluye el impuesto.

reservationOrderId

string

GUID que representa el pedido de reserva que se puede realizar después de calcular el precio.

skuDescription

string

Descripción de la SKU que se está comprando.

skuTitle

string

Título de la SKU que se va a comprar.

taxTotal

number

Importe fiscal en moneda de precios.

Error

Información de error

Nombre Tipo Description
error

ExtendedErrorInfo

Información de error extendida, incluido el código de error y el mensaje de error

ErrorResponseCode

Código de error que describe el motivo por el que el servicio no puede procesar la solicitud entrante

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

Información de error extendida, incluido el código de error y el mensaje de error

Nombre Tipo Description
code

ErrorResponseCode

Código de error que describe el motivo por el que el servicio no puede procesar la solicitud entrante

message

string

ExtendedStatusInfo

Nombre Tipo Description
message

string

Mensaje que proporciona información detallada sobre el código de estado.

statusCode

ReservationStatusCode

InstanceFlexibility

Al activar esto, se aplicará el descuento por reserva a otras máquinas virtuales del mismo grupo de tamaño de máquina virtual. Especifique solo para el tipo de recurso reservado VirtualMachines.

Nombre Tipo Description
Off

string

On

string

PaymentDetail

Información sobre el pago relacionado con un pedido de reserva.

Nombre Tipo Description
billingAccount

string

Muestra la cuenta que se cobra por este pago.

billingCurrencyTotal

Price

Importe cargado en moneda de facturación. No se incluye el impuesto. Es null para pagos futuros

dueDate

string

Fecha en que es necesario realizar el pago.

extendedStatusInfo

ExtendedStatusInfo

paymentDate

string

Fecha en que se completa la transacción. Es null cuando está programado.

pricingCurrencyTotal

Price

Importe en moneda de precios. No se incluye el impuesto.

status

PaymentStatus

Describe si el pago está completado, con errores, cancelados o programados en el futuro.

PaymentStatus

Describe si el pago está completado, con errores, cancelados o programados en el futuro.

Nombre Tipo Description
Cancelled

string

Failed

string

Scheduled

string

Succeeded

string

Price

Información de precios que contiene la cantidad y el código de moneda

Nombre Tipo Description
amount

number

currencyCode

string

El código de moneda iso 4217 de 3 letras para la moneda utilizada por este registro de compra.

PricingCurrencyTotal

Cantidad que Microsoft usa para el registro. Se usa durante el reembolso para calcular el límite de reembolso. No se incluye el impuesto. Este precio está bloqueado 30 días antes de la expiración.

Nombre Tipo Description
amount

number

currencyCode

string

El código de moneda iso 4217 de 3 letras para la moneda utilizada por este registro de compra.

PurchaseRequest

Solicitud de compra de reserva

Nombre Tipo Valor predeterminado Description
location

string

Región de Azure donde reside el recurso reservado.

properties.appliedScopeProperties

AppliedScopeProperties

Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup

properties.appliedScopeType

AppliedScopeType

Tipo del ámbito aplicado.

properties.appliedScopes

string[]

Lista de las suscripciones a las que se aplicará la ventaja. No especifique si AppliedScopeType es Shared. Esta propiedad quedará en desuso y se reemplazará por appliedScopeProperties en su lugar para Single AppliedScopeType.

properties.billingPlan

ReservationBillingPlan

Representa los planes de facturación.

properties.billingScopeId

string

Suscripción que se cobrará por la reserva de compra o el plan de ahorro

properties.displayName

string

Nombre descriptivo de la reserva

properties.quantity

integer

Cantidad de las sku que forman parte de la reserva.

properties.renew

boolean

False

Si se establece en true, se adquirirá automáticamente una nueva reserva en la fecha de expiración.

properties.reservedResourceProperties

ReservedResourceProperties

Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable.

properties.reservedResourceType

ReservedResourceType

Tipo del recurso que se va a reservar.

properties.reviewDateTime

string

Esta es la fecha y hora en que se debe revisar la ventaja híbrida de Azure.

properties.term

ReservationTerm

Representa el plazo de reserva.

sku

SkuName

Nombre de la SKU

ReservationBillingPlan

Representa los planes de facturación.

Nombre Tipo Description
Monthly

string

Upfront

string

ReservationStatusCode

Nombre Tipo Description
Active

string

Expired

string

Merged

string

None

string

PaymentInstrumentError

string

Pending

string

Processing

string

PurchaseError

string

Split

string

Succeeded

string

ReservationTerm

Representa el plazo de reserva.

Nombre Tipo Description
P1Y

string

P3Y

string

P5Y

string

ReservedResourceProperties

Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable.

Nombre Tipo Description
instanceFlexibility

InstanceFlexibility

Al activar esto, se aplicará el descuento por reserva a otras máquinas virtuales del mismo grupo de tamaño de máquina virtual. Especifique solo para el tipo de recurso reservado VirtualMachines.

ReservedResourceType

Tipo del recurso que se va a reservar.

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

Nombre de la SKU

Nombre Tipo Description
name

string