중국용 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 | 가격 책정 비율의 유형입니다. 지원되는 형식은 , Consumption SavingsPlanConsumption 및 DevTestConsumption 입니다Reservation . |
armSkuName | Standard_F16s | Azure에 등록된 SKU 이름 |
용어 | 3년 | 용어 길이입니다. 예약 기간 또는 저축 계획 요금을 얻기 위해 커밋된 용어에 적용할 수 있습니다. |
isPrimaryMeterRegion | True | 미터 영역이 기본 미터로 설정되었는지 여부를 나타냅니다. 기본 미터는 요금 및 청구에 사용됩니다. |
다운로드한 CSV 파일 예제
다음은 CSV 파일의 데이터 서식을 테이블로 지정한 후의 데이터 예입니다.
표시된 가격이 예입니다.