**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 Tugas Berikut ini adalah operasi pekerjaan yang tersedia di Amazon Glacier. **Topics** + [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md) + [Mendapatkan Output Tugas (GET output)](api-job-output-get.md) + [Memulai Tugas (POST jobs)](api-initiate-job-post.md) + [Mencantumkan Tugas (GET jobs)](api-jobs-get.md) # Mendeskripsikan Tugas (GET JobID) ## Deskripsi Operasi ini menampilkan informasi tentang pekerjaan yang Anda mulai sebelumnya, termasuk tanggal inisiasi pekerjaan, pengguna yang memulai pekerjaan, kode/pesan status pekerjaan, dan topik Simple Notification Service Amazon (Amazon SNS) untuk memberi tahu setelah Amazon Glacier (Amazon Glacier) menyelesaikan pekerjaan. Untuk informasi selengkapnya tentang memulai tugas, lihat [Memulai Tugas (POST jobs)](api-initiate-job-post.md). **catatan** Operasi ini memungkinkan Anda memeriksa status tugas Anda. Namun, kami sangat menyarankan agar Anda menyiapkan topik Amazon SNS dan menentukannya dalam permintaan pekerjaan awal Anda sehingga Amazon Glacier dapat memberi tahu topik tersebut setelah menyelesaikan pekerjaan. ID pekerjaan tidak akan kedaluwarsa setidaknya 24 jam setelah Amazon Glacier menyelesaikan pekerjaan. ## Permintaan ### Sintaksis Untuk mendapatkan informasi tentang tugas, Anda menggunakan metode `GET` HTTP dan cakupan permintaan untuk tugas tertentu. Perhatikan bahwa jalur URI relatif sama dengan yang dikembalikan Amazon Glacier kepada Anda saat Anda memulai pekerjaan. ``` 1. GET /AccountID/vaults/VaultName/jobs/JobID 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 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. **catatan** Dalam permintaan, jika Anda menghilangkan `JobID`, respons mengembalikan daftar semua tugas aktif pada vault yang ditentukan. Untuk informasi selengkapnya tentang mencantumkan tugas, lihat [Mencantumkan Tugas (GET jobs)](api-jobs-get.md). ### Parameter Permintaan Operasi ini tidak menggunakan parameter permintaan. ### Header Permintaan 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 Operasi ini tidak memiliki isi permintaan. ## Respons ### Sintaksis ``` HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Action": "string", "ArchiveId": "string", "ArchiveSHA256TreeHash": "string", "ArchiveSizeInBytes": number, "Completed": boolean, "CompletionDate": "string", "CreationDate": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Format": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "InventorySizeInBytes": number, "JobDescription": "string", "JobId": "string", "JobOutputPath": "string", "OutputLocation": { "S3": { "AccessControlList": [ { "Grantee": { "DisplayName": "string", "EmailAddress": "string", "ID": "string", "Type": "string", "URI": "string" }, "Permission": "string" } ], "BucketName": "string", "CannedACL": "string", "Encryption": { "EncryptionType": "string", "KMSContext": "string", "KMSKeyId": "string" }, "Prefix": "string", "StorageClass": "string", "Tagging": { "string": "string" }, "UserMetadata": { "string": "string" } } }, "RetrievalByteRange": "string", "SelectParameters": { "Expression": "string", "ExpressionType": "string", "InputSerialization": { "csv": { "Comments": "string", "FieldDelimiter": "string", "FileHeaderInfo": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "RecordDelimiter": "string" } }, "OutputSerialization": { "csv": { "FieldDelimiter": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "QuoteFields": "string", "RecordDelimiter": "string" } } }, "SHA256TreeHash": "string", "SNSTopic": "string", "StatusCode": "string", "StatusMessage": "string", "Tier": "string", "VaultARN": "string" } ``` ### Header Respons 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 Isi respons berisi bidang JSON berikut. **Tindakan** Jenis tugas. Baik `ArchiveRetrieval`, `InventoryRetrieval`, maupun `Select`. *Tipe*: String **ArchiveId** ID arsipyang diminta untuk memilih atau mengarsipkan tugas pengambilan. Jika tidak, bidang ini adalah `null`. *Tipe*: String **Arsip SHA256 TreeHash** Hash SHA256 pohon dari seluruh arsip untuk pekerjaan pengambilan arsip. Untuk tugas pengambilan inventaris, bidang ini adalah `null`. *Tipe*: String **ArchiveSizeInBytes** Untuk tugas `ArchiveRetrieval`, ini berukuran dalam byte dari arsip yang diminta untuk diunduh. Untuk tugas `InventoryRetrieval`, nilai adalah `null`. *Tipe*: Angka **Selesai** Status tugas. Ketika arsip atau tugas pengambilan inventaris selesai, Anda mendapatkan output tugas menggunakan [Mendapatkan Output Tugas (GET output)](api-job-output-get.md). *Tipe*: Boolean **CompletionDate** Waktu Universal Terkoordinasi (UTC) saat permintaan tugas selesai. Sewaktu tugas sedang berlangsung, nilai adalah nol. *Tipe*: String **CreationDate** Waktu UTC saat tugas dibuat. *Tipe*: Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`. **InventoryRetrievalParameters** Parameter input yang digunakan untuk pengambilan berbagai inventaris. *Tipe*: Objek [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) **InventorySizeInBytes** Untuk tugas `InventoryRetrieval`, ini berukuran dalam byte dari inventaris yang diminta untuk diunduh. Untuk tugas `ArchiveRetrieval` atau `Select`, nilai adalah `null`. *Tipe*: Angka **JobDescription** Deskripsi tugas yang Anda berikan ketika Anda memulai tugas. *Tipe*: String **JobId** ID yang mengidentifikasi pekerjaan di Amazon Glacier. *Tipe*: String **JobOutputPath** Berisi lokasi output tugas. *Tipe*: String **OutputLocation** Objek yang berisi informasi tentang lokasi tempat hasil pilih tugas dan kesalahan disimpan. *Tipe*: Objek [OutputLocation](api-OutputLocation.md) **RetrievalByteRange** Rentang byte yang diambil untuk pekerjaan pengambilan arsip dalam bentuk "*StartByteValue*-*EndByteValue*.” Jika Anda tidak menentukan rentang dalam pengambilan arsip, maka seluruh arsip diambil; juga *StartByteValue*sama dengan 0, dan *EndByteValue*sama dengan ukuran arsip dikurangi 1. Untuk tugas pengambilan atau pemilihan inventaris, bidang ini adalah `null`. *Tipe*: String **SelectParameters** Objek yang berisi informasi tentang parameter yang digunakan untuk select. *Tipe*: Objek [SelectParameters](api-SelectParameters.md) **SHA256TreeHash** Nilai hash SHA256 pohon untuk rentang arsip yang diminta. Jika permintaan [Memulai Tugas (POST jobs)](api-initiate-job-post.md) untuk arsip menentukan rentang tree-hash selaras, bidang ini mengembalikan nilai. Untuk informasi selengkapnya tentang penyelarasan tree-hash untuk pengambilan rentang arsip, lihat [Menerima Checksum Saat Mengunduh Data](checksum-calculations-range.md). Untuk kasus tertentu ketika seluruh arsip diambil, nilai ini sama dengan nilai `ArchiveSHA256TreeHash`. Bidang ini adalah `null` dalam situasi berikut: + Tugas pengambilan arsip yang menentukan rentang yang bukan tree-hash selaras. + Tugas arsip yang menentukan rentang yang sama dengan status seluruh arsip dan tugas adalah `InProgress`. + Tugas inventaris. + Pilih tugas. *Tipe*: String **SNSTopic** Topik Amazon SNS yang menerima notifikasi. *Tipe*: String **StatusCode** Kode yang menunjukkan status tugas. *Nilai yang Valid*: `InProgress` \$1 `Succeeded` \$1 `Failed` *Tipe*: String **StatusMessage** Pesan mudah diingar yang menjelaskan status tugas. *Tipe*: String **Tingkat** Tingkat akses data yang digunakan untuk pengambilan pilih atau arsip. *Nilai yang Valid*: `Bulk` \$1 `Expedited` \$1 `Standard` *Tipe*: String **Vaultarn** Amazon Resource Name (ARN) dari vault yang tugasnya adalah subsumber daya. *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. ### Permintaan Contoh: Mendapatkan deskripsi tugas ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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 Isi respon termasuk JSON yang menggambarkan tugas yang ditentukan. Perhatikan bahwa untuk tugas pengambilan inventaris dan pengambilan arsip, bidang JSON adalah sama. Namun, ketika bidang tidak berlaku untuk tipe tugas, nilainya adalah `null`. Berikut ini adalah contoh respons untuk tugas pengambilan arsip. Perhatikan hal-hal berikut: + Nilai bidang `Action` adalah `ArchiveRetrieval`. + Bidang `ArchiveSizeInBytes` menunjukkan ukuran arsip yang diminta dalam tugas pengambilan arsip. + `ArchiveSHA256TreeHash`Bidang menunjukkan hash SHA256 pohon untuk seluruh arsip. + Bidang `RetrievalByteRange` menunjukkan rentang yang diminta dalam permintaan Mulai Tugas. Dalam contoh ini, seluruh arsip diminta. + `SHA256TreeHash`Bidang menunjukkan hash SHA256 pohon untuk rentang yang diminta dalam permintaan Initiate Job. Dalam contoh ini, ini sama dengan bidang `ArchiveSHA256TreeHash`, yang berarti seluruh arsip diminta. + Nilai bidang `InventorySizeInBytes` adalah `null` karena tidak berlaku untuk tugas pengambilan arsip. ``` 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: 419 6. { 7. "Action": "ArchiveRetrieval", 8. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 9. "ArchiveSizeInBytes": 16777216, 10. "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 11. "Completed": false, 12. "CompletionDate": null, 13. "CreationDate": "2012-05-15T17:21:39.339Z", 14. "InventorySizeInBytes": null, 15. "JobDescription": "My ArchiveRetrieval Job", 16. "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", 17. "RetrievalByteRange": "0-16777215", 18. "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 19. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", 20. "StatusCode": "InProgress", 21. "StatusMessage": "Operation in progress.", 22. "Tier": "Bulk", 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 24. } ``` Berikut adalah contoh respons untuk tugas pengambilan inventaris. Perhatikan hal-hal berikut: + Nilai bidang `Action` adalah `InventoryRetrieval`. + Nilai bidang `ArchiveSizeInBytes`, `ArchiveSHA256TreeHash`, dan `RetrievalByteRange` adalah nol karena bidang ini tidak berlaku untuk tugas pengambilan inventaris. + Nilai bidang `InventorySizeInBytes` adalah `null` karena tugas masih sedang berlangsung, dan belum sepenuhnya mempersiapkan persediaan untuk diunduh. Jika tugas selesai sebelum Anda menjelaskan permintaan tugas, bidang ini akan memberikan ukuran output. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "ArchiveSHA256TreeHash": null, "Completed": false, "CompletionDate": null, "CreationDate": "2012-05-15T23:18:13.224Z", "InventorySizeInBytes": null, "JobDescription": "Inventory Description", "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode": "InProgress", "StatusMessage": "Operation in progress.", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ``` Berikut adalah contoh respons untuk tugas pengambilan inventaris yang selesai yang berisi penanda yang digunakan untuk melanjutkan pemberian nomor halaman dari pengambilan inventaris vault. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSHA256TreeHash": null, "ArchiveSizeInBytes": null, "Completed": true, "CompletionDate": "2013-12-05T21:51:13.591Z", "CreationDate": "2013-12-05T21:51:12.281Z", "InventorySizeInBytes": 777062, "JobDescription": null, "JobId": "sCC2RZNBF2nildYD_roe0J9bHRdPQUbDRkmTdg-mXi2u3lc49uW6TcEhDF2D9pB2phx-BN30JaBru7PMyOlfXHdStzu8", "NextInventoryRetrievalMarker": null, "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Bulk", "VaultARN": "arn:aws:glacier-devo:us-west-2:836579025725:vaults/inventory-icecube-2", "InventoryRetrievalParameters": { "StartDate": "2013-11-12T13:43:12Z", "EndDate": "2013-11-20T08:12:45Z", "Limit": "120000", "Format": "JSON", "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" }, } ``` ## Bagian Terkait + [Mendapatkan Output Tugas (GET output)](api-job-output-get.md) + [Identity and Access Management untuk Amazon Glacier](security-iam.md) # 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) # Memulai Tugas (POST jobs) Operasi ini memulai jenis pekerjaan Amazon Glacier (Amazon Glacier) berikut: + `archive-retrieval`— Mengambil arsip. + `inventory-retrieval`— Menyediakan vault. **Topics** + [Memulai Tugas Pengambilan Arsip atau Inventaris Vault](#api-initiate-job-post-description) + [Permintaan](#api-initiate-job-post-requests) + [Respons](#api-initiate-job-post-responses) + [Contoh](#api-initiate-job-post-examples) + [Bagian Terkait](#more-info-api-initiate-job-post) ## Memulai Tugas Pengambilan Arsip atau Inventaris Vault Mengambil arsip atau inventaris vault adalah operasi asinkron yang mengharuskan Anda memulai tugas. Setelah dimulai, tugas tidak dapat dibatalkan. Pengambilan adalah proses dua langkah: 1. Mulai tugas pengambilan menggunakan operasi [Memulai Tugas (POST jobs)](#api-initiate-job-post). **penting** Kebijakan pengambilan data dapat menyebabkan permintaan mulai tugas pengambilan Anda gagal dengan `PolicyEnforcedException`. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat [Kebijakan Pengambilan Data Amazon Glacier](data-retrieval-policy.md). Untuk informasi selengkapnya tentang pengecualian `PolicyEnforcedException`, lihat [Respons Kesalahan](api-error-responses.md). 1. Setelah tugas selesai, unduh byte menggunakan operasi [Mendapatkan Output Tugas (GET output)](api-job-output-get.md). Permintaan pengambilan dijalankan secara asinkron. Ketika Anda memulai tugas pengambilan, Amazon Glacier membuat tugas dan menghasilkan ID tugas dalam respons. Saat Amazon Glacier menyelesaikan pekerjaan, Anda bisa mendapatkan output pekerjaan (data arsip atau inventaris). Untuk informasi tentang mendapatkan output tugas, lihat operasi [Mendapatkan Output Tugas (GET output)](api-job-output-get.md). Tugas harus selesai sebelum Anda bisa mendapatkan outputnya. Untuk menentukan kapan tugas selesai, Anda memiliki opsi berikut: + **Gunakan pemberitahuan Amazon SNS—** Anda dapat menentukan topik Amazon SNS yang Amazon Glacier dapat memposting pemberitahuan setelah pekerjaan selesai. Anda dapat menentukan topik SNS per permintaan tugas. Pemberitahuan dikirim hanya setelah Amazon Glacier menyelesaikan pekerjaan. Selain menentukan topik SNS per permintaan tugas, Anda dapat mengonfigurasi notifikasi vault untuk vault sehingga notifikasi tugas dikirim untuk semua pengambilan. Untuk informasi selengkapnya, lihat [Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration)](api-vault-notifications-put.md). + **Dapatkan detail tugas—** Anda dapat membuat permintaan [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md) untuk mendapatkan informasi status tugas saat tugas sedang berlangsung. Namun, penggunaan notifikasi Amazon SNS untuk menentukan kapan tugas selesai lebih efisien. **catatan** Informasi yang Anda dapatkan melalui notifikasi sama dengan yang Anda dapatkan dengan memanggil [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md). Jika untuk acara tertentu, Anda menambahkan konfigurasi notifikasi pada vault dan juga menentukan topik SNS dalam permintaan pekerjaan inisiat Anda, Amazon Glacier mengirimkan kedua notifikasi. Untuk informasi selengkapnya, lihat [Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration)](api-vault-notifications-put.md). ### Inventaris Vault Amazon Glacier memperbarui inventaris brankas kira-kira sekali sehari, dimulai pada hari Anda pertama kali mengunggah arsip ke lemari besi. Jika tidak ada penambahan arsip atau penghapusan vault sejak inventaris terakhir, tanggal inventaris tidak diperbarui. Saat Anda memulai pekerjaan untuk inventaris vault, Amazon Glacier mengembalikan inventaris terakhir yang dihasilkannya, yang merupakan point-in-time snapshot dan bukan data real-time. Setelah Amazon Glacier membuat inventaris pertama untuk lemari besi, biasanya dibutuhkan setengah hari dan hingga sehari sebelum inventaris itu tersedia untuk diambil. Anda mungkin merasa mengambil inventaris vault untuk setiap unggahan arsip tidak berguna. Namun, misalkan Anda memelihara database di sisi klien terkait metadata tentang arsip yang Anda unggah ke Amazon Glacier. Selanjutnya, Anda mungkin merasa inventaris vault berguna untuk mencocokkan informasi, jika perlu, dalam basis data Anda dengan inventaris vault aktual. Untuk informasi selengkapnya tentang bidang data yang dikembalikan dalam output tugas, lihat [Isi Respons](api-job-output-get.md#api-job-output-get-responses-elements). ### Pengambilan Inventaris Rentang Anda dapat membatasi jumlah item inventaris yang diambil dengan memfilter tanggal pembuatan arsip atau dengan menetapkan batas. **Memfilter berdasarkan Tanggal Pembuatan Arsip** Anda dapat mengambil item inventaris untuk arsip yang dibuat antara `StartDate` dan `EndDate` dengan menentukan nilai untuk parameter ini dalam permintaan **Mulai Tugas**. Arsip yang dibuat di atau setelah `StartDate` dan sebelum `EndDate` dikembalikan. Jika Anda hanya memberikan `StartDate` tanpa `EndDate`, Anda mengambil inventaris untuk semua arsip yang dibuat pada atau setelah `StartDate`. Jika Anda hanya memberikan `EndDate` tanpa `StartDate`, Anda mengambil inventaris untuk semua arsip yang dibuat sebelum `EndDate`. **Membatasi Item Inventaris per Pengambilan** Anda dapat membatasi jumlah item inventaris yang dikembalikan dengan mengatur parameter `Limit` dalam permintaan **Mulai Tugas**. Output tugas inventaris berisi item inventaris sampai dengan `Limit` yang ditentukan. Jika ada lebih banyak item inventarus yang tersedia, hasilnya adalah pemberian nomor halaman. Setelah tugas selesai, Anda dapat menggunakan operasi [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md) untuk mendapatkan penanda yang Anda gunakan dalam permintaan **Mulai Tugas** berikut. Penanda menunjukkan titik awal untuk mengambil sekumpulan item inventaris berikutnya. Anda dapat menelusuri seluruh inventaris dengan berulang kali membuat permintaan **Mulai Tugas** dengan penanda dari output **Jelaskan Tugas** sebelumnya. Anda melakukannya sampai Anda mendapatkan penanda dari **Jelaskan Tugas** yang mengembalikan nol, menunjukkan tidak ada item lainnya yang tersedia. Anda dapat menggunakan parameter `Limit` bersama-sama dengan parameter rentang tanggal. ### Pengambilan Arsip Berkisar Anda dapat memulai pengambilan arsip untuk seluruh arsip atau rentang arsip. Dalam hal pengambilan arsip berkisar, Anda menentukan rentang byte untuk dikembalikan atau seluruh arsip. Rentang yang ditentukan harus megabyte (MB) selaras. Dengan kata lain, rentang awal nilai harus habis dibagi 1 MB dan rentang nilai akhir ditambah 1 harus habis dibagi 1 MB atau sama dengan akhir arsip. Jika pengambilan arsip berkisar bukan megabyte selaras, operasi ini mengembalikan respons `400`. Selain itu, untuk memastikan Anda mendapatkan nilai checksum untuk data yang Anda unduh menggunakan **Dapatkan Output Tugas** ([Mendapatkan Output Tugas (GET output)](api-job-output-get.md)), rentang harus berupa tree-hash selaras. Untuk informasi selengkapnya tentang rentang tree-hash selaras, lihat [Menerima Checksum Saat Mengunduh Data](checksum-calculations-range.md). ### Tingkat Dipercepat, Standar, dan Massal. Saat memulai pekerjaan pengambilan arsip, Anda dapat menentukan salah satu opsi berikut di `Tier` bidang badan permintaan: + **`Expedited`**— Dipercepat memungkinkan Anda untuk dengan cepat mengakses data Anda ketika permintaan mendesak sesekali untuk memulihkan arsip diperlukan. Untuk semua, kecuali arsip terbesar (250 MB\$1), data yang diakses menggunakan tingkat Dipercepat biasanya disediakan dalam waktu 1–5 menit. + **`Standard`** – Standar memungkinkan Anda mengakses salah satu arsip Anda dalam beberapa jam. Data yang diakses menggunakan tingkat Standar biasanya tersedia dalam 3–5 jam. Ini adalah opsi default untuk permintaan tugas yang tidak menentukan opsi tingkat. + **`Bulk`**- Massal adalah tingkat biaya terendah untuk Amazon Glacier, memungkinkan Anda untuk mengambil sejumlah besar, bahkan petabyte, data dengan harga murah dalam sehari. Data yang diakses menggunakan tingkat Massal biasanya tersedia dalam 5–12 jam. Untuk informasi selengkapnya tentang pengambilan yang dipercepat dan massal, lihat [Mengambil Arsip Amazon Glacier](downloading-an-archive-two-steps.md). ## Permintaan Untuk memulai tugas, Anda menggunakan metode `POST` HTTP dan mencakup permintaan untuk subsumber daya `jobs` vault. Anda menentukan detail permintaan tugas dalam dokumen JSON dari permintaan Anda. Tipe tugas ditentukan dengan bidang `Type`. Secara opsional, Anda dapat menentukan `SNSTopic` bidang untuk menunjukkan topik Amazon SNS tempat Amazon Glacier dapat memposting pemberitahuan setelah menyelesaikan pekerjaan. **catatan** Untuk mengirim notifikasi ke Amazon SNS, Anda harus membuat topik sendiri jika belum ada. Amazon Glacier tidak membuat topik untuk Anda. Topik harus memiliki izin untuk menerima publikasi dari lemari besi Amazon Glacier. Amazon Glacier tidak memverifikasi apakah brankas memiliki izin untuk mempublikasikan ke topik. Jika izin tidak dikonfigurasi dengan tepat, Anda mungkin tidak menerima notifikasi bahkan setelah tugas selesai. ### Sintaksis Berikut ini adalah sintaks permintaan untuk memulai tugas. ``` 1. POST /AccountId/vaults/VaultName/jobs HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 6. 7. { 8. "jobParameters": { 9. "ArchiveId": "string", 10. "Description": "string", 11. "Format": "string", 12. "InventoryRetrievalParameters": { 13. "EndDate": "string", 14. "Limit": "string", 15. "Marker": "string", 16. "StartDate": "string" 17. }, 18. "OutputLocation": { 19. "S3": { 20. "AccessControlList": [ 21. { 22. "Grantee": { 23. "DisplayName": "string", 24. "EmailAddress": "string", 25. "ID": "string", 26. "Type": "string", 27. "URI": "string" 28. }, 29. "Permission": "string" 30. } 31. ], 32. "BucketName": "string", 33. "CannedACL": "string", 34. "Encryption": { 35. "EncryptionType": "string", 36. "KMSContext": "string", 37. "KMSKeyId": "string" 38. }, 39. "Prefix": "string", 40. "StorageClass": "string", 41. "Tagging": { 42. "string" : "string" 43. }, 44. "UserMetadata": { 45. "string" : "string" 46. } 47. } 48. }, 49. "RetrievalByteRange": "string", 50. "SelectParameters": { 51. "Expression": "string", 52. "ExpressionType": "string", 53. "InputSerialization": { 54. "csv": { 55. "Comments": "string", 56. "FieldDelimiter": "string", 57. "FileHeaderInfo": "string", 58. "QuoteCharacter": "string", 59. "QuoteEscapeCharacter": "string", 60. "RecordDelimiter": "string" 61. } 62. }, 63. "OutputSerialization": { 64. "csv": { 65. "FieldDelimiter": "string", 66. "QuoteCharacter": "string", 67. "QuoteEscapeCharacter": "string", 68. "QuoteFields": "string", 69. "RecordDelimiter": "string" 70. } 71. } 72. }, 73. "SNSTopic": "string", 74. "Tier": "string", 75. "Type": "string" 76. } 77. } ``` **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. ### Isi Permintaan Permintaan menerima data berikut dalam format JSON dalam isi permintaan. jobParameters Menyediakan opsi untuk menentukan informasi tugas. *Tipe*: Objek [jobParameters](api-jobParameters.md) *Wajib*: Ya ## Respons Amazon Glacier menciptakan pekerjaan itu. Sebagai respons, S3 Glacier mengembalikan URI tugas. ### Sintaksis ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: location 5. x-amz-job-id: jobId 6. x-amz-job-output-path: jobOutputPath ``` ### Header Respons | Header | Deskripsi | | --- | --- | | Location | Jalur URI relatif dari tugas. Anda dapat menggunakan jalur URI ini untuk menemukan status tugas. Untuk informasi selengkapnya, lihat [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md). Tipe: String Default: Tidak ada | | x-amz-job-id | ID tugas. Nilai ini juga disertakan sebagai bagian dari header `Location`. Tipe: String Default: Tidak Ada | | x-amz-job-output-path | Jalur ke lokasi tempat hasil pilih disimpan. Tipe: String Default: Tidak ada | ### Isi Respons Operasi ini tidak mengembalikan isi respons. ### Kesalahan 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 | | --- | --- | --- | --- | | InsufficientCapacityException | Dikembalikan jika kapasitas tidak memadai untuk memproses permintaan yang dipercepat ini. Kesalahan ini hanya berlaku untuk pengambilan yang dipercepat dan bukan untuk pengambilan standar atau massal. | 503 Service Unavailable | Server | ## Contoh ### Contoh Permintaan: Memulai tugas pengambilan arsip ``` 1. POST /-/vaults/examplevault/jobs 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. "Type": "archive-retrieval", 9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 10. "Description": "My archive description", 11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", 12. "Tier" : "Bulk" 13. } ``` Berikut adalah contoh isi permintaan yang menentukan rentang arsip yang diambil menggunakan bidang `RetrievalByteRange`. ``` { "Type": "archive-retrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "Description": "My archive description", "RetrievalByteRange": "2097152-4194303", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", "Tier" : "Bulk" } ``` ### Contoh Respons ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Contoh Permintaan: Memulai tugas pengambilan inventaris Permintaan berikut memulai tugas pengambilan inventaris untuk mendapatkan daftar arsip dari vault `examplevault`. `Format` yang ditetapkan ke `CSV` dalam isi permintaan menunjukkan inventaris dikembalikan dalam format CSV. ``` 1. POST /-/vaults/examplevault/jobs HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Content-Type: application/x-www-form-urlencoded 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 7. 8. { 9. "Type": "inventory-retrieval", 10. "Description": "My inventory job", 11. "Format": "CSV", 12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" 13. } ``` ### Contoh Respons ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Contoh Permintaan: Memulai tugas pengambilan inventaris menggunakan penyaringan tanggal dengan batas yang ditetapkan, dan permintaan berikutnya untuk mengambil halaman item inventaris berikutnya. Permintaan berikut memulai tugas pengambilan inventaris vault menggunakan penyaringan tanggal dan menetapkan batas. ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit" : "10000" 12. }, 13. } ``` Permintaan berikut adalah contoh dari permintaan berikutnya untuk mengambil halaman item inventaris berikutnya menggunakan penanda yang diperoleh dari [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md). ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit": "10000", 12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 13. }, 14. } ``` ### Contoh Respons ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/ ``` ## Bagian Terkait + [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md) + [Mendapatkan Output Tugas (GET output)](api-job-output-get.md) + [Identity and Access Management untuk Amazon Glacier](security-iam.md) # Mencantumkan Tugas (GET jobs) ## Deskripsi Operasi ini mencantumkan daftar tugas untuk vault, termasuk tugas yang sedang berlangsung dan tugas yang baru saja selesai. **catatan** Amazon Glacier (Amazon Glacier) mempertahankan pekerjaan yang baru saja selesai untuk jangka waktu sebelum menghapusnya; Namun, akhirnya menghapus pekerjaan yang sudah selesai. Output dari tugas yang diselesaikan dapat diambil. Mempertahankan tugas yang selesai untuk jangka waktu tertentu setelah selesai memungkinkan Anda mendapatkan output tugas jika Anda melewatkan notifikasi penyelesaian tugas, atau upaya pertama Anda untuk mengunduhnya gagal. Misalnya, Anda memulai tugas pengambilan arsip untuk mengunduh arsip. Setelah tugas selesai, Anda mulai mengunduh arsip, tetapi mengalami kesalahan jaringan. Dalam skenario ini, Anda dapat mencoba lagi dan mengunduh arsip sewaktu tugas ada. Operasi `List Jobs` mendukung pemberian nomor halaman. Anda harus selalu memeriksa bidang `Marker` respons. Jika tidak ada tugas lainnya yang dicantumkan, bidang `Marker` diatur ke `null`. Jika ada tugas lainnya yang dicantumkan, bidang `Marker` diatur ke nilai non-nol, yang dapat Anda gunakan untuk melanjutkan pemberian nomor halaman daftar. Untuk mengembalikan daftar tugas yang dimulai pada tugas tertentu, atur parameter permintaan `marker` ke nilai `Marker` untuk tugas yang Anda peroleh dari permintaan `List Jobs` sebelumnya. Anda juga dapat menetapkan batas maksimum untuk jumlah tugas yang dikembalikan dalam respons dengan menentukan parameter `limit` dalam permintaan. Batas default adalah 50. Jumlah tugas yang dikembalikan mungkin kurang dari batas, tetapi jumlah tugas yang dikembalikan tidak pernah melebihi batas. Selain itu, Anda dapat memfilter daftar tugas yang dikembalikan dengan menentukan parameter `statuscode` opsional atau parameter `completed`, atau pun keduanya. Dengan menggunakan parameter `statuscode`, Anda dapat menentukan untuk hanya mengembalikan tugas yang cocok dengan status `InProgress`, `Succeeded`, atau `Failed`. Dengan menggunakan parameter `completed`, Anda dapat menentukan untuk hanya mengembalikan tugas yang sudah selesai (`true`) atau tugas yang belum selesai (`false`). ## Permintaan ### Sintaksis Untuk mengembalikan daftar tugas dari semua tipe, kirim permintaan `GET` ke URI dari subsumber daya `jobs` vault. ``` 1. GET /AccountId/vaults/VaultName/jobs 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 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 | Nama | Deskripsi | Wajib | | --- | --- | --- | | completed | Status tugas yang dikembalikan. Anda dapat menentukan `true` atau `false`. Tipe: Boolean Batasan: Tidak Ada | Tidak | | limit | Jumlah maksimum tugas yang dikembalikan. Batas default adalah 50. Jumlah tugas yang dikembalikan mungkin kurang dari batas yang ditentukan, tetapi jumlah tugas yang dikembalikan tidak pernah melebihi batas. Tipe: String Batasan: Nilai bilangan bulat minimum 1. Nilai bilangan bulat maksimum sebesar 50. | Tidak | | marker | String buram yang digunakan untuk pemberian nomor halaman yang menentukan tugas tempat cantuman bagian harus dimulai. Anda mendapatkan nilai `marker` dari respons `List Jobs` sebelumnya. Anda harus menyertakan `marker` jika Anda melanjutkan pemberian nomor halaman dari hasil yang dimulai dalam permintaan `List Jobs` sebelumnya. Tipe: String Batasan: Tidak Ada | Tidak | | statuscode | Tipe status tugas yang dikembalikan. Tipe: String Batasan: Salah satu nilai `InProgress`, `Succeeded`, atau `Failed`. | Tidak | ### Header Permintaan 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 Permintaan Operasi ini tidak memiliki isi permintaan. ## Respons ### Sintaksis ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location Content-Type: application/json Content-Length: Length { "JobList": [ { "Action": "string", "ArchiveId": "string", "ArchiveSHA256TreeHash": "string", "ArchiveSizeInBytes": number, "Completed": boolean, "CompletionDate": "string", "CreationDate": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Format": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "InventorySizeInBytes": number, "JobDescription": "string", "JobId": "string", "JobOutputPath": "string", "OutputLocation": { "S3": { "AccessControlList": [ { "Grantee": { "DisplayName": "string", "EmailAddress": "string", "ID": "string", "Type": "string", "URI": "string" }, "Permission": "string" } ], "BucketName": "string", "CannedACL": "string", "Encryption": { "EncryptionType": "string", "KMSContext": "string", "KMSKeyId": "string" }, "Prefix": "string", "StorageClass": "string", "Tagging": { "string": "string" }, "UserMetadata": { "string": "string" } } }, "RetrievalByteRange": "string", "SelectParameters": { "Expression": "string", "ExpressionType": "string", "InputSerialization": { "csv": { "Comments": "string", "FieldDelimiter": "string", "FileHeaderInfo": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "RecordDelimiter": "string" } }, "OutputSerialization": { "csv": { "FieldDelimiter": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "QuoteFields": "string", "RecordDelimiter": "string" } } }, "SHA256TreeHash": "string", "SNSTopic": "string", "StatusCode": "string", "StatusMessage": "string", "Tier": "string", "VaultARN": "string" } ], "Marker": "string" } ``` ### Header Respons 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 Isi respons berisi bidang JSON berikut. **JobList** Daftar objek tugas. Setiap objek tugas berisi metadata yang menggambarkan tugas. *Tipe*: Array objek [GlacierJobDescription](api-GlacierJobDescription.md) **Penanda** String buram yang mewakili tempat untuk melanjutkan pemberian nomor halaman hasil. Anda menggunakan nilai `marker` dalam permintaan ` List Jobs` baru untuk mendapatkan lebih banyak tugas dalam daftar. Jika tidak ada tugas lainnya, nilai ini adalah `null`. *Tipe*: String ### Kesalahan Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md) ## Contoh Contoh berikut menunjukkan cara mengembalikan informasi tentang tugas vault. Contoh pertama mengembalikan daftar dua tugas, dan contoh kedua mengembalikan subset tugas. ### Contoh: Mengembalikan Semua Tugas #### Contoh Permintaan Permintaan `GET` berikut mengembalikan tugas untuk vault. ``` 1. GET /-/vaults/examplevault/jobs 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 Respons berikut menyertakan tugas pengambilan arsip dan tugas pengambilan inventaris yang berisi penanda yang digunakan untuk melanjutkan pemberian nomor halaman dari pengambilan inventaris vault. Respons juga menunjukkan bidang `Marker` yang diatur ke`null`, yang menunjukkan tidak ada lagi tugasyang dicantumkan. ``` 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: 1444 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "BDfaUQul0dVzYwAMr8YSa_6_8abbhZq-i1oT69g8ByClfJyBgAGBkWl2QbF5os851P7Y7KdZDOHWJIn4rh1ZHaOYD3MgFhK_g0oDPesW34uHQoVGwoIqubf6BgUEfQm_wrU4Jlm3cA", 12. "ArchiveSizeInBytes": 1048576, 13. "ArchiveSHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:00:09.304Z", 16. "CreationDate": "2012-05-01T00:00:06.663Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": null, 19. "JobId": "hDe9t9DTHXqFw8sBGpLQQOmIM0-JrGtu1O_YFKLnzQ64548qJc667BRWTwBLZC76Ygy1jHYruqXkdcAhRsh0hYv4eVRU", 20. "RetrievalByteRange": "0-1048575", 21. "SHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "InventoryRetrieval", 30. "ArchiveId": null, 31. "ArchiveSizeInBytes": null, 32. "ArchiveSHA256TreeHash": null, 33. "Completed": true, 34. "CompletionDate": "2013-05-11T00:25:18.831Z", 35. "CreationDate": "2013-05-11T00:25:14.981Z", 36. "InventorySizeInBytes": 1988, 37. "JobDescription": null, 38. "JobId": "2cvVOnBL36btzyP3pobwIceiaJebM1bx9vZOOUtmNAr0KaVZ4WkWgVjiPldJ73VU7imlm0pnZriBVBebnqaAcirZq_C5", 39. "RetrievalByteRange": null, 40. "SHA256TreeHash": null, 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 45. "InventoryRetrievalParameters": { 46. "StartDate": "2013-11-12T13:43:12Z", 47. "EndDate": "2013-11-20T08:12:45Z", 48. "Limit": "120000", 49. "Format": "JSON", 50. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 51. } 52. ], 53. "Marker": null 54. } ``` ### Contoh: Mengembalikan Daftar Sebagian Tugas #### Contoh Permintaan Permintaan `GET` berikut mengembalikan tugas yang ditentukan oleh parameter `marker`. Mengatur parameter `limit` sebagai `2` menetapkan bahwa hingga dua tugas dikembalikan. ``` 1. GET /-/vaults/examplevault/jobs?marker=HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID&limit=2 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 Respons berikut menunjukkan dua tugas yang dikembalikan dan bidang `Marker` yang diatur ke nilai non-nol yang dapat digunakan untuk melanjutkan pemberian nomor halaman daftar tugas. ``` 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: 1744 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "58-3KpZfcMPUznvMZNPaKyJx9wODCsWTnqcjtx2CjKZ6b-XgxEuA8yvZOYTPQfd7gWR4GRm2XR08gcnWbLV4VPV_kDWtZJKi0TFhKKVPzwrZnA4-FXuIBfViYUIVveeiBE51FO4bvg", 12. "ArchiveSizeInBytes": 8388608, 13. "ArchiveSHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:25:20.043Z", 16. "CreationDate": "2012-05-01T00:25:16.344Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": "aaabbbccc", 19. "JobId": "s4MvaNHIh6mOa1f8iY4ioG2921SDPihXxh3Kv0FBX-JbNPctpRvE4c2_BifuhdGLqEhGBNGeB6Ub-JMunR9JoVa8y1hQ", 20. "RetrievalByteRange": "0-8388607", 21. "SHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "ArchiveRetrieval", 30. "ArchiveId": "2NVGpf83U6qB9M2u-Ihh61yoFLRDEoh7YLZWKBn80A2i1xG8uieBwGjAr4RkzOHA0E07ZjtI267R03Z-6Hxd8pyGQkBdciCSH1-Lw63Kx9qKpZbPCdU0uTW_WAdwF6lR6w8iSyKdvw", 31. "ArchiveSizeInBytes": 1048576, 32. "ArchiveSHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 33. "Completed": true, 34. "CompletionDate": "2012-05-01T16:59:48.444Z", 35. "CreationDate": "2012-05-01T16:59:42.977Z", 36. "InventorySizeInBytes": null, 37. "JobDescription": "aaabbbccc", 38. "JobId": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG", 39. "RetrievalByteRange": "0-1048575", 40. "SHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "Tier": "Standard", 45. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 46. } 47. ], 48. "Marker": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG" 49. } ``` ## Bagian Terkait + [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md) + [Identity and Access Management untuk Amazon Glacier](security-iam.md)