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 |
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 |
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 |
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 |
Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable. |
|
properties.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 |
Representa el plazo de reserva. |
|
sku |
Nombre de la SKU |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Información detallada del precio para la compra |
|
Other Status Codes |
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 |
---|---|
Applied |
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 |
Applied |
Tipo del ámbito aplicado. |
Billing |
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. |
Calculate |
Respuesta del cálculo del precio de la reserva. |
Calculate |
Propiedades para calcular la respuesta de precios |
Error |
Información de error |
Error |
Código de error que describe el motivo por el que el servicio no puede procesar la solicitud entrante |
Extended |
Información de error extendida, incluido el código de error y el mensaje de error |
Extended |
|
Instance |
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. |
Payment |
Información sobre el pago relacionado con un pedido de reserva. |
Payment |
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 |
Pricing |
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. |
Purchase |
Solicitud de compra de reserva |
Reservation |
Representa los planes de facturación. |
Reservation |
|
Reservation |
Representa el plazo de reserva. |
Reserved |
Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable. |
Reserved |
Tipo del recurso que se va a reservar. |
Sku |
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 |
Propiedades para calcular la respuesta de precios |
CalculatePriceResponseProperties
Propiedades para calcular la respuesta de precios
Nombre | Tipo | Description |
---|---|---|
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 |
Información sobre el pago relacionado con un pedido de reserva. |
|
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 |
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 |
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 |
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 |
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 | ||
paymentDate |
string |
Fecha en que se completa la transacción. Es null cuando está programado. |
pricingCurrencyTotal |
Importe en moneda de precios. No se incluye el impuesto. |
|
status |
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 |
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 |
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 |
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 |
Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable. |
||
properties.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 |
Representa el plazo de reserva. |
||
sku |
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 |
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 |