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 |
적용된 scope 형식과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 필수 및 tenantId 및 managementGroupId를 제공해야 합니다. |
|
properties.appliedScopeType |
적용된 범위의 형식입니다. |
|
properties.appliedScopes |
string[] |
혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유인지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 Single AppliedScopeType 대신 appliedScopeProperties로 대체됩니다. |
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의 이름 |
응답
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 |
적용된 scope 형식과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. 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
적용된 scope 형식과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 필수이며 tenantId 및 managementGroupId를 제공해야 합니다.
Name | 형식 | Description |
---|---|---|
displayName |
string |
표시 이름 |
managementGroupId |
string |
혜택을 적용해야 하는 관리 그룹의 정규화된 식별자입니다. |
resourceGroupId |
string |
리소스 그룹의 정규화된 식별자입니다. |
subscriptionId |
string |
구독의 정규화된 식별자입니다. |
tenantId |
string |
저축 계획이 혜택을 적용해야 하는 테넌트 ID입니다. |
AppliedScopeType
적용된 범위의 형식입니다.
Name | 형식 | Description |
---|---|---|
ManagementGroup |
string |
|
Shared |
string |
|
Single |
string |
BillingCurrencyTotal
갱신 구매를 위해 고객의 현지 통화로 청구되는 통화 및 금액입니다. 세금은 포함되지 않습니다.
Name | 형식 | Description |
---|---|---|
amount |
number |
|
currencyCode |
string |
이 구매 레코드에서 사용하는 통화에 대한 ISO 4217 3자 통화 코드입니다. |
CalculatePriceResponse
예약 가격 계산의 응답입니다.
Name | 형식 | Description |
---|---|---|
properties |
가격 응답 계산 속성 |
CalculatePriceResponseProperties
가격 응답 계산 속성
Name | 형식 | Description |
---|---|---|
billingCurrencyTotal |
고객의 현지 통화로 청구되는 통화 및 금액입니다. 세금은 포함되지 않습니다. |
|
grandTotal |
number |
총 가격 책정 통화 금액입니다. |
isBillingPartnerManaged |
boolean |
True이면 Microsoft 파트너에서 청구를 관리합니다. CSP 계정에만 사용됩니다. |
isTaxIncluded |
boolean |
총합계에 세금이 포함되는지 여부 |
netTotal |
number |
가격 책정 통화의 순 총 금액입니다. |
paymentSchedule |
예약 주문과 관련된 결제에 대한 정보입니다. |
|
pricingCurrencyTotal |
Microsoft에서 레코드에 사용하는 양입니다. 환불 한도를 계산하는 데 환불 중에 사용됩니다. 세금은 포함되지 않습니다. |
|
reservationOrderId |
string |
가격을 계산한 후 배치할 수 있는 예약 순서를 나타내는 GUID입니다. |
skuDescription |
string |
구매 중인 sku에 대한 설명입니다. |
skuTitle |
string |
구매 중인 sku의 제목입니다. |
taxTotal |
number |
가격 책정 통화의 세금 금액입니다. |
Error
오류 정보
Name | 형식 | Description |
---|---|---|
error |
오류 코드 및 오류 메시지를 포함한 확장된 오류 정보 |
ErrorResponseCode
서비스에서 들어오는 요청을 처리할 수 없는 이유를 설명하는 오류 코드
Name | 형식 | 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
오류 코드 및 오류 메시지를 포함한 확장된 오류 정보
Name | 형식 | Description |
---|---|---|
code |
서비스에서 들어오는 요청을 처리할 수 없는 이유를 설명하는 오류 코드 |
|
message |
string |
ExtendedStatusInfo
Name | 형식 | Description |
---|---|---|
message |
string |
상태 코드에 대한 자세한 정보를 제공하는 메시지입니다. |
statusCode |
InstanceFlexibility
이를 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다.
Name | 형식 | Description |
---|---|---|
Off |
string |
|
On |
string |
PaymentDetail
예약 주문과 관련된 결제에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
billingAccount |
string |
이 결제에 대해 청구되는 계정을 표시합니다. |
billingCurrencyTotal |
청구 통화로 청구되는 금액입니다. 세금은 포함되지 않습니다. 향후 결제에 대해 null인 경우 |
|
dueDate |
string |
결제를 완료해야 하는 날짜입니다. |
extendedStatusInfo | ||
paymentDate |
string |
트랜잭션이 완료된 날짜입니다. 예약된 경우 null입니다. |
pricingCurrencyTotal |
가격 책정 통화의 금액입니다. 세금은 포함되지 않습니다. |
|
status |
결제가 완료, 실패, 취소 또는 향후 예약되었는지 여부를 설명합니다. |
PaymentStatus
결제가 완료, 실패, 취소 또는 향후 예약되었는지 여부를 설명합니다.
Name | 형식 | Description |
---|---|---|
Cancelled |
string |
|
Failed |
string |
|
Scheduled |
string |
|
Succeeded |
string |
Price
금액 및 통화 코드가 포함된 가격 책정 정보
Name | 형식 | Description |
---|---|---|
amount |
number |
|
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 |
적용된 scope 형식과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 필수이며 tenantId 및 managementGroupId를 제공해야 합니다. |
||
properties.appliedScopeType |
적용된 범위의 형식입니다. |
||
properties.appliedScopes |
string[] |
혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유인지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 Single AppliedScopeType 대신 appliedScopeProperties로 대체됩니다. |
|
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
청구 플랜을 나타냅니다.
Name | 형식 | Description |
---|---|---|
Monthly |
string |
|
Upfront |
string |
ReservationStatusCode
Name | 형식 | Description |
---|---|---|
Active |
string |
|
Expired |
string |
|
Merged |
string |
|
None |
string |
|
PaymentInstrumentError |
string |
|
Pending |
string |
|
Processing |
string |
|
PurchaseError |
string |
|
Split |
string |
|
Succeeded |
string |
ReservationTerm
예약 기간을 나타냅니다.
Name | 형식 | Description |
---|---|---|
P1Y |
string |
|
P3Y |
string |
|
P5Y |
string |
ReservedResourceProperties
각 예약된 리소스 종류와 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다.
Name | 형식 | Description |
---|---|---|
instanceFlexibility |
이를 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다. |
ReservedResourceType
예약되는 리소스의 형식입니다.
Name | 형식 | 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
sku의 이름
Name | 형식 | Description |
---|---|---|
name |
string |