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

AppliedScopeProperties

Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup

properties.appliedScopeType

AppliedScopeType

Тип примененной области.

properties.appliedScopes

string[]

Список подписок, к которым будет применено преимущество. Не указывайте, является ли AppliedScopeType общим. Это свойство будет нерекомендуемым и заменено на appliedScopeProperties вместо single AppliedScopeType.

properties.billingPlan

ReservationBillingPlan

Представлять планы выставления счетов.

properties.billingScopeId

string

Подписка, которая будет взиматься за приобретение резервирования или накопительного плана

properties.displayName

string

Понятное имя резервирования

properties.quantity

integer

Количество номеров SKU, которые являются частью резервирования.

properties.renew

boolean

Если задать для этого параметра значение true, будет автоматически приобретено новое резервирование в дату окончания срока действия.

properties.reservedResourceProperties

ReservedResourceProperties

Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо.

properties.reservedResourceType

ReservedResourceType

Тип зарезервированного ресурса.

properties.reviewDateTime

string

Это дата и время, когда необходимо проверить преимущество гибридного использования Azure.

properties.term

ReservationTerm

Представляет термин резервирования.

sku

SkuName

Имя SKU

Ответы

Имя Тип Описание
200 OK

CalculatePriceResponse

Подробные сведения о ценах на покупку ReservationOrder

Other Status Codes

Error

Непредвиденная ошибка.

Примеры

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

Определения

Имя Описание
AppliedScopeProperties

Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup

AppliedScopeType

Тип примененной области.

BillingCurrencyTotal

Валюта и сумма, которые клиент будет взимать в местной валюте клиента для продления покупки. Налог не включен.

CalculatePriceResponse

Ответ вычисления цены для резервирования.

CalculatePriceResponseProperties

Свойства для ответа о расчете цены

Error

Сведения об ошибках.

ErrorResponseCode

Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос

ExtendedErrorInfo

Расширенные сведения об ошибке, включая код ошибки и сообщение об ошибке

ExtendedStatusInfo
InstanceFlexibility

При включении этого параметра скидка на резервирование применяется к другим виртуальным машинам в той же группе размера виртуальных машин. Укажите только для зарезервированного типа ресурса VirtualMachines.

PaymentDetail

Сведения об оплате, связанной с заказом на резервирование.

PaymentStatus

Описывает, будет ли платеж завершен, не выполнен, отменен или запланирован в будущем.

Price

Сведения о ценах, содержащие сумму и код валюты

PricingCurrencyTotal

Сумма, которую корпорация Майкрософт использует для записи. Используется при возврате средств для расчета лимита возмещения. Налог не включен. Эта цена заблокирована за 30 дней до истечения срока действия.

PurchaseRequest

Запрос на покупку резервирования

ReservationBillingPlan

Представлять планы выставления счетов.

ReservationStatusCode
ReservationTerm

Представляет термин резервирования.

ReservedResourceProperties

Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо.

ReservedResourceType

Тип зарезервированного ресурса.

SkuName

Имя 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

Свойства для ответа о расчете цены

CalculatePriceResponseProperties

Свойства для ответа о расчете цены

Имя Тип Описание
billingCurrencyTotal

BillingCurrencyTotal

Валюта и сумма, которую клиент будет взимать в местной валюте клиента. Налог не включен.

grandTotal

number

Общая сумма в валюте ценообразования.

isBillingPartnerManaged

boolean

Значение true, если выставление счетов управляется партнером Майкрософт. Используется только для учетных записей CSP.

isTaxIncluded

boolean

Включается ли налог в общую общую сумму

netTotal

number

Чистая общая сумма в валюте ценообразования.

paymentSchedule

PaymentDetail[]

Сведения об оплате, связанной с заказом на резервирование.

pricingCurrencyTotal

PricingCurrencyTotal

Сумма, которую корпорация Майкрософт использует для записи. Используется при возврате средств для расчета лимита возмещения. Налог не включен.

reservationOrderId

string

GUID, представляющий заказ на резервирование, который можно разместить после вычисления цены.

skuDescription

string

Описание приобретаемого номера SKU.

skuTitle

string

Название приобретаемого номера SKU.

taxTotal

number

Сумма налога в валюте ценообразования.

Error

Сведения об ошибках.

Имя Тип Описание
error

ExtendedErrorInfo

Расширенные сведения об ошибке, включая код ошибки и сообщение об ошибке

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

ErrorResponseCode

Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос

message

string

ExtendedStatusInfo

Имя Тип Описание
message

string

Сообщение с подробными сведениями о коде состояния.

statusCode

ReservationStatusCode

InstanceFlexibility

При включении этого параметра скидка на резервирование применяется к другим виртуальным машинам в той же группе размера виртуальных машин. Укажите только для зарезервированного типа ресурса VirtualMachines.

Имя Тип Описание
Off

string

On

string

PaymentDetail

Сведения об оплате, связанной с заказом на резервирование.

Имя Тип Описание
billingAccount

string

Отображает учетную запись, которая взимается за этот платеж.

billingCurrencyTotal

Price

Сумма, взимаемая в валюте выставления счетов. Налог не включен. Имеет значение NULL для будущих платежей.

dueDate

string

Дата, когда необходимо выполнить платеж.

extendedStatusInfo

ExtendedStatusInfo

paymentDate

string

Дата завершения транзакции. Имеет значение NULL при планировании.

pricingCurrencyTotal

Price

Сумма в валюте ценообразования. Налог не включен.

status

PaymentStatus

Описывает, будет ли платеж завершен, не выполнен, отменен или запланирован в будущем.

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

Запрос на покупку резервирования

Имя Тип Значение по умолчанию Описание
location

string

Регион Azure, в котором находится зарезервированный ресурс.

properties.appliedScopeProperties

AppliedScopeProperties

Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup

properties.appliedScopeType

AppliedScopeType

Тип примененной области.

properties.appliedScopes

string[]

Список подписок, к которым будет применено преимущество. Не указывайте, является ли AppliedScopeType общим. Это свойство будет нерекомендуемым и заменено на appliedScopeProperties вместо single AppliedScopeType.

properties.billingPlan

ReservationBillingPlan

Представлять планы выставления счетов.

properties.billingScopeId

string

Подписка, которая будет взиматься за приобретение резервирования или накопительного плана

properties.displayName

string

Понятное имя резервирования

properties.quantity

integer

Количество номеров SKU, которые являются частью резервирования.

properties.renew

boolean

False

Если задать для этого параметра значение true, будет автоматически приобретено новое резервирование в дату окончания срока действия.

properties.reservedResourceProperties

ReservedResourceProperties

Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо.

properties.reservedResourceType

ReservedResourceType

Тип зарезервированного ресурса.

properties.reviewDateTime

string

Это дата и время, когда необходимо проверить преимущество гибридного использования Azure.

properties.term

ReservationTerm

Представляет термин резервирования.

sku

SkuName

Имя 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

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