**Halaman ini hanya untuk pelanggan lama layanan Amazon Glacier menggunakan Vaults dan REST API asli dari 2012.**

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas [penyimpanan Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan [Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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

# Operasi Pengambilan Data
<a name="data-retrieval-policy-operations"></a>

Berikut ini adalah operasi terkait pengambilan data yang tersedia di Amazon Glacier.

**Topics**
+ [Mendapatkan Kebijakan Pengambilan Data (GET policy)](api-GetDataRetrievalPolicy.md)
+ [Mencantumkan Kapasitas yang Disediakan (GET provisioned-capacity)](api-ListProvisionedCapacity.md)
+ [Membeli Kapasitas yang Disediakan (GET provisioned-capacity)](api-PurchaseProvisionedCapacity.md)
+ [Mengatur Kebijakan Pengambilan Data (PUT policy)](api-SetDataRetrievalPolicy.md)

# Mendapatkan Kebijakan Pengambilan Data (GET policy)
<a name="api-GetDataRetrievalPolicy"></a>

## Deskripsi
<a name="api-GetDataRetrievalPolicy-description"></a>

Operasi ini mengembalikan kebijakan pengambilan data saat ini untuk Akun AWS dan AWS Wilayah yang ditentukan dalam `GET` permintaan. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat [Kebijakan Pengambilan Data Amazon Glacier](data-retrieval-policy.md).

## Permintaan
<a name="api-GetDataRetrievalPolicy-requests"></a>

Untuk mengembalikan kebijakan pengambilan data saat ini, kirim permintaan `GET` HTTP ke URI kebijakan pengambilan data seperti yang ditunjukkan dalam contoh sintaks berikut.

### Sintaksis
<a name="api-GetDataRetrievalPolicy-requests-syntax"></a>

```
1. GET /AccountId/policies/data-retrieval HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau secara opsional satu '`-`' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID akun, jangan sertakan tanda hubung ('-') di ID.

### Parameter Permintaan
<a name="api-GetDataRetrievalPolicy-requests-parameters"></a>

Operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="api-GetDataRetrievalPolicy-requests-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

### Isi Permintaan
<a name="api-GetDataRetrievalPolicy-requests-elements"></a>

Operasi ini tidak memiliki isi permintaan.

## Respons
<a name="api-GetDataRetrievalPolicy-responses"></a>

### Sintaksis
<a name="api-GetDataRetrievalPolicy-responses-syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Policy":
    {
      "Rules":[
         {
            "BytesPerHour": Number,
            "Strategy": String	 
         }
       ]
    }
}
```

### Header Respons
<a name="api-GetDataRetrievalPolicy-responses-headers"></a>

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).

### Isi Respons
<a name="api-GetDataRetrievalPolicy-responses-elements"></a>

Isi respons berisi bidang JSON berikut.

 

**BytesPerHour**  
Jumlah maksimum byte yang dapat diambil dalam satu jam.  
Bidang ini hanya akan muncul jika nilai bidang **Strategy** (Strategi) adalah `BytesPerHour`.   
*Tipe*: Angka

**Aturan**  
Aturan kebijakan. Meskipun ini adalah jenis daftar, saat ini hanya akan ada satu aturan, yang berisi bidang Strategi dan opsional BytesPerHour bidang.  
*Tipe*: Array

**Strategi**  
Tipe kebijakan pengambilan data.  
*Tipe*: String  
Nilai yang valid: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` sama dengan memilih **Max Retrieval Rate** (Tingkat Pengambilan Maks.) di konsol. `FreeTier` sama dengan memilih **Free Tier Only** (Hanya Tingkat Gratis) di konsol. `None` sama dengan memilih **No Retrieval Policy** (Tidak Ada Kebijakan) di konsol. Untuk informasi selengkapnya tentang memilih kebijakan pengambilan data di konsol, lihat [Kebijakan Pengambilan Data Amazon Glacier](data-retrieval-policy.md).

### Kesalahan
<a name="api-GetDataRetrievalPolicy-responses-errors"></a>

Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)

## Contoh
<a name="api-GetDataRetrievalPolicy-examples"></a>

Contoh berikut menunjukkan cara mendapatkan kebijakan pengambilan data.

### Contoh Permintaan
<a name="api-GetDataRetrievalPolicy-example-request"></a>

Dalam contoh ini, permintaan `GET` dikirim ke URI dari lokasi kebijakan.

```
1. GET /-/policies/data-retrieval HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### Contoh Respons
<a name="api-GetDataRetrievalPolicy-example-response"></a>

Respons yang sukses menunjukkan kebijakan pengambilan data dalam isi respons dalam format JSON. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 85
 6.  
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.            "BytesPerHour":10737418240,
13.            "Strategy":"BytesPerHour"
14.           }
15.        ]
16.     }
17. }
```

## Bagian Terkait
<a name="related-sections-GetDataRetrievalPolicy"></a>

 
+ [Mengatur Kebijakan Pengambilan Data (PUT policy)](api-SetDataRetrievalPolicy.md)

 
+ [Memulai Tugas (POST jobs)](api-initiate-job-post.md)

# Mencantumkan Kapasitas yang Disediakan (GET provisioned-capacity)
<a name="api-ListProvisionedCapacity"></a>

Operasi ini mencantumkan unit kapasitas yang disediakan untuk Akun AWS yang ditentukan. Untuk informasi selengkapnya tentang kapasitas yang disediakan, lihat [Opsi Pengambilan Arsip](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

Unit kapasitas yang disediakan berlangsung selama satu bulan mulai tanggal dan waktu pembelian, yang merupakan tanggal mulai. Unit ini berakhir pada tanggal kedaluwarsa, yang tepat satu bulan setelah tanggal mulai ke detik terdekat. 

Jika tanggal mulai adalah tanggal 31, tanggal kedaluwarsa adalah hari terakhir bulan berikutnya. Misalnya, jika tanggal mulai adalah 31 Agustus, tanggal kedaluwarsa adalah 30 September. Jika tanggal mulai 31 Januari, tanggal kedaluwarsa adalah 28 Februari. Anda dapat melihat fungsi ini di [Contoh Respons](#api-ListProvisionedCapacity-example1-response).

## Sintaks Permintaan
<a name="api-ListProvisionedCapacity-RequestSyntax"></a>

Untuk mencantumkan kapasitas pengambilan yang disediakan untuk akun, kirim permintaan HTTP GET ke URI kapasitas yang disediakan seperti yang ditunjukkan dalam contoh sintaks berikut.

```
1. GET /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau secara opsional satu '`-`' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID akun, jangan sertakan tanda hubung ('-') di ID.

