**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 Arsip
<a name="archive-operations"></a>

Berikut ini adalah operasi arsip yang tersedia untuk digunakan di Amazon Glacier.

**Topics**
+ [Menghapus Arsip (DELETE archive)](api-archive-delete.md)
+ [Mengunggah Arsip (POST archive)](api-archive-post.md)

# Menghapus Arsip (DELETE archive)
<a name="api-archive-delete"></a>

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

Operasi ini menghapus arsip dari vault. Anda dapat menghapus satu arsip sekaligus dari vault. Untuk menghapus arsip, Anda harus memberikan ID arsip dalam permintaan hapus. Anda bisa mendapatkan ID arsip dengan mengunduh inventaris vault untuk vault yang berisi arsip. Untuk informasi selengkapnya tentang mengunduh inventaris vault, lihat [Mengunduh Inventaris Vault di Amazon Glacier](vault-inventory.md).

Setelah menghapus arsip, Anda mungkin masih dapat membuat permintaan yang sukses untuk memulai tugas guna mengambil arsip yang dihapus, tetapi tugas pengambilan arsip akan gagal. 

Pengambilan arsip yang sedang berlangsung untuk ID arsip ketika Anda menghapus arsip mungkin atau mungkin tidak berhasil menurut skenario berikut:

 
+ Jika pekerjaan pengambilan arsip secara aktif menyiapkan data untuk diunduh saat Amazon Glacier (Amazon Glacier) menerima permintaan hapus arsip, operasi pengambilan arsip mungkin gagal. 
+ Jika pekerjaan pengambilan arsip telah berhasil menyiapkan arsip untuk diunduh saat Amazon Glacier menerima permintaan hapus arsip, Anda akan dapat mengunduh hasilnya. 

Untuk informasi selengkapnya tentang pengambilan arsip, lihat [Mengunduh Arsip di Amazon Glacier](downloading-an-archive.md). 

Operasi ini bersifat idempoten. Mencoba untuk menghapus arsip yang sudah dihapus tidak menyebabkan kesalahan. 

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

Untuk menghapus arsip, Anda mengirim permintaan `DELETE` ke URI sumber daya arsip.

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

```
1. DELETE /AccountId/vaults/VaultName/archives/ArchiveID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. x-amz-Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID akun yang memiliki brankas. 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 menggunakan ID akun, jangan sertakan tanda hubung ('-') di ID.

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

Operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="api-archive-delete-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-archive-delete-requests-elements"></a>

Operasi ini tidak memiliki isi permintaan.

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

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

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

### Header Respons
<a name="api-archive-delete-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-archive-delete-responses-elements"></a>

Operasi ini tidak mengembalikan isi respons.

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

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

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

Contoh berikut menunjukkan cara menghapus arsip dari vault bernama `examplevault`.

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

ID dari arsip yang akan dihapus ditentukan sebagai subsumber daya dari `archives`.

```
1. DELETE /-/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId 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-archive-delete-example-response"></a>

Jika permintaan berhasil, Amazon Glacier merespons `204 No Content` dengan untuk menunjukkan bahwa arsip dihapus.

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

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

 
+ [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Mengunggah Arsip (POST archive)](api-archive-post.md)
+ [Identity and Access Management untuk Amazon Glacier](security-iam.md)

# Mengunggah Arsip (POST archive)
<a name="api-archive-post"></a>

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

Operasi ini menambahkan arsip ke vault. Untuk pengunggahan yang berhasil, data Anda akan bertahan lama. Sebagai tanggapan, Amazon Glacier (Amazon Glacier) mengembalikan ID arsip di header respons. `x-amz-archive-id` Anda harus menyimpan ID arsip yang dikembalikan sehingga Anda dapat mengakses arsip nanti. 

Anda harus memberikan hash SHA256 pohon dari data yang Anda unggah. Untuk informasi tentang menghitung hash SHA256 pohon, lihat[Checksum Komputasi](checksum-calculations.md). 

**catatan**  
Hash SHA256 pohon hanya diperlukan untuk tindakan Unggah Arsip (arsip POST) saat menggunakan API. Hal ini tidak diperlukan saat menggunakan AWS CLI.

Saat mengunggah arsip, Anda dapat secara opsional menentukan deskripsi arsip hingga 1.024 karakter ASCII yang dapat dicetak. Amazon Glacier mengembalikan deskripsi arsip saat Anda mengambil arsip atau mendapatkan inventaris brankas. Amazon Glacier tidak menafsirkan deskripsi dengan cara apa pun. Deskripsi arsip tidak harus unik. Anda tidak dapat menggunakan deskripsi untuk mengambil atau mengurutkan daftar arsip. 

Kecuali untuk deskripsi arsip opsional, Amazon Glacier tidak mendukung metadata tambahan apa pun untuk arsip. ID arsip adalah urutan buram karakter tempat Anda tidak dapat menyimpulkan makna apa pun tentang arsip. Jadi, Anda dapat mempertahankan metadata tentang arsip di sisi klien. Untuk informasi selengkapnya, lihat [Bekerja dengan Arsip di Amazon Glacier](working-with-archives.md).

