Mendapatkan Output Tugas (GET output) - Amazon Glacier
DeskripsiPermintaanResponsContohBagian Terkait

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.

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak akan lagi menerima pelanggan baru mulai 15 Desember 2025, tanpa berdampak pada pelanggan yang sudah ada. 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, 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.

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). 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. 

GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Range: ByteRangeToRetrieve
x-amz-glacier-version: 2012-06-01

catatan

AccountIdNilainya 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.

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. 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:

  1. Unduh potongan output sebesar 128 MB dengan menentukan rentang byte yang sesuai menggunakan header Range. Verifikasi semua 128 MB data diterima.

  2. Bersama dengan data, respons akan mencakup checksum dari muatan. Anda menghitung checksum muatan pada klien dan membandingkannya dengan checksum yang Anda terima sebagai respons untuk memastikan Anda menerima semua data yang diharapkan.

  3. Ulangi langkah 1 dan 2 untuk kedelapan potongan data output sebesar 128 MB, setiap kali menentukan rentang byte yang sesuai.

  4. Setelah mengunduh semua bagian dari output tugas, Anda memiliki daftar delapan nilai checksum. Hitung hash pohon dari nilai-nilai ini untuk menemukan checksum dari seluruh output. Menggunakan operasi Mendeskripsikan Tugas (GET JobID), dapatkan informasi tugas dari tugas yang memberi Anda output. Tanggapan tersebut mencakup checksum dari seluruh arsip yang disimpan di Amazon Glacier. Anda membandingkan nilai ini dengan checksum yang Anda hitung untuk memastikan Anda sudah mengunduh seluruh konten arsip tanpa kesalahan.

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 respons206 Partial Content dikembalikan.

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: ContentType
Content-Length: Length
x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier

[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.

Tipe: String
Content-Type

Content-Type bergantung pada apakah output tugas adalah arsip atau inventaris vault.

  • Untuk data arsip, Content-Type adalah application/octet-stream.

  • Untuk inventaris vault, jika Anda meminta format CSV saat memulai tugas, Content-Type adalah text/csv. Jika tidak, secara default, inventaris vault dikembalikan sebagai JSON, dan Content-Type adalah application/json.

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.

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:

  • Anda mendapatkan seluruh rentang data yang diambil.

  • Anda meminta rentang byte dari data yang diambil yang berukuran megabyte (1024 KB) yang dikalikan dengan pangkat 2 serta yang dimulai dan berakhir di beberapa ukuran rentang yang diminta. Sebagai contoh, jika Anda memiliki 3,1 MB data yang diambil dan Anda menentukan rentang untuk dikembalikan yang dimulai pada 1 MB dan berakhir pada 2 MB, x-amz-sha256-tree-hash dikembalikan sebagai header respons.

  • Anda meminta rentang untuk mengembalikan data yang diambil yang mengarah ke bagian akhir data, dan awal rentang adalah kelipatan dari ukuran rentang yang diambil yang dibulatkan ke pangkat dua berikutnya, tetapi tidak lebih kecil dari satu megabyte (1024 KB). Sebagai contoh, jika Anda memiliki 3,1 MB data yang diambil dan Anda menentukan rentang yang dimulai pada 2 MB dan berakhir pada 3,1 MB (akhir data), x-amz-sha256-tree-hash dikembalikan sebagai header respons.

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. 

{
 "VaultARN": String,
 "InventoryDate": String,
 "ArchiveList": [
      {"ArchiveId": String,
       "ArchiveDescription": String,
       "CreationDate": String,
       "Size": Number,
       "SHA256TreeHash": String
      },
      ...
    ]
}

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

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 

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/octet-stream
Content-Length: 1048576

[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.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 906

{
 "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
 "InventoryDate": "2011-12-12T14:19:01Z",
 "ArchiveList": [
   {
     "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA",
     "ArchiveDescription": "my archive1",
     "CreationDate": "2012-05-15T17:19:46.700Z",
     "Size": 2140123,
     "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62"
   },
   {
     "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA",
     "ArchiveDescription": "my archive2",
     "CreationDate": "2012-05-15T17:21:39.339Z",
     "Size": 2140123,
     "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3"
   }
  ]
}

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 

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Range: bytes=0-1023	
x-amz-glacier-version: 2012-06-01
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.

HTTP/1.1 206 Partial Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Range: bytes 0-1023/8388608
Content-Type: application/octet-stream
Content-Length: 1024

[Archive data.]