## Parameter Permintaan
<a name="api-ListProvisionedCapacity-RequestParameters"></a>

Operasi ini tidak menggunakan parameter permintaan.

## Header Permintaan
<a name="api-ListProvisionedCapacity-requests-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

## Isi Permintaan
<a name="api-ListProvisionedCapacity-requests-elements"></a>

Operasi ini tidak memiliki isi permintaan.

## Respons
<a name="api-ListProvisionedCapacity-responses"></a>

Jika operasi berhasil, layanan mengirimkan kembali respon `200 OK` HTTP.

### Sintaks Respons
<a name="api-ListProvisionedCapacity-ResponseSyntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "string"
      }
}
```

### Header Respons
<a name="api-ListProvisionedCapacity-headers"></a>

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).

### Isi Respons
<a name="api-ListProvisionedCapacity-body"></a>

Isi respons berisi bidang JSON berikut.

**CapacityId**  <a name="Glacier-ListProvisionedCapacity-response"></a>
ID yang mengidentifikasi unit kapasitas yang disediakan.  
 *Tipe*: String.

**StartDate**  
Tanggal pembelian unit kapasitas yang disediakan, dalam Waktu Universal Terkoordinasi (UTC).  
*Tipe*: String. Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`.

**ExpirationDate**  
Tanggal berakhirnya unit kapasitas yang disediakan, dalam Waktu Universal Terkoordinasi (UTC).  
*Tipe*: String. Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`.

### Kesalahan
<a name="api-ListProvisionedCapacity-errors"></a>

Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)

## Contoh
<a name="api-ListProvisionedCapacity-examples"></a>

Contoh berikut mencantumkan unit kapasitas yang disediakan untuk akun.

### Contoh Permintaan
<a name="api-ListProvisionedCapacity-example1-request"></a>

Dalam contoh ini, permintaan GET dikirim untuk mengambil daftar unit kapasitas yang disediakan untuk akun yang ditentukan.

```
1. GET /123456789012/priority-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### Contoh Respons
<a name="api-ListProvisionedCapacity-example1-response"></a>

