Reservation Order - Calculate
Вычислите цену ReservationOrder
для .
Вычислите цену ReservationOrder
для размещения .
POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
api-version
|
query | True |
string |
Поддерживаемая версия. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
location |
string |
Регион Azure, в котором находится зарезервированный ресурс. |
properties.appliedScopeProperties |
Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup |
|
properties.appliedScopeType |
Тип примененной области. |
|
properties.appliedScopes |
string[] |
Список подписок, к которым будет применено преимущество. Не указывайте, является ли AppliedScopeType общим. Это свойство будет нерекомендуемым и заменено на appliedScopeProperties вместо single AppliedScopeType. |
properties.billingPlan |
Представлять планы выставления счетов. |
|
properties.billingScopeId |
string |
Подписка, которая будет взиматься за приобретение резервирования или накопительного плана |
properties.displayName |
string |
Понятное имя резервирования |
properties.quantity |
integer |
Количество номеров SKU, которые являются частью резервирования. |
properties.renew |
boolean |
Если задать для этого параметра значение true, будет автоматически приобретено новое резервирование в дату окончания срока действия. |
properties.reservedResourceProperties |
Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо. |
|
properties.reservedResourceType |
Тип зарезервированного ресурса. |
|
properties.reviewDateTime |
string |
Это дата и время, когда необходимо проверить преимущество гибридного использования Azure. |
properties.term |
Представляет термин резервирования. |
|
sku |
Имя SKU |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Подробные сведения о ценах на покупку |
|
Other Status Codes |
Непредвиденная ошибка. |
Примеры
CalculatePrice
Образец запроса
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"
}
}
}
Пример ответа
{
"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
}
}
]
}
}
Определения
Имя | Описание |
---|---|
Applied |
Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup |
Applied |
Тип примененной области. |
Billing |
Валюта и сумма, которые клиент будет взимать в местной валюте клиента для продления покупки. Налог не включен. |
Calculate |
Ответ вычисления цены для резервирования. |
Calculate |
Свойства для ответа о расчете цены |
Error |
Сведения об ошибках. |
Error |
Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос |
Extended |
Расширенные сведения об ошибке, включая код ошибки и сообщение об ошибке |
Extended |
|
Instance |
При включении этого параметра скидка на резервирование применяется к другим виртуальным машинам в той же группе размера виртуальных машин. Укажите только для зарезервированного типа ресурса VirtualMachines. |
Payment |
Сведения об оплате, связанной с заказом на резервирование. |
Payment |
Описывает, будет ли платеж завершен, не выполнен, отменен или запланирован в будущем. |
Price |
Сведения о ценах, содержащие сумму и код валюты |
Pricing |
Сумма, которую корпорация Майкрософт использует для записи. Используется при возврате средств для расчета лимита возмещения. Налог не включен. Эта цена заблокирована за 30 дней до истечения срока действия. |
Purchase |
Запрос на покупку резервирования |
Reservation |
Представлять планы выставления счетов. |
Reservation |
|
Reservation |
Представляет термин резервирования. |
Reserved |
Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо. |
Reserved |
Тип зарезервированного ресурса. |
Sku |
Имя SKU |
AppliedScopeProperties
Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup
Имя | Тип | Описание |
---|---|---|
displayName |
string |
Отображаемое имя |
managementGroupId |
string |
Полный идентификатор группы управления, в которой должно применяться преимущество. |
resourceGroupId |
string |
Полный идентификатор группы ресурсов. |
subscriptionId |
string |
Полный идентификатор подписки. |
tenantId |
string |
Идентификатор клиента, к которому применяется льгота в плане экономии. |
AppliedScopeType
Тип примененной области.
Имя | Тип | Описание |
---|---|---|
ManagementGroup |
string |
|
Shared |
string |
|
Single |
string |
BillingCurrencyTotal
Валюта и сумма, которые клиент будет взимать в местной валюте клиента для продления покупки. Налог не включен.
Имя | Тип | Описание |
---|---|---|
amount |
number |
|
currencyCode |
string |
Трехбуквенный код валюты ISO 4217 для валюты, используемой в этой записи покупки. |
CalculatePriceResponse
Ответ вычисления цены для резервирования.
Имя | Тип | Описание |
---|---|---|
properties |
Свойства для ответа о расчете цены |
CalculatePriceResponseProperties
Свойства для ответа о расчете цены
Имя | Тип | Описание |
---|---|---|
billingCurrencyTotal |
Валюта и сумма, которую клиент будет взимать в местной валюте клиента. Налог не включен. |
|
grandTotal |
number |
Общая сумма в валюте ценообразования. |
isBillingPartnerManaged |
boolean |
Значение true, если выставление счетов управляется партнером Майкрософт. Используется только для учетных записей CSP. |
isTaxIncluded |
boolean |
Включается ли налог в общую общую сумму |
netTotal |
number |
Чистая общая сумма в валюте ценообразования. |
paymentSchedule |
Сведения об оплате, связанной с заказом на резервирование. |
|
pricingCurrencyTotal |
Сумма, которую корпорация Майкрософт использует для записи. Используется при возврате средств для расчета лимита возмещения. Налог не включен. |
|
reservationOrderId |
string |
GUID, представляющий заказ на резервирование, который можно разместить после вычисления цены. |
skuDescription |
string |
Описание приобретаемого номера SKU. |
skuTitle |
string |
Название приобретаемого номера SKU. |
taxTotal |
number |
Сумма налога в валюте ценообразования. |
Error
Сведения об ошибках.
Имя | Тип | Описание |
---|---|---|
error |
Расширенные сведения об ошибке, включая код ошибки и сообщение об ошибке |
ErrorResponseCode
Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос
Имя | Тип | Описание |
---|---|---|
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
Расширенные сведения об ошибке, включая код ошибки и сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
code |
Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос |
|
message |
string |
ExtendedStatusInfo
Имя | Тип | Описание |
---|---|---|
message |
string |
Сообщение с подробными сведениями о коде состояния. |
statusCode |
InstanceFlexibility
При включении этого параметра скидка на резервирование применяется к другим виртуальным машинам в той же группе размера виртуальных машин. Укажите только для зарезервированного типа ресурса VirtualMachines.
Имя | Тип | Описание |
---|---|---|
Off |
string |
|
On |
string |
PaymentDetail
Сведения об оплате, связанной с заказом на резервирование.
Имя | Тип | Описание |
---|---|---|
billingAccount |
string |
Отображает учетную запись, которая взимается за этот платеж. |
billingCurrencyTotal |
Сумма, взимаемая в валюте выставления счетов. Налог не включен. Имеет значение NULL для будущих платежей. |
|
dueDate |
string |
Дата, когда необходимо выполнить платеж. |
extendedStatusInfo | ||
paymentDate |
string |
Дата завершения транзакции. Имеет значение NULL при планировании. |
pricingCurrencyTotal |
Сумма в валюте ценообразования. Налог не включен. |
|
status |
Описывает, будет ли платеж завершен, не выполнен, отменен или запланирован в будущем. |
PaymentStatus
Описывает, будет ли платеж завершен, не выполнен, отменен или запланирован в будущем.
Имя | Тип | Описание |
---|---|---|
Cancelled |
string |
|
Failed |
string |
|
Scheduled |
string |
|
Succeeded |
string |
Price
Сведения о ценах, содержащие сумму и код валюты
Имя | Тип | Описание |
---|---|---|
amount |
number |
|
currencyCode |
string |
Трехбуквенный код валюты ISO 4217 для валюты, используемой в этой записи покупки. |
PricingCurrencyTotal
Сумма, которую корпорация Майкрософт использует для записи. Используется при возврате средств для расчета лимита возмещения. Налог не включен. Эта цена заблокирована за 30 дней до истечения срока действия.
Имя | Тип | Описание |
---|---|---|
amount |
number |
|
currencyCode |
string |
Трехбуквенный код валюты ISO 4217 для валюты, используемой в этой записи покупки. |
PurchaseRequest
Запрос на покупку резервирования
Имя | Тип | Default value | Описание |
---|---|---|---|
location |
string |
Регион Azure, в котором находится зарезервированный ресурс. |
|
properties.appliedScopeProperties |
Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup |
||
properties.appliedScopeType |
Тип примененной области. |
||
properties.appliedScopes |
string[] |
Список подписок, к которым будет применено преимущество. Не указывайте, является ли AppliedScopeType общим. Это свойство будет нерекомендуемым и заменено на appliedScopeProperties вместо single AppliedScopeType. |
|
properties.billingPlan |
Представлять планы выставления счетов. |
||
properties.billingScopeId |
string |
Подписка, которая будет взиматься за приобретение резервирования или накопительного плана |
|
properties.displayName |
string |
Понятное имя резервирования |
|
properties.quantity |
integer |
Количество номеров SKU, которые являются частью резервирования. |
|
properties.renew |
boolean |
False |
Если задать для этого параметра значение true, будет автоматически приобретено новое резервирование в дату окончания срока действия. |
properties.reservedResourceProperties |
Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо. |
||
properties.reservedResourceType |
Тип зарезервированного ресурса. |
||
properties.reviewDateTime |
string |
Это дата и время, когда необходимо проверить преимущество гибридного использования Azure. |
|
properties.term |
Представляет термин резервирования. |
||
sku |
Имя SKU |
ReservationBillingPlan
Представлять планы выставления счетов.
Имя | Тип | Описание |
---|---|---|
Monthly |
string |
|
Upfront |
string |
ReservationStatusCode
Имя | Тип | Описание |
---|---|---|
Active |
string |
|
Expired |
string |
|
Merged |
string |
|
None |
string |
|
PaymentInstrumentError |
string |
|
Pending |
string |
|
Processing |
string |
|
PurchaseError |
string |
|
Split |
string |
|
Succeeded |
string |
ReservationTerm
Представляет термин резервирования.
Имя | Тип | Описание |
---|---|---|
P1Y |
string |
|
P3Y |
string |
|
P5Y |
string |
ReservedResourceProperties
Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо.
Имя | Тип | Описание |
---|---|---|
instanceFlexibility |
При включении этого параметра скидка на резервирование применяется к другим виртуальным машинам в той же группе размера виртуальных машин. Укажите только для зарезервированного типа ресурса VirtualMachines. |
ReservedResourceType
Тип зарезервированного ресурса.
Имя | Тип | Описание |
---|---|---|
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
Имя SKU
Имя | Тип | Описание |
---|---|---|
name |
string |