Reservation Order - Calculate
ReservationOrder
대한 가격을 계산합니다.
ReservationOrder
배치에 대한 가격을 계산합니다.
POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
지원되는 버전입니다. |
요청 본문
Name | 형식 | Description |
---|---|---|
location |
string |
예약된 리소스가 있는 Azure 지역입니다. |
properties.appliedScopeProperties |
적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 tenantId 및 managementGroupId를 제공해야 합니다. |
|
properties.appliedScopeType |
적용된 범위의 형식입니다. |
|
properties.appliedScopes |
string[] |
혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 Single AppliedScopeType 대신 appliedScopeProperties로 대체됩니다. |
properties.billingPlan |
청구 계획을 나타냅니다. |
|
properties.billingScopeId |
string |
예약 또는 저축 플랜 구매에 대한 요금이 청구되는 구독 |
properties.displayName |
string |
예약의 이름 |
properties.quantity |
integer (int32) |
예약의 일부인 SKU의 수량입니다. |
properties.renew |
boolean |
이를 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다. |
properties.reservedResourceProperties |
예약된 각 리소스 종류에 한정된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. |
|
properties.reservedResourceType |
예약 중인 리소스의 형식입니다. |
|
properties.reviewDateTime |
string (date-time) |
Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다. |
properties.term |
예약 기간을 나타냅니다. |
|
sku |
sku의 이름 |
응답
Name | 형식 | Description |
---|---|---|
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
}
}
]
}
}
정의
Name | Description |
---|---|
Applied |
적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 tenantId 및 managementGroupId를 제공해야 합니다. |
Applied |
적용된 범위의 형식입니다. |
Billing |
갱신 구매에 대한 고객의 현지 통화로 청구되는 통화 및 금액입니다. 세금은 포함되지 않습니다. |
Calculate |
예약 가격 계산에 대한 응답입니다. |
Calculate |
가격 응답 계산 속성 |
Error |
오류 정보 |
Error |
서비스에서 들어오는 요청을 처리할 수 없는 이유를 설명하는 오류 코드 |
Extended |
오류 코드 및 오류 메시지를 포함한 확장된 오류 정보 |
Extended |
|
Instance |
이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다. |
Payment |
예약 주문과 관련된 결제에 대한 정보입니다. |
Payment |
지불이 완료, 실패, 취소 또는 향후 예약되었는지 여부를 설명합니다. |
Price |
금액 및 통화 코드를 포함하는 가격 책정 정보 |
Pricing |
Microsoft에서 레코드에 사용하는 양입니다. 환불 한도를 계산하기 위해 환불 중에 사용됩니다. 세금은 포함되지 않습니다. 만료 30일 전에 잠긴 가격입니다. |
Purchase |
예약 구매 요청 |
Reservation |
청구 계획을 나타냅니다. |
Reservation |
|
Reservation |
예약 기간을 나타냅니다. |
Reserved |
예약된 각 리소스 종류에 한정된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. |
Reserved |
예약 중인 리소스의 형식입니다. |
Sku |
sku의 이름 |
AppliedScopeProperties
적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 tenantId 및 managementGroupId를 제공해야 합니다.
Name | 형식 | Description |
---|---|---|
displayName |
string |
표시 이름 |
managementGroupId |
string |
혜택을 적용해야 하는 관리 그룹의 정규화된 식별자입니다. |
resourceGroupId |
string |
리소스 그룹의 정규화된 식별자입니다. |
subscriptionId |
string |
구독의 정규화된 식별자입니다. |
tenantId |
string |
저축 계획이 혜택을 적용해야 하는 테넌트 ID입니다. |
AppliedScopeType
적용된 범위의 형식입니다.
값 | Description |
---|---|
ManagementGroup | |
Shared | |
Single |
BillingCurrencyTotal
갱신 구매에 대한 고객의 현지 통화로 청구되는 통화 및 금액입니다. 세금은 포함되지 않습니다.
Name | 형식 | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
이 구매 레코드에서 사용하는 통화에 대한 ISO 4217 3자 통화 코드입니다. |
CalculatePriceResponse
예약 가격 계산에 대한 응답입니다.
Name | 형식 | Description |
---|---|---|
properties |
가격 응답 계산 속성 |
CalculatePriceResponseProperties
가격 응답 계산 속성
Name | 형식 | Description |
---|---|---|
billingCurrencyTotal |
고객의 현지 통화로 청구되는 통화 및 금액입니다. 세금은 포함되지 않습니다. |
|
grandTotal |
number (double) |
가격 책정 통화의 총 금액입니다. |
isBillingPartnerManaged |
boolean |
청구가 Microsoft 파트너에 의해 관리되는 경우 True입니다. CSP 계정에만 사용됩니다. |
isTaxIncluded |
boolean |
세금이 총합계에 포함되는지 여부 |
netTotal |
number (double) |
가격 책정 통화의 순 총 금액입니다. |
paymentSchedule |
예약 주문과 관련된 결제에 대한 정보입니다. |
|
pricingCurrencyTotal |
Microsoft에서 레코드에 사용하는 양입니다. 환불 한도를 계산하기 위해 환불 중에 사용됩니다. 세금은 포함되지 않습니다. |
|
reservationOrderId |
string |
가격을 계산한 후 배치할 수 있는 예약 순서를 나타내는 GUID입니다. |
skuDescription |
string |
구매 중인 sku에 대한 설명입니다. |
skuTitle |
string |
구매 중인 sku의 제목입니다. |
taxTotal |
number (double) |
가격 책정 통화의 세금 금액입니다. |
Error
오류 정보
Name | 형식 | Description |
---|---|---|
error |
오류 코드 및 오류 메시지를 포함한 확장된 오류 정보 |
ErrorResponseCode
서비스에서 들어오는 요청을 처리할 수 없는 이유를 설명하는 오류 코드
값 | Description |
---|---|
ActivateQuoteFailed | |
AppliedScopesNotAssociatedWithCommerceAccount | |
AppliedScopesSameAsExisting | |
AuthorizationFailed | |
BadRequest | |
BillingCustomerInputError | |
BillingError | |
BillingPaymentInstrumentHardError | |
BillingPaymentInstrumentSoftError | |
BillingScopeIdCannotBeChanged | |
BillingTransientError | |
CalculatePriceFailed | |
CapacityUpdateScopesFailed | |
ClientCertificateThumbprintNotSet | |
CreateQuoteFailed | |
Forbidden | |
FulfillmentConfigurationError | |
FulfillmentError | |
FulfillmentOutOfStockError | |
FulfillmentTransientError | |
HttpMethodNotSupported | |
InternalServerError | |
InvalidAccessToken | |
InvalidFulfillmentRequestParameters | |
InvalidHealthCheckType | |
InvalidLocationId | |
InvalidRefundQuantity | |
InvalidRequestContent | |
InvalidRequestUri | |
InvalidReservationId | |
InvalidReservationOrderId | |
InvalidSingleAppliedScopesCount | |
InvalidSubscriptionId | |
InvalidTenantId | |
MissingAppliedScopesForSingle | |
MissingTenantId | |
NoValidReservationsToReRate | |
NonsupportedAccountId | |
NotSpecified | |
NotSupportedCountry | |
OperationCannotBePerformedInCurrentState | |
OperationFailed | |
PatchValuesSameAsExisting | |
PaymentInstrumentNotFound | |
PurchaseError | |
ReRateOnlyAllowedForEA | |
RefundLimitExceeded | |
ReservationIdNotInReservationOrder | |
ReservationOrderCreationFailed | |
ReservationOrderIdAlreadyExists | |
ReservationOrderNotEnabled | |
ReservationOrderNotFound | |
RiskCheckFailed | |
RoleAssignmentCreationFailed | |
SelfServiceRefundNotSupported | |
ServerTimeout | |
UnauthenticatedRequestsThrottled | |
UnsupportedReservationTerm |
ExtendedErrorInfo
오류 코드 및 오류 메시지를 포함한 확장된 오류 정보
Name | 형식 | Description |
---|---|---|
code |
서비스에서 들어오는 요청을 처리할 수 없는 이유를 설명하는 오류 코드 |
|
message |
string |
ExtendedStatusInfo
Name | 형식 | Description |
---|---|---|
message |
string |
상태 코드에 대한 자세한 정보를 제공하는 메시지입니다. |
statusCode |
InstanceFlexibility
이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다.
값 | Description |
---|---|
Off | |
On |
PaymentDetail
예약 주문과 관련된 결제에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
billingAccount |
string |
이 결제에 대해 청구되는 계정을 표시합니다. |
billingCurrencyTotal |
청구 통화로 청구되는 금액입니다. 세금은 포함되지 않습니다. 향후 결제에 대해 null인 경우 |
|
dueDate |
string (date) |
결제를 완료해야 하는 날짜입니다. |
extendedStatusInfo | ||
paymentDate |
string (date) |
트랜잭션이 완료된 날짜입니다. 예약될 때 null입니다. |
pricingCurrencyTotal |
가격 책정 통화의 금액입니다. 세금은 포함되지 않습니다. |
|
status |
지불이 완료, 실패, 취소 또는 향후 예약되었는지 여부를 설명합니다. |
PaymentStatus
지불이 완료, 실패, 취소 또는 향후 예약되었는지 여부를 설명합니다.
값 | Description |
---|---|
Cancelled | |
Failed | |
Scheduled | |
Succeeded |
Price
금액 및 통화 코드를 포함하는 가격 책정 정보
Name | 형식 | Description |
---|---|---|
amount |
number (double) |
|
currencyCode |
string |
이 구매 레코드에서 사용하는 통화에 대한 ISO 4217 3자 통화 코드입니다. |
PricingCurrencyTotal
Microsoft에서 레코드에 사용하는 양입니다. 환불 한도를 계산하기 위해 환불 중에 사용됩니다. 세금은 포함되지 않습니다. 만료 30일 전에 잠긴 가격입니다.
Name | 형식 | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
이 구매 레코드에서 사용하는 통화에 대한 ISO 4217 3자 통화 코드입니다. |
PurchaseRequest
예약 구매 요청
Name | 형식 | Default value | Description |
---|---|---|---|
location |
string |
예약된 리소스가 있는 Azure 지역입니다. |
|
properties.appliedScopeProperties |
적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 tenantId 및 managementGroupId를 제공해야 합니다. |
||
properties.appliedScopeType |
적용된 범위의 형식입니다. |
||
properties.appliedScopes |
string[] |
혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 Single AppliedScopeType 대신 appliedScopeProperties로 대체됩니다. |
|
properties.billingPlan |
청구 계획을 나타냅니다. |
||
properties.billingScopeId |
string |
예약 또는 저축 플랜 구매에 대한 요금이 청구되는 구독 |
|
properties.displayName |
string |
예약의 이름 |
|
properties.quantity |
integer (int32) |
예약의 일부인 SKU의 수량입니다. |
|
properties.renew |
boolean |
False |
이를 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다. |
properties.reservedResourceProperties |
예약된 각 리소스 종류에 한정된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. |
||
properties.reservedResourceType |
예약 중인 리소스의 형식입니다. |
||
properties.reviewDateTime |
string (date-time) |
Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다. |
|
properties.term |
예약 기간을 나타냅니다. |
||
sku |
sku의 이름 |
ReservationBillingPlan
청구 계획을 나타냅니다.
값 | Description |
---|---|
Monthly | |
Upfront |
ReservationStatusCode
값 | Description |
---|---|
Active | |
Expired | |
Merged | |
None | |
PaymentInstrumentError | |
Pending | |
Processing | |
PurchaseError | |
Split | |
Succeeded |
ReservationTerm
예약 기간을 나타냅니다.
값 | Description |
---|---|
P1Y | |
P3Y | |
P5Y |
ReservedResourceProperties
예약된 각 리소스 종류에 한정된 속성입니다. 해당되지 않는 경우 필요하지 않습니다.
Name | 형식 | Description |
---|---|---|
instanceFlexibility |
이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다. |
ReservedResourceType
예약 중인 리소스의 형식입니다.
값 | Description |
---|---|
AVS | |
AppService | |
AzureDataExplorer | |
AzureFiles | |
BlockBlob | |
CosmosDb | |
DataFactory | |
Databricks | |
DedicatedHost | |
ManagedDisk | |
MariaDb | |
MySql | |
NetAppStorage | |
PostgreSql | |
RedHat | |
RedHatOsa | |
RedisCache | |
SapHana | |
SqlAzureHybridBenefit | |
SqlDataWarehouse | |
SqlDatabases | |
SqlEdge | |
SuseLinux | |
VMwareCloudSimple | |
VirtualMachineSoftware | |
VirtualMachines |
SkuName
sku의 이름
Name | 형식 | Description |
---|---|---|
name |
string |