Jika permintaan berhasil, Amazon Glacier (Amazon Glacier) mengembalikan dengan daftar unit kapasitas `HTTP 200 OK` yang disediakan untuk akun seperti yang ditunjukkan pada contoh berikut.

 Unit kapasitas yang disediakan terdaftar pertama adalah contoh unit dengan tanggal mulai 31 Januari 2017 dan tanggal kedaluwarsa 28 Februari 2017. Seperti yang dijelaskan sebelumnya, jika tanggal mulai adalah tanggal 31, tanggal kedaluwarsa adalah hari terakhir bulan berikutnya.

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:02:00 GMT
 4. Content-Type: application/json
 5. Content-Length: length
 6. 
 7. {
 8.    "ProvisionedCapacityList",
 9.       {
10.          "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
11.          "StartDate": "2017-01-31T14:26:33.031Z",
12.          "ExpirationDate": "2017-02-28T14:26:33.000Z",
13.       },
14.       {
15.          "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
16.          "StartDate": "2016-12-13T20:11:51.095Z"",
17.          "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
18.       },
19.       ...
20. }
```

## Bagian Terkait
<a name="api-ListProvisionedCapacity-related-sections"></a>

 
+ [Membeli Kapasitas yang Disediakan (GET provisioned-capacity)](api-PurchaseProvisionedCapacity.md)

# Membeli Kapasitas yang Disediakan (GET provisioned-capacity)
<a name="api-PurchaseProvisionedCapacity"></a>

Operasi ini membeli unit kapasitas yang disediakan untuk Akun AWS. 

Unit kapasitas yang disediakan berlangsung selama satu bulan mulai tanggal dan waktu pembelian, yang merupakan tanggal mulai. Unit ini berakhir pada tanggal kedaluwarsa, yang tepat satu bulan setelah tanggal mulai ke detik terdekat. 

Jika tanggal mulai adalah tanggal 31, tanggal kedaluwarsa adalah hari terakhir bulan berikutnya. Misalnya, jika tanggal mulai adalah 31 Agustus, tanggal kedaluwarsa adalah 30 September. Jika tanggal mulai 31 Januari, tanggal kedaluwarsa adalah 28 Februari.

Kapasitas yang disediakan membantu memastikan kapasitas pengambilan Anda untuk pengambilan yang dipercepat tersedia saat Anda membutuhkannya. Setiap unit kapasitas memastikan bahwa setidaknya tiga pengambilan yang dipercepat dapat dilakukan setiap lima menit dan menyediakan hingga 150 throughput pengambilan. MB/s Untuk informasi selengkapnya tentang kapasitas yang disediakan, lihat [Opsi Pengambilan Arsip](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

**catatan**  
Ada batas dua unit kapasitas yang disediakan per. Akun AWS

## Permintaan
<a name="api-PurchaseProvisionedCapacity-requests"></a>

Untuk membeli unit kapasitas yang disediakan untuk Akun AWS mengirim `POST` permintaan HTTP ke URI kapasitas yang disediakan.

### Sintaksis
<a name="api-PurchaseProvisionedCapacity-requests-syntax"></a>

```
1. POST /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau secara opsional satu '`-`' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID akun, jangan sertakan tanda hubung ('-') di ID.

### Parameter Permintaan
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

