기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Price List Bulk API를 사용하여 AWS 가격표 파일 가져오기
| |
| --- |
| 에 대한 피드백을 제공하려면이 [간단한 설문 조사를](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA) AWS 가격표완료하세요. 응답은 익명으로 처리됩니다. **참고:** 이 설문조사는 영어로만 진행됩니다. |
다음 작업을 수행하려는 경우 Price List Bulk API를 사용하는 것이 좋습니다.
+ AWS 서비스에 대한 많은 양의 제품 및 가격 정보를 사용합니다.
+ 대량 처리와 같이 AWS 서비스에 대한 처리량이 높은 제품 및 가격 정보를 사용합니다.
또한 Price List Query API에서 사용 사례에 대한 충분한 처리량과 할당량을 제공하지 않는 경우에도 Price List Bulk API를 사용합니다.
AWS Price List Bulk API를 사용하여 프로그래밍 방식으로 가격표 파일을 찾고 다운로드하는 것이 좋습니다. 가격표 파일의 URL을 가져오려면 다음 단계를 참조하세요.
AWS Price List Bulk API를 사용하지 않으려면 가격표 파일을 수동으로 다운로드할 수 있습니다. 자세한 내용은 [가격표 파일을 수동으로 가져오기](using-the-aws-price-list-bulk-api-fetching-price-list-files-manually.md) 단원을 참조하십시오.
### 1단계: 사용 가능한 결과 AWS 서비스
`DescribeServices` API 작업을 사용하여 Price List Bulk API에서 지원하는 사용 가능한 모든 AWS 서비스 를 찾을 수 있습니다. 이 API 작업은 서비스 목록의 `ServiceCode` 값을 반환합니다. 나중에 이 값을 사용하여 관련 가격표 파일을 찾을 수 있습니다.
**Example 예: 사용 가능한 서비스 찾기**
다음 명령은 사용 가능한 AWS 서비스를 찾는 방법을 보여줍니다.
```
aws pricing describe-services --region us-east-1
```
AWS 리전 는 Price List Bulk API의 API 엔드포인트입니다. 엔드포인트는 제품 또는 서비스 속성과 관련이 없습니다.
**응답**
```
{
"FormatVersion": "aws_v1",
"NextToken": "abcdefg123",
"Services": [
{
"AttributeNames": [
"volumeType",
"maxIopsvolume",
"instanceCapacity10xlarge",
"locationType",
"operation"
],
"ServiceCode": "AmazonEC2"
},
{
"AttributeNames": [
"productFamily",
"volumeType",
"engineCode",
"memory"
],
"ServiceCode": "AmazonRDS"
},
{...}
]
}
```
이 API 작업에 대한 자세한 내용은 API 참조의 [DescribeServices](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html) 및 [언어별 AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso). *AWS 결제 및 비용 관리 *
**참고**
`DescribeServices` API는 현재 Savings Plans에 `serviceCodes` 대해를 반환하지 않지만 후속 API 호출에서 Savings Plans`serviceCodes`을 사용하려면 다음이 필요합니다.
| ServiceCode | SavingsPlanCode |
| --- | --- |
| ComputeSavingsPlans | AWSComputeSavingsPlan |
| MachineLearningSavingsPlans | AWSMachineLearningSavingsPlans |
| DatabaseSavingsPlans | AWSDatabaseSavingsPlans |
`ListPriceLists` 및 `GetPriceListFileUrl` API 작업을 수행할 때 `ServiceCode` 값을 사용합니다. `SavingsPlanCode`는 APIs를 사용하는 대신 가격표 파일을 수동으로 다운로드하는 경우에만 필요합니다.
### 2단계: 사용 가능한에 대한 가격표 파일 찾기 AWS 서비스
`ListPriceLists` API 작업을 사용하여 볼 수 있는 권한이 있는 가격표 참조 목록을 가져올 수 있습니다. 결과를 필터링하려면 `ServiceCode`, `CurrencyCode` 및 `EffectiveDate` 파라미터를 지정할 수 있습니다.
AWS 리전 는 Price List Bulk API의 API 엔드포인트입니다. 엔드포인트는 제품 또는 서비스 속성과 관련이 없습니다.
#### 가격표 파일을 찾는 예제
**Example 예: 모든에 대한 가격표 파일 찾기 AWS 리전**
`--region-code` 파리미터를 지정하지 않는 경우 API 작업에서는 사용 가능한 모든 AWS 리전에서 가격표 파일 참조를 반환합니다.
```
aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --effective-date "2023-04-03 00:00"
```
**응답**
```
{
"NextToken": "abcd1234",
"PriceLists": [
{
"CurrencyCode": "USD",
"FileFormats": [ "json", "csv" ],
"PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1",
"RegionCode": "us-east-1"
},
{
"CurrencyCode": "USD",
"FileFormats": [ "json", "csv" ],
"PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
"RegionCode": "us-west-2"
},
...
]
}
```
**Example 예: 특정 리전의 가격표 파일 찾기**
`RegionCode` 파리미터를 지정하는 경우 API 작업에서는 해당 리전과 관련된 가격표 파일 참조를 반환합니다. 과거 가격표 파일을 찾으려면 `EffectiveDate` 파라미터를 사용합니다. 예를 들어, 과거 날짜를 지정하여 특정 가격표 파일을 찾을 수 있습니다.
그런 다음 응답에서 [GetPriceListFileUrl](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html) API 작업에 `PriceListArn` 값을 사용하여 원하는 가격표 파일을 가져올 수 있습니다.
```
aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --region-code us-west-2 --effective-date "2023-04-03 00:00"
```
**응답**
```
{
"PriceLists": [
{
"CurrencyCode": "USD",
"FileFormats": [ "json", "csv" ],
"PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
"RegionCode": "us-west-2"
}
]
}
```
이 API 작업에 대한 자세한 내용은 API 참조의 [ListPriceLists](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html) 및 [언어별 AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html#API_pricing_ListPriceLists_SeeAlso). *AWS 결제 및 비용 관리 *
### 3단계: 특정 가격표 파일 가져오기
`GetPriceListFileUrl` API 작업을 사용하여 가격표 파일의 URL을 가져올 수 있습니다. 이 URL은 [1단계](#price-bulk-api-step-1-find-available-services)와 [2단계](#price-list-bulk-api-step-2-find-available-price-list-files)의 `ListPriceLists` 응답에서 검색한 `PriceListArn` 및 `FileFormats` 값에 기반합니다.
**Example 예: 특정 가격표 파일 가져오기**
다음 명령은 Amazon RDS용 특정 가격표 파일의 URL을 가져옵니다.
```
aws pricing get-price-list-file-url --price-list-arn arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1 --file-format json --region us-east-1
```
**응답**
```
{
"Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json"
}
```
응답에서 이 URL을 사용하여 가격표 파일을 다운로드할 수 있습니다.
이 API 작업에 대한 자세한 내용은 다음 주제를 참조하세요.
+ [GetPriceListFileUrl](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html) *AWS 결제 및 비용 관리 API 참조*의 및 [언어별 AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso)
+ [가격표 파일 읽기](bulk-api-reading-price-list-files.md)