jobParameters

Menyediakan opsi untuk mendefinisikan tugas.

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 valid: Harus ID arsip valid yang Anda peroleh dari permintaan sebelumnya ke Amazon S3 Glacier (S3 Glacier).

Jenis: Tali

Wajib: Ya ketikaTypediatur keselectatauarchive-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, untukselectpekerjaan.

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 respons 400.

Terjadi kesalahan jika Anda menentukan bidang ini untuk permintaan tugas inventory-retrieval atau select.

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

Info Selengkapnya

• Memulai Tugas (POST jobs)