다음을 통해 공유


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

AppliedScopeProperties

적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 tenantId 및 managementGroupId를 제공해야 합니다.

properties.appliedScopeType

AppliedScopeType

적용된 범위의 형식입니다.

properties.appliedScopes

string[]

혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 Single AppliedScopeType 대신 appliedScopeProperties로 대체됩니다.

properties.billingPlan

ReservationBillingPlan

청구 계획을 나타냅니다.

properties.billingScopeId

string

예약 또는 저축 플랜 구매에 대한 요금이 청구되는 구독

properties.displayName

string

예약의 이름

properties.quantity

integer (int32)

예약의 일부인 SKU의 수량입니다.

properties.renew

boolean

이를 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다.

properties.reservedResourceProperties

ReservedResourceProperties

예약된 각 리소스 종류에 한정된 속성입니다. 해당되지 않는 경우 필요하지 않습니다.

properties.reservedResourceType

ReservedResourceType

예약 중인 리소스의 형식입니다.

properties.reviewDateTime

string (date-time)

Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다.

properties.term

ReservationTerm

예약 기간을 나타냅니다.

sku

SkuName

sku의 이름

응답

Name 형식 Description
200 OK

CalculatePriceResponse

구매 ReservationOrder 대한 자세한 가격 정보

Other Status Codes

Error

예기치 않은 오류

예제

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
AppliedScopeProperties

적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 tenantId 및 managementGroupId를 제공해야 합니다.

AppliedScopeType

적용된 범위의 형식입니다.

BillingCurrencyTotal

갱신 구매에 대한 고객의 현지 통화로 청구되는 통화 및 금액입니다. 세금은 포함되지 않습니다.

CalculatePriceResponse

예약 가격 계산에 대한 응답입니다.

CalculatePriceResponseProperties

가격 응답 계산 속성

Error

오류 정보

ErrorResponseCode

서비스에서 들어오는 요청을 처리할 수 없는 이유를 설명하는 오류 코드

ExtendedErrorInfo

오류 코드 및 오류 메시지를 포함한 확장된 오류 정보

ExtendedStatusInfo
InstanceFlexibility

이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다.

PaymentDetail

예약 주문과 관련된 결제에 대한 정보입니다.

PaymentStatus

지불이 완료, 실패, 취소 또는 향후 예약되었는지 여부를 설명합니다.

Price

금액 및 통화 코드를 포함하는 가격 책정 정보

PricingCurrencyTotal

Microsoft에서 레코드에 사용하는 양입니다. 환불 한도를 계산하기 위해 환불 중에 사용됩니다. 세금은 포함되지 않습니다. 만료 30일 전에 잠긴 가격입니다.

PurchaseRequest

예약 구매 요청

ReservationBillingPlan

청구 계획을 나타냅니다.

ReservationStatusCode
ReservationTerm

예약 기간을 나타냅니다.

ReservedResourceProperties

예약된 각 리소스 종류에 한정된 속성입니다. 해당되지 않는 경우 필요하지 않습니다.

ReservedResourceType

예약 중인 리소스의 형식입니다.

SkuName

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

가격 응답 계산 속성

CalculatePriceResponseProperties

가격 응답 계산 속성

Name 형식 Description
billingCurrencyTotal

BillingCurrencyTotal

고객의 현지 통화로 청구되는 통화 및 금액입니다. 세금은 포함되지 않습니다.

grandTotal

number (double)

가격 책정 통화의 총 금액입니다.

isBillingPartnerManaged

boolean

청구가 Microsoft 파트너에 의해 관리되는 경우 True입니다. CSP 계정에만 사용됩니다.

isTaxIncluded

boolean

세금이 총합계에 포함되는지 여부

netTotal

number (double)

가격 책정 통화의 순 총 금액입니다.

paymentSchedule

PaymentDetail[]

예약 주문과 관련된 결제에 대한 정보입니다.

pricingCurrencyTotal

PricingCurrencyTotal

Microsoft에서 레코드에 사용하는 양입니다. 환불 한도를 계산하기 위해 환불 중에 사용됩니다. 세금은 포함되지 않습니다.

reservationOrderId

string

가격을 계산한 후 배치할 수 있는 예약 순서를 나타내는 GUID입니다.

skuDescription

string

구매 중인 sku에 대한 설명입니다.

skuTitle

string

구매 중인 sku의 제목입니다.

taxTotal

number (double)

가격 책정 통화의 세금 금액입니다.

Error

오류 정보

Name 형식 Description
error

ExtendedErrorInfo

오류 코드 및 오류 메시지를 포함한 확장된 오류 정보

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

ErrorResponseCode

서비스에서 들어오는 요청을 처리할 수 없는 이유를 설명하는 오류 코드

message

string

ExtendedStatusInfo

Name 형식 Description
message

string

상태 코드에 대한 자세한 정보를 제공하는 메시지입니다.

statusCode

ReservationStatusCode

InstanceFlexibility

이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다.

Description
Off
On

PaymentDetail

예약 주문과 관련된 결제에 대한 정보입니다.

Name 형식 Description
billingAccount

string

이 결제에 대해 청구되는 계정을 표시합니다.

billingCurrencyTotal

Price

청구 통화로 청구되는 금액입니다. 세금은 포함되지 않습니다. 향후 결제에 대해 null인 경우

dueDate

string (date)

결제를 완료해야 하는 날짜입니다.

extendedStatusInfo

ExtendedStatusInfo

paymentDate

string (date)

트랜잭션이 완료된 날짜입니다. 예약될 때 null입니다.

pricingCurrencyTotal

Price

가격 책정 통화의 금액입니다. 세금은 포함되지 않습니다.

status

PaymentStatus

지불이 완료, 실패, 취소 또는 향후 예약되었는지 여부를 설명합니다.

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

AppliedScopeProperties

적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. AppliedScopeType이 ManagementGroup인 경우 tenantId 및 managementGroupId를 제공해야 합니다.

properties.appliedScopeType

AppliedScopeType

적용된 범위의 형식입니다.

properties.appliedScopes

string[]

혜택이 적용될 구독 목록입니다. AppliedScopeType이 공유되는지 지정하지 마세요. 이 속성은 더 이상 사용되지 않으며 Single AppliedScopeType 대신 appliedScopeProperties로 대체됩니다.

properties.billingPlan

ReservationBillingPlan

청구 계획을 나타냅니다.

properties.billingScopeId

string

예약 또는 저축 플랜 구매에 대한 요금이 청구되는 구독

properties.displayName

string

예약의 이름

properties.quantity

integer (int32)

예약의 일부인 SKU의 수량입니다.

properties.renew

boolean

False

이를 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다.

properties.reservedResourceProperties

ReservedResourceProperties

예약된 각 리소스 종류에 한정된 속성입니다. 해당되지 않는 경우 필요하지 않습니다.

properties.reservedResourceType

ReservedResourceType

예약 중인 리소스의 형식입니다.

properties.reviewDateTime

string (date-time)

Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다.

properties.term

ReservationTerm

예약 기간을 나타냅니다.

sku

SkuName

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

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