#### Header Permintaan
<a name="api-PurchaseProvisionedCapacity-requests-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

#### Isi Permintaan
<a name="api-PurchaseProvisionedCapacity-requests-elements"></a>

Operasi ini tidak memiliki isi permintaan.

## Respons
<a name="api-PurchaseProvisionedCapacity-responses"></a>

Jika permintaan operasi berhasil, layanan mengembalikan respons `201 Created` HTTP.

### Sintaksis
<a name="api-PurchaseProvisionedCapacity-response-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId
```

### Header Respons
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

Respons yang sukses termasuk header respon berikut, selain header respons yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header respons umum, lihat [Header Respons Umum](api-common-response-headers.md).


|  Nama  |  Deskripsi | 
| --- | --- | 
|  `x-amz-capacity-id`   |  ID yang mengidentifikasi unit kapasitas yang disediakan. Tipe: String  | 

### Isi Respons
<a name="api-PurchaseProvisionedCapacity-responses-elements"></a>

Operasi ini tidak mengembalikan isi respons.

### Kesalahan
<a name="api-PurchaseProvisionedCapacity-responses-errors"></a>

Operasi ini mencakup kesalahan atau kesalahan berikut, di samping kemungkinan kesalahan yang umum terjadi pada semua operasi Amazon Glacier. Untuk informasi tentang kesalahan Amazon Glacier dan daftar kode kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)


| Kode | Deskripsi | Kode Status HTTP | Tipe | 
| --- | --- | --- | --- | 
| LimitExceededException | Dikembalikan jika permintaan yang diberikan akan melebihi batas akun unit kapasitas yang disediakan.  | 400 Bad Request | Klien | 

## Contoh
<a name="api-PurchaseProvisionedCapacity-examples"></a>

Contoh berikut membeli unit kapasitas yang disediakan untuk akun.

### Contoh Permintaan
<a name="api-PurchaseProvisionedCapacity-example-request"></a>

Contoh berikut mengirimkan permintaan HTTP POST untuk membeli unit kapasitas yang disediakan. 

```
1. POST /123456789012/provisioned-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
```

### Contoh Respons
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

Jika permintaan berhasil, Amazon Glacier (Amazon Glacier) mengembalikan respons, seperti yang ditunjukkan pada contoh `HTTP 201 Created` berikut.

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z
```

## Bagian Terkait
<a name="api-PurchaseProvisionedCapacity-related-sections"></a>

 
+ [Mencantumkan Kapasitas yang Disediakan (GET provisioned-capacity)](api-ListProvisionedCapacity.md)

# Mengatur Kebijakan Pengambilan Data (PUT policy)
<a name="api-SetDataRetrievalPolicy"></a>

## Deskripsi
<a name="api-SetDataRetrievalPolicy-description"></a>

Operasi ini menetapkan dan kemudian memberlakukan kebijakan pengambilan data di AWS Wilayah yang ditentukan dalam permintaan. `PUT` Anda dapat menetapkan satu kebijakan per AWS Wilayah untuk Akun AWS. Kebijakan ini diterapkan dalam beberapa menit setelah operasi `PUT` berhasil. 

 Operasi kebijakan yang ditetapkan tidak memengaruhi pengambilan tugas yang sedang berlangsung sebelum kebijakan diterapkan. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat [Kebijakan Pengambilan Data Amazon Glacier](data-retrieval-policy.md). 

## Permintaan
<a name="api-SetDataRetrievalPolicy-requests"></a>

### Sintaksis
<a name="api-SetDataRetrievalPolicy-requests-syntax"></a>

Untuk menetapkan kebijakan pengambilan data, kirim permintaan HTTP PUT ke URI kebijakan pengambilan data seperti yang ditunjukkan dalam contoh sintaks berikut.

