**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. # Mendapatkan Output Tugas (GET output) ## Deskripsi Operas ini mengunduh output tugas yang Anda mulai menggunakan [Memulai Tugas (POST jobs)](api-initiate-job-post.md). Bergantung pada tipe tugas yang Anda tentukan ketika memulai tugas, output akan berupa isi arsip atau inventaris vault. Anda dapat mengunduh semua output tugas atau mengunduh bagian output dengan menentukan rentang byte. Untuk tugas pengambilan arsip dan tugas, Anda harus memverifikasi ukuran yang diunguh terhadap ukuran yang dikembalikan dalam header dari respons **Dapatkan Output Tugas**. Untuk tugas pengambilan arsip, Anda juga harus memastikan bahwa ukurannya sesuai dengan harapan Anda. Jika Anda mengunduh bagian output, ukuran yang diharapkan didasarkan pada rentang byte yang Anda tentukan. Sebagai contoh, jika Anda menentukan berbagai `bytes=0-1048575`, Anda harus memastikan ukuran unduhan Anda adalah 1.048,576 byte. Jika Anda mengunduh seluruh arsip, ukuran yang diharapkan adalah ukuran arsip saat Anda mengunggahnya ke Amazon Glacier (Amazon Glacier). Ukuran yang diharapkan juga dikembalikan dalam header dari respons **Dapatkan Output Tugas**. Dalam kasus pekerjaan pengambilan arsip, tergantung pada rentang byte yang Anda tentukan, Amazon Glacier mengembalikan checksum untuk bagian data. Untuk memastikan bagian yang Anda unduh adalah data yang benar, hitung checksum pada klien, pastikan nilai-nilainya cocok, dan pastikan ukuran sesuai dengan harapan Anda. ID pekerjaan tidak kedaluwarsa setidaknya 24 jam setelah Amazon Glacier menyelesaikan pekerjaan. Artinya, Anda dapat mengunduh hasil pekerjaan dalam periode 24 jam setelah Amazon Glacier menyelesaikan pekerjaan. ## Permintaan ### Sintaksis Untuk mengambil output tugas, Anda mengirim permintaan `GET` HTTP ke URI `output` dari tugas tertentu. ``` 1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Range: ByteRangeToRetrieve 6. 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 Operasi ini tidak menggunakan parameter permintaan. ### Header Permintaan 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 | | --- | --- | --- | | Range | Rentang byte yang diambil dari output. Sebagai contoh, jika Anda ingin mengunduh byte 1.048,576 pertama, tentukan rentang sebagai `bytes=0-1048575`. Untuk informasi selengkapnya, buka [Definisi Bidang Header Rentang](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35). Rentang ini terkait dengan rentang yang ditentukan dalam permintaan Mulai Tugas. Secara default, operasi ini akan mengunduh seluruh output. Jika output tugasnya besar, Anda dapat menggunakan header permintaan `Range` untuk mengambil sebagian dari output. Anda dapat mengunduh seluruh output dalam potongan byte yang lebih kecil. Misalnya, Anda memiliki output tugas sebesar 1 GB yang ingin Anda unduh dan Anda memutuskan untuk mengunduh potongan data sebesar 128 MB pada suatu waktu, total delapan permintaan Dapatkan Output Tugas. Anda akan menggunakan proses berikut untuk mengunduh output tugas: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazonglacier/latest/dev/api-job-output-get.html) Tipe: String Default: Tidak ada Batasan: Tidak Ada | Tidak | ### Isi Permintaan Operasi ini tidak memiliki isi permintaan. ## Respons ### Sintaksis Untuk permintaan pengambilan yang mengembalikan semua data tugas, respons output tugas mengembalikan kode respons `200 OK`. Ketika konten parsial diminta, misalnya, jika Anda menentukan header `Range` dalam permintaan, kode respons`206 Partial Content` dikembalikan. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: ContentType 5. Content-Length: Length 6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier 7. 8. [Body containing job output.] ``` ### Header Respons | Header | Deskripsi | | --- | --- | | Content-Range | Kisaran byte dikembalikan oleh Amazon Glacier. Jika hanya sebagian output yang diunduh, responsnya memberikan kisaran byte Amazon Glacier yang dikembalikan. Misalnya, `bytes 0-1048575/8388608` mengembalikan 1 MB pertama dari 8 MB. Untuk informasi selengkapnya tentang header `Content-Range`, buka [Definisi Bidang Header Content-Range](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Tipe: String | | Content-Type | Content-Type bergantung pada apakah output tugas adalah arsip atau inventaris vault. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazonglacier/latest/dev/api-job-output-get.html) Tipe: String | | x-amz-sha256-tree-hash​ | Checksum data dalam respons. Header ini dikembalikan hanya ketika mengambil output untuk tugas pengambilan arsip. Selanjutnya, header ini muncul ketika berbagai data yang diambil yang diminta dalam permintaan Mulai Tugas adalah hash pohon selaras dan rentang yang diunduh di Dapatkan Output Tugas juga merupakan hash pohon selaras. Untuk informasi selengkapnya tentang rentang hash pohon selaras, lihat [Menerima Checksum Saat Mengunduh Data](checksum-calculations-range.md). Misalnya, jika dalam permintaan Mulai Tugas, Anda menentukan rentang hash pohon selaras yang diambil (yang mencakup seluruh arsip), Anda akan menerima checksum dari data yang Anda unduh berdasarkan kondisi berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazonglacier/latest/dev/api-job-output-get.html) Tipe: String | ### Isi Respons Amazon Glacier mengembalikan output pekerjaan di badan respons. Bergantung pada tipe tugas, output dapat berupa isi arsip atau inventaris vault. Dalam kasus inventaris vault, secara default daftar inventaris dikembalikan sebagai isi JSON berikut. ``` 1. { 2. "VaultARN": String, 3. "InventoryDate": String, 4. "ArchiveList": [ 5. {"ArchiveId": String, 6. "ArchiveDescription": String, 7. "CreationDate": String, 8. "Size": Number, 9. "SHA256TreeHash": String 10. }, 11. ... 12. ] 13. } ``` Jika Anda meminta format output nilai yang dipisahkan koma (CSV) saat Anda memulai tugas inventaris vault, inventaris vault dikembalikan dalam format CSV di isinya. Format CSV memiliki lima kolom "ArchiveId“," ArchiveDescription “," CreationDate “, “Ukuran”, dan "SHA256TreeHash" dengan definisi yang sama dengan bidang JSON yang sesuai. **catatan** Dalam format CSV yang dikembalikan, bidang dapat dikembalikan dengan seluruh bidang tertutup dalam tanda kutip ganda. Bidang yang berisi koma atau tanda kutip ganda selalu dikembalikan tertutup dalam tanda kutip ganda. Misalnya, `my archive description,1` dikembalikan sebagai `"my archive description,1"`. Karakter kutip ganda yang berada dalam bidang tertutup kutip ganda yang dikembalikan adalah *escaped* dengan mendahuluinya dengan karakter garis miring terbalik. Misalnya, `my archive description,1"2` dikembalikan sebagai `"my archive description,1\"2"` dan `my archive description,1\"2` dikembalikan sebagai `"my archive description,1\\"2"`. Karakter garis miring terbalik bukan karakter escaped. Isi respons JSON berisi bidang JSON berikut. **ArchiveDescription** Deskripsi arsip. *Tipe*: String **ArchiveId** ID arsip. *Tipe*: String **ArchiveList** Array metadata arsip. Setiap objek dalam array mewakili metadata untuk satu arsip yang terkandung dalam vault. *Tipe*: Array **CreationDate** Tanggal dan waktu UTC saat arsip dibuat. *Tipe*: Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`. **InventoryDate** Tanggal dan waktu UTC dari inventaris terakhir untuk vault yang diselesaikan setelah perubahan ke vault. Meskipun Amazon Glacier menyiapkan inventaris brankas sekali sehari, tanggal inventaris hanya diperbarui jika ada penambahan arsip atau penghapusan ke brankas sejak inventaris terakhir. *Tipe*: Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`. **SHA256TreeHash** Hash pohon arsip. *Tipe*: String **Ukuran** Ukuran dalam byte dari arsip. *Tipe*: Angka **Vaultarn** Sumber daya Amazon Resource Name (ARN) asal pengambilan arsip diminta. *Tipe*: String ### Kesalahan Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md) ## Contoh Contoh berikut menunjukkan permintaan untuk tugas yang mengambil arsip. ### Contoh 1: Mengunduh output Contoh ini mengambil data yang disiapkan oleh Amazon Glacier sebagai tanggapan atas permintaan pekerjaan pengambilan arsip inisiat Anda. #### Contoh Permintaan ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output 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 Berikut adalah contoh respons dari tugas pengambilan arsip. Perhatikan bahwa header `Content-Type` adalah `application/octet-stream` dan header `x-amz-sha256-tree-hash` disertakan dalam respons, yang berarti semua data tugas dikembalikan. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 4. Date: Wed, 10 Feb 2017 12:00:00 GMT 5. Content-Type: application/octet-stream 6. Content-Length: 1048576 7. 8. [Archive data.] ``` Berikut adalah contoh respons dari tugas pengambilan inventaris. Perhatikan bahwa header `Content-Type` adalah `application/json`. Perhatikan juga bahwa respons tidak termasuk header `x-amz-sha256-tree-hash`. ``` 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: 906 6. 7. { 8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 9. "InventoryDate": "2011-12-12T14:19:01Z", 10. "ArchiveList": [ 11. { 12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA", 13. "ArchiveDescription": "my archive1", 14. "CreationDate": "2012-05-15T17:19:46.700Z", 15. "Size": 2140123, 16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62" 17. }, 18. { 19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA", 20. "ArchiveDescription": "my archive2", 21. "CreationDate": "2012-05-15T17:21:39.339Z", 22. "Size": 2140123, 23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3" 24. } 25. ] 26. } ``` ### Contoh 2: Menguduh hanya sebagian output Contoh ini hanya mengambil sebagian dari arsip yang disiapkan oleh Amazon Glacier sebagai tanggapan atas permintaan pekerjaan pengambilan arsip inisiat Anda. Permintaan menggunakan header `Range` opsional untuk hanya mengambil 1.024 byte pertama. #### Contoh Permintaan ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Range: bytes=0-1023 5. x-amz-glacier-version: 2012-06-01 6. 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 Respons yang berhasil berikut menunjukkan respons `206 Partial Content`. Dalam hal ini, respon juga menyertakan `Content-Range` header yang menentukan kisaran byte Amazon Glacier kembali. ``` 1. HTTP/1.1 206 Partial Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range: bytes 0-1023/8388608 5. Content-Type: application/octet-stream 6. Content-Length: 1024 7. 8. [Archive data.] ``` ## Bagian Terkait + [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md) + [Memulai Tugas (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management untuk Amazon Glacier](security-iam.md)