Price Sheet - Download By Billing Account

서비스:

Cost Management

API 버전:

2024-08-01

등록 ID에 따라 제공된 청구 기간의 가격표를 비동기적으로 생성합니다. 기업계약 고객을 위한 것입니다.

버전 2024-08-01 마이그레이션

새 URI와 함께 2024-08-01 API 버전을 사용할 수 있습니다.

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

아래에 자세히 설명된 새 스키마를 사용하여 가격표의 새 버전은 추가 정보를 제공하고 현재 청구 기간의 RI(Azure Reserved Instances)에 대한 가격을 포함합니다. 이전 RI(Azure Reserved Instance) 가격 책정에 대한 지속적인 레코드를 유지 관리하는 경우 새 청구 기간을 입력할 때 Azure 가격표를 다운로드하는 것이 좋습니다.

EA Azure 가격표는 지난 13개월 동안 청구 기간에 사용할 수 있습니다. 13개월 이전의 청구 기간에 대한 가격표를 요청하려면 고객 지원에 문의하세요.

Azure 가격표 다운로드 환경은 단일 .csv 파일에서 각각 최대 크기가 75MB인 여러 .csv 파일이 포함된 zip 파일로 업데이트되었습니다. 2023-11-01 버전은 http POST 메서드를 사용하도록 업그레이드되었습니다. 자세한 내용은 아래에서 확인할 수 있습니다.

모든 버전의 Microsoft.Consumption Azure 가격표 - 청구 계정으로 다운로드(2022-06-01 포함, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01)는 2026년 6월 1일에 사용 중지될 예정이며 이 날짜 이후에는 더 이상 지원되지 않습니다.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountId	path	True	string	BillingAccount ID
billingPeriodName	path	True	string	청구 기간 이름입니다. regex 패턴: ^[0-9]*$
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	OperationStatus	그래. 요청이 성공했습니다.
202 Accepted		허용. 헤더 Location: string Retry-After: string
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

EAPriceSheetForBillingPeriod

샘플 요청

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

샘플 응답

상태 코드:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

상태 코드:

200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

정의

Name	Description
EAPriceSheetProperties	EA 가격표의 속성입니다. 버전 2024-08-01에서 지원되는 속성은 다음과 같습니다.
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
OperationStatus	장기 실행 작업의 상태입니다.
OperationStatusType	장기 실행 작업의 상태입니다.

EAPriceSheetProperties

EA 가격표의 속성입니다. 버전 2024-08-01에서 지원되는 속성은 다음과 같습니다.

Name	형식	Description
basePrice	string	고객이 로그인한 시점의 단가 또는 서비스 미터 GA 시작 시의 단가(로그온 후인 경우)입니다. 기업계약 사용자에게 적용됩니다.
currencyCode	string	기업계약이 체결된 통화
effectiveEndDate	string	가격표 청구 기간의 유효 종료 날짜
effectiveStartDate	string	가격표 청구 기간의 유효 시작 날짜
enrollmentNumber	string	EA 청구 계정에 대한 고유 식별자입니다.
includedQuantity	string	EA 고객이 증분 요금 없이 사용할 수 있는 특정 서비스의 수량입니다.
marketPrice	string	지정된 제품 또는 서비스의 현재 정가입니다. 이 가격은 어떠한 협상도 하지 않으며 Microsoft 계약 유형을 기반으로 합니다. PriceType 소비의 경우 시장 가격은 종량제 가격으로 반영됩니다. PriceType 저축 플랜의 경우 시장 가격은 해당 약정 기간에 대한 종량제 가격 위에 저축 플랜 혜택을 반영합니다. PriceType ReservedInstance의 경우 시장 가격은 1년 또는 3년 약정의 총 가격을 반영합니다. 참고: 협상이 없는 EA 고객의 경우 시장 가격이 단가와 다른 소수 자릿수로 반올림된 것처럼 보일 수 있습니다.
meterCategory	string	측정기의 분류 범주 이름입니다. 예를 들어 클라우드 서비스, 네트워킹 등이 있습니다.
meterId	string	미터의 고유 식별자
meterName	string	미터의 이름입니다. 미터는 Azure 서비스의 배포 가능한 리소스를 나타냅니다.
meterRegion	string	서비스의 미터를 사용할 수 있는 Azure 지역의 이름입니다.
meterSubCategory	string	미터 하위 분류 범주의 이름입니다.
meterType	string	미터 형식의 이름
offerId	string	이 미터와 연결된 Azure 제품을 결정합니다. [Azure 제품에 대해 자세히 알아보기] (https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber	string	미터와 연결된 부품 번호
priceType	string	제품의 가격 유형입니다. 예를 들어 priceType을 소비로 사용하는 종량제 요금이 있는 Azure 리소스입니다. 다른 가격 유형에는 ReservedInstance 및 저축 계획이 포함됩니다.
product	string	요금이 발생하는 제품의 이름입니다.
productId	string	측정기가 사용되는 제품의 고유 식별자입니다.
serviceFamily	number	Azure 서비스의 유형입니다. 예를 들어 컴퓨팅, 분석 및 보안입니다.
skuId	string	SKU의 고유 식별자
term	string	Azure 저축 계획 또는 예약 기간의 기간 - 1년 또는 3년(P1Y 또는 P3Y)
unitOfMeasure	string	서비스에 대한 사용량을 측정하는 방법입니다. 참고: "Unit" 필드가 버전 2023-11-01에서 "UnitofMeasure"의 중복으로 제거되었습니다. "UnitOfMeasure" 필드를 사용하세요.
unitPrice	string	지정된 제품 또는 서비스에 대한 청구 시점의 단가로, 시장 가격을 기준으로 협상된 할인을 포함합니다. PriceType ReservedInstance의 경우 단가는 할인을 포함한 1년 또는 3년 약정의 총 비용을 반영합니다. 참고: 단가는 서비스에 계층 간에 차등 가격이 있는 경우 사용량 세부 정보 다운로드의 유효 가격과 동일하지 않습니다. 서비스에 다중 계층 가격이 있는 경우 유효 가격은 계층 전체에서 혼합된 요금이며 계층별 단가를 표시하지 않습니다. 혼합 가격 또는 유효 가격은 여러 계층에 걸쳐 있는 소비된 수량의 순 가격입니다(각 계층에 특정 단가가 있음).

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

• 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

• 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

OperationStatus

장기 실행 작업의 상태입니다.

Name	형식	Description
properties.downloadFileProperties	EAPriceSheetProperties	다운로드한 파일의 속성
properties.downloadUrl	string	가격표를 다운로드할 링크(URL)입니다.
properties.validTill	string	링크 유효성을 다운로드합니다.
status	OperationStatusType	장기 실행 작업의 상태입니다.

OperationStatusType

장기 실행 작업의 상태입니다.

Name	형식	Description
Completed	string
Failed	string
Running	string