```
 1. PUT /AccountId/policies/data-retrieval HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy":
10.     {
11.       "Rules":[
12.          {
13.              "Strategy": String,
14.              "BytesPerHour": Number          
15.          }
16.        ]
17.     }
18. }
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau secara opsional satu '`-`' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID akun, jangan sertakan tanda hubung ('-') di ID.

### Parameter Permintaan
<a name="api-SetDataRetrievalPolicy-requests-parameters"></a>

Operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="api-SetDataRetrievalPolicy-requests-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

### Isi Permintaan
<a name="api-SetDataRetrievalPolicy-requests-elements"></a>

Isi permintaan berisi bidang JSON berikut.

 

**BytesPerHour**  
Jumlah maksimum byte yang dapat diambil dalam satu jam.  
Bidang ini hanya diperlukan jika nilai bidang Strategy (Strategi) adalah `BytesPerHour`. Operasi PUT Anda akan ditolak jika bidang Strategy (Strategi) tidak ditetapkan ke `BytesPerHour` dan Anda menetapkan kolom ini.  
*Tipe*: Angka  
*Wajib*: Ya, jika bidang Strategy (Strategi) diatur ke `BytesPerHour`. Jika tidak, tidak.  
*Nilai yang valid*: Nilai bilangan bulat minimum sebesar 1. Nilai bilangan bulat maksimum 2^63 - 1 inklusif.

**Aturan**  
Aturan kebijakan. Meskipun ini adalah jenis daftar, saat ini harus ada hanya satu aturan, yang berisi bidang Strategi dan opsional BytesPerHour bidang.  
*Tipe*: Array  
*Wajib*: Ya

**Strategi**  
Tipe kebijakan pengambilan data yang ditetapkan.  
*Tipe*: String  
*Wajib*: Ya  
Nilai yang valid: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` sama dengan memilih **Max Retrieval Rate** (Tingkat Pengambilan Maks.) di konsol. `FreeTier` sama dengan memilih **Free Tier Only** (Hanya Tingkat Gratis) di konsol. `None` sama dengan memilih **No Retrieval Policy** (Tidak Ada Kebijakan) di konsol. Untuk informasi selengkapnya tentang memilih kebijakan pengambilan data di konsol, lihat [Kebijakan Pengambilan Data Amazon Glacier](data-retrieval-policy.md).

## Respons
<a name="api-SetDataRetrievalPolicy-responses"></a>

### Sintaksis
<a name="api-SetDataRetrievalPolicyresponse-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### Header Respons
<a name="api-SetDataRetrievalPolicy-responses-headers"></a>

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).

### Isi Respons
<a name="api-SetDataRetrievalPolicy-responses-elements"></a>

Operasi ini tidak mengembalikan isi respons.

### Kesalahan
<a name="api-SetDataRetrievalPolicy-responses-errors"></a>

Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)

## Contoh
<a name="api-SetDataRetrievalPolicy-examples"></a>

### Contoh Permintaan
<a name="api-SetDataRetrievalPolicy-example-request"></a>

Contoh berikut mengirimkan permintaan HTTP PUT dengan bidang Strategy (Strategi) diatur ke `BytesPerHour`. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"BytesPerHour",
13.              "BytesPerHour":10737418240       
14.           }
15.        ]
16.     }
17. }
```

Contoh berikut mengirimkan permintaan HTTP PUT dengan bidang Strategy (Strategi) diatur ke `FreeTier`. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"FreeTier"   
13.           }
14.        ]
15.     }
16. }
```

Contoh berikut mengirimkan permintaan HTTP PUT dengan bidang Strategy (Strategi) diatur ke `None`. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"None"   
13.           }
14.        ]
15.     }
16. }
```

### Contoh Respons
<a name="api-SetDataRetrievalPolicy-example-response"></a>

Jika permintaan berhasil Amazon Glacier (Amazon Glacier) menetapkan kebijakan dan mengembalikan `HTTP 204 No Content` seperti yang ditunjukkan pada contoh berikut.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

## Bagian Terkait
<a name="related-sections-SetDataRetrievalPolicy"></a>

 
+ [Mendapatkan Kebijakan Pengambilan Data (GET policy)](api-GetDataRetrievalPolicy.md)

 
+ [Memulai Tugas (POST jobs)](api-initiate-job-post.md)