다음을 통해 공유


중국용 Azure 소매 가격 API

이 API는 중국의 모든 Azure 서비스에 대한 소매 요금을 얻을 수 있는 인증되지 않은 환경을 제공합니다. API를 사용하여 다른 지역 및 다른 SKU의 Azure 서비스 가격을 탐색합니다. 또한 API를 사용하면 SKU 및 지역에서 내부 분석 및 가격 비교를 위한 고유한 도구를 만들 수 있습니다. 이 문서의 정보는 중국에서 사용하기 위해 Azure 소매 가격 API에만 적용되는 정보를 다룹니다.

API 응답을 통해 중국의 모든 Azure 서비스에 대한 소매 요금이 포함된 CSV 파일을 다운로드하는 URL을 가져옵니다.

이 문서에 표시된 소매 가격이 예시입니다.

API 엔드포인트

https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
api-version Query True 문자열 이 작업에 사용할 API 버전

응답

이름 형식 설명
200 정상 DownloadURL OK. 요청이 성공했습니다.
기타 상태 코드 ErrorResponse 작업이 실패한 이유를 설명하는 오류 응답

샘플 요청

https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview

샘플 응답

Status code: 200
{
    "DownloadUrl": "https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>",
    "LastRefreshedAt": "2023-06-02T04:19:45Z",
    "ExpiryTime": ""2023-06-02T06:54:57.1059946Z"}"
}

정의

Name 설명
DownloadURL 생성된 보고서를 다운로드할 URL
ErrorDetails 오류의 세부 정보
ErrorResponse 오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 이유는 오류 메시지에 제공됩니다.

DownloadURL

생성된 보고서를 다운로드할 URL입니다.

이름 형식 설명
DownloadUrl 문자열 생성된 보고서를 다운로드할 URL
LastRefreshedAt 문자열 UTC로 데이터를 새로 고치는 시간입니다. 예: 2023-06-02T04:19:45Z
expiryTime 문자열 보고서 URL이 유효하지 않거나 만료되는 시간(UTC)입니다. 예: 2023-06-02T06:54:57.1059946Z

DownloadURL 사용

다음 정보는 API의 예제 응답입니다.

{"DownloadUrl":"https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>","LastRefreshedAt":"2023-06-02T04:19:45Z","ExpiryTime":"2023-06-02T06:54:57.1059946Z"}

URL의 따옴표 안에 콘텐츠를 복사한 다음 브라우저 주소에 붙여넣습니다. 그런 다음 주소로 이동하여 CSV 파일 다운로드를 시작합니다. 또는 ExpiryTime 문자열을 LastRefreshedAt 포함하지 마세요. 예를 들면 다음과 같습니다.

https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>

파일 다운로드가 AzureRetailPrices.csv 시작됩니다.

ErrorDetails

오류의 세부 정보입니다.

이름 형식 설명
code 문자열 오류 코드
message 문자열 작업이 실패한 이유를 나타내는 오류 메시지

ErrorResponse

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

다음은 몇 가지 오류 응답입니다.

  • 429 TooManyRequests - 요청이 제한됩니다. x-ms-ratelimit-microsoft.consumption-retry-after 헤더에 지정된 시간 동안 기다린 후 다시 시도하세요.
  • 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. Retry-After 헤더에 지정된 시간 동안 기다린 후 다시 시도하세요.
이름 형식 설명
error ErrorDetails 오류의 세부 정보

다운로드한 CSV 파일의 속성 세부 정보

다운로드한 CSV 파일에 포함된 모든 속성 세부 정보는 다음과 같습니다.

표시된 가격은 예입니다.

필드 예제 값 정의
currencyCode CNY 요금이 정의되고 가격을 반환하는 통화입니다. 중국의 서비스에는 항상 CNY입니다.
tierMinimumUnits 0 각 계층의 최소 단위입니다. 모든 단위에 대해 고정 가격 책정이 있는 서비스의 경우 값은 항상 0입니다. 계층화된 가격 책정이 있는 서비스의 경우 값은 각 계층의 최소 단위를 나타내는 것입니다.
retailPrice 0.869038 Microsoft 서비스의 소매 가격
unitPrice 0.869038 Microsoft 서비스의 소매 가격
armRegionName chinaeast2 서비스를 사용할 수 있는 Azure Resource Manager 지역
위치 CN 동부 2 리소스가 배포되는 Azure 데이터 센터
effectiveStartDate 2020-08-01T00:00:00Z 소매 가격이 적용되는 날짜를 표시합니다.
meterId f25b95bd-f9fa-5e85-a3e8-379259ae8dce 리소스의 고유 식별자
meterName D2/DS2 미터의 이름
Productid DZH318Z0BPVW 제품의 UniqueID
skuId DZH318Z0BPVW/00F9 SKU에 대한 UniqueID
productName Virtual Machines D 시리즈 Windows 제품 이름
skuName D2 SKU name
serviceName Virtual Machines 서비스 이름
serviceFamily Compute SKU의 서비스 제품군
unitOfMeasure 1시간 서비스에 대한 사용량 측정 방법
형식 Consumption 가격 책정 비율의 유형입니다. 지원되는 형식은 , ConsumptionSavingsPlanConsumptionDevTestConsumption입니다Reservation.
armSkuName Standard_F16s Azure에 등록된 SKU 이름
용어 3년 용어 길이입니다. 예약 기간 또는 저축 계획 요금을 얻기 위해 커밋된 용어에 적용할 수 있습니다.
isPrimaryMeterRegion True 미터 영역이 기본 미터로 설정되었는지 여부를 나타냅니다. 기본 미터는 요금 및 청구에 사용됩니다.

다운로드한 CSV 파일 예제

다음은 CSV 파일의 데이터 서식을 테이블로 지정한 후의 데이터 예입니다.

표시된 가격이 예입니다.

가격이 있는 CSV 파일 예제를 보여 주는 스크린샷