다음을 통해 공유


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

적용된 scope 형식과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. 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

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

properties.renew

boolean

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

properties.reservedResourceProperties

ReservedResourceProperties

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

properties.reservedResourceType

ReservedResourceType

예약되는 리소스의 형식입니다.

properties.reviewDateTime

string

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

적용된 scope 형식과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. 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

적용된 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

가격 응답 계산 속성

CalculatePriceResponseProperties

가격 응답 계산 속성

Name 형식 Description
billingCurrencyTotal

BillingCurrencyTotal

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

grandTotal

number

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

isBillingPartnerManaged

boolean

True이면 Microsoft 파트너에서 청구를 관리합니다. CSP 계정에만 사용됩니다.

isTaxIncluded

boolean

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

netTotal

number

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

paymentSchedule

PaymentDetail[]

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

pricingCurrencyTotal

PricingCurrencyTotal

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

reservationOrderId

string

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

skuDescription

string

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

skuTitle

string

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

taxTotal

number

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

Error

오류 정보

Name 형식 Description
error

ExtendedErrorInfo

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

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

ErrorResponseCode

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

message

string

ExtendedStatusInfo

Name 형식 Description
message

string

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

statusCode

ReservationStatusCode

InstanceFlexibility

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

Name 형식 Description
Off

string

On

string

PaymentDetail

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

Name 형식 Description
billingAccount

string

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

billingCurrencyTotal

Price

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

dueDate

string

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

extendedStatusInfo

ExtendedStatusInfo

paymentDate

string

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

pricingCurrencyTotal

Price

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

status

PaymentStatus

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

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

AppliedScopeProperties

적용된 scope 형식과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. 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

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

properties.renew

boolean

False

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

properties.reservedResourceProperties

ReservedResourceProperties

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

properties.reservedResourceType

ReservedResourceType

예약되는 리소스의 형식입니다.

properties.reviewDateTime

string

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

properties.term

ReservationTerm

예약 기간을 나타냅니다.

sku

SkuName

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

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