

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mendapatkan file daftar AWS harga menggunakan API Massal Daftar Harga
<a name="using-the-aws-price-list-bulk-api"></a>


|  | 
| --- |
| Untuk memberikan umpan balik tentang Daftar Harga AWS, selesaikan [survei singkat](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA) ini. Tanggapan Anda akan anonim. **Catatan:** Survei ini hanya dalam bahasa Inggris. | 

Kami menyarankan Anda menggunakan Price List Bulk API ketika Anda ingin melakukan tugas-tugas berikut:
+ Konsumsi sejumlah besar produk dan informasi harga untuk Layanan AWS.
+ Konsumsi informasi produk dan harga dengan throughput tinggi untuk Layanan AWS, seperti pemrosesan dalam jumlah besar.

Selain itu, jika API Kueri Daftar Harga tidak menyediakan throughput dan kuota yang memadai untuk kasus penggunaan Anda, gunakan API Massal Daftar Harga.<a name="using-the-aws-price-list-bulk-api-fetching-price-list-files"></a>

Kami menyarankan Anda menggunakan API Massal Daftar AWS Harga untuk menemukan dan mengunduh file daftar harga secara terprogram. Untuk mendapatkan URL file daftar harga, lihat langkah-langkah berikut.

Jika Anda tidak ingin menggunakan API Massal Daftar AWS Harga, Anda dapat mengunduh file daftar harga secara manual. Untuk informasi selengkapnya, lihat [Mendapatkan file daftar harga secara manual](using-the-aws-price-list-bulk-api-fetching-price-list-files-manually.md).

### Langkah 1: Menemukan tersedia Layanan AWS
<a name="price-bulk-api-step-1-find-available-services"></a>

Gunakan operasi `DescribeServices` API untuk menemukan semua Layanan AWS yang tersedia yang didukung oleh API Massal Daftar Harga. Operasi API ini mengembalikan `ServiceCode` nilai dari daftar layanan. Anda menggunakan nilai ini nanti untuk menemukan file daftar harga yang relevan.

**Example Contoh: Temukan layanan yang tersedia**  
Perintah berikut menunjukkan cara menemukan yang tersedia Layanan AWS.  

```
aws pricing describe-services --region us-east-1
```
 Wilayah AWS Ini adalah titik akhir API untuk API Massal Daftar Harga. Titik akhir tidak terkait dengan atribut produk atau layanan.  
**Respons**  

```
{
    "FormatVersion": "aws_v1", 
    "NextToken": "abcdefg123", 
    "Services": [ 
        {
            "AttributeNames": [ 
                "volumeType", 
                "maxIopsvolume", 
                "instanceCapacity10xlarge", 
                "locationType", 
                "operation" 
            ], 
            "ServiceCode": "AmazonEC2" 
        },
        {
            "AttributeNames": [ 
                "productFamily", 
                "volumeType", 
                "engineCode", 
                "memory" 
            ], 
            "ServiceCode": "AmazonRDS" 
        },
        {...} 
    ] 
}
```

*Untuk informasi selengkapnya tentang operasi API ini, lihat [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html)dan [khusus bahasa AWS SDKs di Referensi](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso)AWS Manajemen Penagihan dan Biaya API*

**catatan**  
Meskipun `DescribeServices` API saat ini tidak kembali `serviceCodes` untuk Savings Plans, Anda memerlukan yang berikut ini `serviceCodes` untuk menggunakan Savings Plans dalam panggilan API berikutnya:  


| ServiceCode | SavingsPlanCode | 
| --- | --- | 
| ComputeSavingsPlans | AWSComputeSavingsPlan | 
| MachineLearningSavingsPlans | AWSMachineLearningSavingsPlans | 
| DatabaseSavingsPlans | AWSDatabaseSavingsPlans | 
Gunakan `ServiceCode` nilai saat bekerja dengan operasi `ListPriceLists` dan `GetPriceListFileUrl` API. Hanya `SavingsPlanCode` diperlukan jika Anda mengunduh file daftar harga secara manual alih-alih menggunakan file APIs.

### Langkah 2: Menemukan file daftar harga untuk yang tersedia Layanan AWS
<a name="price-list-bulk-api-step-2-find-available-price-list-files"></a>

Gunakan operasi `ListPriceLists` API untuk mendapatkan daftar referensi daftar harga yang memiliki izin untuk dilihat. Untuk memfilter hasil Anda, Anda dapat menentukan`ServiceCode`,`CurrencyCode`, dan `EffectiveDate` parameter.

 Wilayah AWS Ini adalah titik akhir API untuk API Massal Daftar Harga. Titik akhir tidak terkait dengan atribut produk atau layanan.

#### Contoh untuk menemukan file daftar harga
<a name="price-list-bulk-api-examples-find-price-list-files"></a>

**Example Contoh: Temukan file daftar harga untuk semua Wilayah AWS**  
Jika Anda tidak menentukan `--region-code` parameter, operasi API mengembalikan referensi file daftar harga dari semua yang tersedia Wilayah AWS.   

```
aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --effective-date "2023-04-03 00:00"
```
**Respons**  

```
{
   "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 Contoh: Temukan file daftar harga untuk Wilayah tertentu**  
Jika Anda menentukan `RegionCode` parameter, operasi API mengembalikan referensi file daftar harga yang spesifik untuk Wilayah tersebut. Untuk menemukan file daftar harga historis, gunakan `EffectiveDate` parameter. Misalnya, Anda dapat menentukan tanggal di masa lalu untuk menemukan file daftar harga tertentu.   
Dari respons, Anda kemudian dapat menggunakan `PriceListArn` nilai dengan operasi [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html)API untuk mendapatkan file daftar harga pilihan Anda.  

```
aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --region-code us-west-2 --effective-date "2023-04-03 00:00"
```
**Respons**  

```
{
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
         "RegionCode": "us-west-2"
      }
   ]
}
```

Untuk informasi selengkapnya tentang operasi API ini, lihat [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html)dan [khusus bahasa AWS SDKs di Referensi AWS Manajemen Penagihan dan Biaya](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html#API_pricing_ListPriceLists_SeeAlso) *API*.

### Langkah 3: Mendapatkan file daftar harga tertentu
<a name="price-list-bulk-api-step-3-getting-specific-price-list"></a>

Gunakan operasi `GetPriceListFileUrl` API untuk mendapatkan URL untuk file daftar harga. URL ini didasarkan pada `PriceListArn` dan `FileFormats` nilai yang Anda ambil dari `ListPriceLists` respons pada [langkah 1](#price-bulk-api-step-1-find-available-services) dan [langkah](#price-list-bulk-api-step-2-find-available-price-list-files) 2 

**Example Contoh: Dapatkan file daftar harga tertentu**  
Perintah berikut mendapatkan URL untuk file daftar harga tertentu untuk Amazon RDS.  

```
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
```
**Respons**  

```
{
    "Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json"
}
```
Dari tanggapan, Anda dapat menggunakan URL untuk mengunduh file daftar harga.

Untuk informasi selengkapnya tentang operasi API ini, lihat topik berikut:
+  [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html)*dan [khusus bahasa AWS SDKs di Referensi](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso) API AWS Manajemen Penagihan dan Biaya *
+ [Membaca file daftar harga](bulk-api-reading-price-list-files.md)