Halaman ini hanya untuk pelanggan lama dari layanan S3 Glacier menggunakan Vaults dan asli dari 2012. REST API
Jika Anda mencari solusi penyimpanan arsip, kami sarankan untuk menggunakan kelas penyimpanan S3 Glacier di Amazon S3, Pengambilan Instan Gletser S3, Pengambilan Fleksibel Gletser S3, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat Kelas penyimpanan S3 Glacier dan Penyimpanan data jangka panjang menggunakan kelas
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
jobParameters
Menyediakan opsi untuk mendefinisikan tugas.
Isi
- ArchiveId
-
ID arsip yang Anda inginkan. Kolom ini wajib diisi jika bidang
Type
diatur keselect
atauarchive-retrieval
. Terjadi kesalahan jika Anda menentukan bidang ini untuk permintaan tugas pengambilan inventaris.Nilai valid: Harus ID arsip valid yang Anda peroleh dari permintaan sebelumnya ke Amazon S3 Glacier (S3 Glacier).
Jenis: Tali
Wajib: Ya ketika
Type
diatur keselect
atauarchive-retrieval
. - Deskripsi
-
Deskripsi opsional untuk tugas.
Nilai valid: Deskripsi harus kurang dari atau sama dengan 1.024 byte. Karakter yang diizinkan adalah ASCII 7 bit tanpa kode kontrol—khususnya, nilai ASCII 32–126 desimal atau 0x20–0x7E heksadesimal.
Jenis: String
Wajib: tidak
- Format
-
(Opsional) Format output, saat memulai tugas untuk mengambil inventaris vault. Jika Anda memulai tugas inventaris dan tidak menentukan bidang
Format
, JSON adalah format default.Nilai yang Valid:
CSV
|JSON
Jenis: String
Wajib: tidak
- InventoryRetrievalParameters
-
Parameter input yang digunakan untuk pengambilan berbagai inventaris.
Tipe: Objek InventoryRetrievalJobInput
Wajib: tidak
- OutputLocation
-
Objek yang berisi informasi tentang lokasi tempat hasil tugas pilih disimpan.
Tipe: Objek OutputLocation
Wajib: Ya, untuk
select
pekerjaan. - RetrievalByteRange
-
Rentang byte untuk mengambil
archive-retrieval
, dalam bentuk "StartByteValue
-EndByteValue
". Jika bidang ini tidak ditentukan, seluruh arsip akan diambil. Jika bidang ini ditentukan, rentang byte harus megabyte (1024*1024) selaras. Megabyte selaras berarti StartByteValue harus habis dibagi 1 MB, dan EndByteValue ditambah 1 harus habis dibagi 1 MB atau menjadi akhir dari arsip yang ditetapkan sebagai nilai ukuran byte arsip dikurangi 1. Jika RetrievalByteRange bukan megabyte selaras, operasi ini mengembalikan respons400
.Terjadi kesalahan jika Anda menentukan bidang ini untuk permintaan tugas
inventory-retrieval
atauselect
.Jenis: String
Wajib: tidak
- SelectParameters
-
Objek yang berisi informasi tentang parameter yang digunakan untuk select.
Tipe: Objek SelectParameters
Wajib: tidak
- SnStopic
-
Amazon Resource Name (ARN) dari topik Amazon SNS tempat S3 Glacier mengirimkan notifikasi ketika tugas selesai dan output siap untuk Anda unduh. Topik yang ditentukan menerbitkan notifikasi kepada pelanggannya.
Topik SNS harus ada. Jika tidak, S3 Glacier tidak membuatnya untuk Anda. Selain itu, topik SNS harus memiliki kebijakan yang memungkinkan akun yang membuat tugas menerbitkan pesan ke topik. Untuk informasi tentang nama topik SNS, lihat CreateTopic di Referensi API.Amazon Simple Notification Service.
Jenis: String
Wajib: tidak
- Tingkat
-
Tingkat yang digunakan untuk tugas pilih atau pengambilan arsip.
Standard
adalah nilai default yang digunakan.Nilai yang Valid:
Expedited
|Standard
|Bulk
Jenis: String
Wajib: tidak
- Jenis
-
Jenis tugas. Anda dapat memulai tugas untuk melakukan kueri pilih di arsip, mengambil arsip, atau mendapatkan inventaris vault.
Nilai yang Valid:
select
|archive-retrieval
|inventory-retrieval
Jenis: String
Wajib: ya