**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.
# jobParameters
Menyediakan opsi untuk mendefinisikan tugas.
## Daftar Isi
**ArchiveId**
ID arsip yang Anda inginkan. Kolom ini wajib diisi jika bidang `Type` diatur ke `select` atau `archive-retrieval`. Terjadi kesalahan jika Anda menentukan bidang ini untuk permintaan tugas pengambilan inventaris.
*Nilai yang Valid*: Harus berupa ID arsip valid yang Anda peroleh dari permintaan sebelumnya ke Amazon Glacier (Amazon Glacier).
*Tipe*: String
*Wajib*: Ya ketika `Type` diatur ke `select` atau `archive-retrieval`.
**Deskripsi**
Deskripsi opsional untuk tugas.
*Nilai yang 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.
*Tipe*: 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`
*Tipe*: String
*Diperlukan*: tidak
**InventoryRetrievalParameters**
Parameter input yang digunakan untuk pengambilan berbagai inventaris.
*Tipe*: Objek [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md)
*Diperlukan*: tidak
**OutputLocation**
Objek yang berisi informasi tentang lokasi tempat hasil tugas pilih disimpan.
*Tipe*: Objek [OutputLocation](api-OutputLocation.md)
*Wajib*: Ya, untuk tugas `select`.
**RetrievalByteRange**
Rentang byte untuk mengambil untuk`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-aligned berarti yang *StartByteValue*harus habis dibagi 1 MB, dan *EndByteValue*ditambah 1 harus habis dibagi 1 MB atau menjadi akhir dari arsip yang ditentukan sebagai nilai ukuran byte arsip dikurangi 1. Jika **RetrievalByteRange**tidak selaras dengan megabyte, operasi ini mengembalikan respons. `400`
Terjadi kesalahan jika Anda menentukan bidang ini untuk permintaan tugas `inventory-retrieval` atau `select`.
*Tipe*: String
*Diperlukan*: tidak
**SelectParameters**
Objek yang berisi informasi tentang parameter yang digunakan untuk select.
*Tipe*: Objek [SelectParameters](api-SelectParameters.md)
*Diperlukan*: tidak
**SNSTopic**
Nama Sumber Daya Amazon (ARN) dari topik Amazon SNS tempat Amazon Glacier mengirimkan pemberitahuan saat pekerjaan selesai dan output siap untuk Anda unduh. Topik yang ditentukan menerbitkan notifikasi kepada pelanggannya.
Topik SNS harus ada. Jika tidak, Amazon 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](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)di *Referensi API* *Layanan Pemberitahuan Sederhana Amazon*.
*Tipe*: 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`
*Tipe*: 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`
*Tipe*: String
*Wajib*: ya
## Info Selengkapnya
+ [Memulai Tugas (POST jobs)](api-initiate-job-post.md)