**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, AWS Region 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. # 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` \| `Succeeded` \| `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` \| `Expedited` \| `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)