Arsip bersifat tetap. Setelah mengunggah arsip, Anda tidak dapat mengedit arsip atau deskripsinya. 

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

Untuk mengunggah arsip, Anda menggunakan metode `POST` HTTP dan mencakup permintaan ke subsumber daya `archives` dari vault tempat Anda ingin menyimpan arsip. Permintaan harus menyertakan ukuran muatan arsip, checksum (hash SHA256 pohon), dan secara opsional dapat menyertakan deskripsi arsip.

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

```
 1. POST /AccountId/vaults/VaultName/archives
 2. Host: glacier.Region.amazonaws.com
 3. x-amz-glacier-version: 2012-06-01
 4. Date: Date
 5. Authorization: SignatureValue
 6. x-amz-archive-description: Description
 7. x-amz-sha256-tree-hash: SHA256 tree hash
 8. x-amz-content-sha256: SHA256 linear hash
 9. Content-Length: Length
10. 
11. <Request body.>
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID akun yang memiliki brankas. 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 menggunakan ID akun, jangan sertakan tanda hubung ('-') di ID.

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

Implementasi operasi ini tidak menggunakan parameter permintaan.

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

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


|  Nama  |  Deskripsi  |  Wajib  | 
| --- | --- | --- | 
| Content-Length  |  Ukuran objek, dalam byte. Untuk informasi lebih lanjut, kunjungi [http://www.w3. org/Protocols/rfc2616/rfc2616-sec14.html \$1sec14 .13](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13).  Jenis: Angka Default: Tidak ada Batasan: Tidak Ada  |  Ya  | 
| x-amz-archive-description  |  Deskripsi opsional dari arsip yang Anda unggah. Ini bisa menjadi deskripsi bahasa biasa atau beberapa pengidentifikasi yang Anda pilih untuk ditetapkan. Deskripsi tidak harus unik di seluruh arsip. Saat Anda mengambil inventaris vault (lihat [Memulai Tugas (POST jobs)](api-initiate-job-post.md)), inventaris mencakup deskripsi ini untuk masing-masing arsip yang dikembalikan sebagai respons. Tipe: String Default: Tidak ada Batasan: Deskripsi harus kurang dari atau sama dengan 1.024 karakter. Karakter yang diizinkan adalah ASCII 7-bit tanpa kode kontrol, khususnya nilai ASCII 32—126 desimal atau 0x20—0x7E heksadesimal.  |  Tidak  | 
| x-amz-content-sha256  |   SHA256 Checksum (hash linier) dari payload. Ini bukan nilai yang sama seperti yang Anda tentukan di header `x-amz-sha256-tree-hash`. Tipe: String Default: Tidak ada Batasan: Tidak Ada  |  Ya  | 
|  x-amz-sha256-tree-hash  |  Checksum yang dihitung pengguna, hash SHA256 pohon, dari payload. Untuk informasi tentang menghitung hash SHA256 pohon, lihat[Checksum Komputasi](checksum-calculations.md). Jika Amazon Glacier menghitung checksum payload yang berbeda, itu akan menolak permintaan tersebut. Tipe: String Default: Tidak ada Batasan: Tidak Ada  |  Ya | 

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

Isi permintaan berisi data untuk diunggah.

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

 Sebagai tanggapan, Amazon Glacier menyimpan arsip dengan tahan lama dan mengembalikan jalur URI ke ID arsip.

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

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
5. Location: Location
6. x-amz-archive-id: ArchiveId
```

### Header Respons
<a name="api-archive-post-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  | 
| --- | --- | 
|  Location  |  Jalur URI relatif dari sumber daya arsip yang baru ditambahkan.  Tipe: String  | 
|  x-amz-archive-id  |  ID arsip. Nilai ini juga disertakan sebagai bagian dari header `Location`. Tipe: String  | 
|  x-amz-sha256-tree-hash​  |  Checksum arsip dihitung oleh Amazon Glacier.  Tipe: String  | 

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

Operasi ini tidak mengembalikan isi respons.

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

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

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

### Contoh Permintaan
<a name="api-archive-post-examples-request"></a>

Contoh berikut menunjukkan permintaan untuk mengunggah arsip. 

```
 1. POST /-/vaults/examplevault/archives HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
 5. x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3
 6. Content-Length: 2097152
 7. x-amz-glacier-version: 2012-06-01
 8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
 9. 
10. <Request body (2097152 bytes).>
```

### Contoh Respons
<a name="api-archive-post-examples-response"></a>

Respons yang berhasil di bawah ini memiliki `Location` header tempat Anda bisa mendapatkan ID yang ditetapkan Amazon Glacier ke arsip.

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
6. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```

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

 
+ [Bekerja dengan Arsip di Amazon Glacier](working-with-archives.md)
+ [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md)
+ [Menghapus Arsip (DELETE archive)](api-archive-delete.md)
+ [Identity and Access Management untuk Amazon Glacier](security-iam.md)