Memulai Tugas (POST jobs) - Amazon Glacier
Memulai Tugas Pengambilan Arsip atau Inventaris Vault PermintaanResponsContohBagian 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.

Memulai Tugas (POST jobs)

Operasi ini memulai jenis pekerjaan Amazon Glacier (Amazon Glacier) berikut:

  • archive-retrieval— Mengambil arsip.

  • inventory-retrieval— Menyediakan vault.

Memulai Tugas Pengambilan Arsip atau Inventaris Vault

Mengambil arsip atau inventaris vault adalah operasi asinkron yang mengharuskan Anda memulai tugas. Setelah dimulai, tugas tidak dapat dibatalkan. Pengambilan adalah proses dua langkah:

  1. Mulai tugas pengambilan menggunakan operasi Memulai Tugas (POST jobs).

    penting

    Kebijakan pengambilan data dapat menyebabkan permintaan mulai tugas pengambilan Anda gagal dengan PolicyEnforcedException. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat Kebijakan Pengambilan Data Amazon Glacier. Untuk informasi selengkapnya tentang pengecualian PolicyEnforcedException, lihat Respons Kesalahan.

  2. Setelah tugas selesai, unduh byte menggunakan operasi Mendapatkan Output Tugas (GET output).

Permintaan pengambilan dijalankan secara asinkron. Saat Anda memulai pekerjaan pengambilan, Amazon Glacier membuat pekerjaan dan mengembalikan ID pekerjaan dalam respons. Saat Amazon Glacier menyelesaikan pekerjaan, Anda bisa mendapatkan output pekerjaan (data arsip atau inventaris). Untuk informasi tentang mendapatkan output tugas, lihat operasi Mendapatkan Output Tugas (GET output).

Tugas harus selesai sebelum Anda bisa mendapatkan outputnya. Untuk menentukan kapan tugas selesai, Anda memiliki opsi berikut:

  • Gunakan pemberitahuan Amazon SNS— Anda dapat menentukan topik Amazon SNS yang Amazon Glacier dapat memposting pemberitahuan setelah pekerjaan selesai. Anda dapat menentukan topik SNS per permintaan tugas. Pemberitahuan dikirim hanya setelah Amazon Glacier menyelesaikan pekerjaan. Selain menentukan topik SNS per permintaan tugas, Anda dapat mengonfigurasi notifikasi vault untuk vault sehingga notifikasi tugas dikirim untuk semua pengambilan. Untuk informasi selengkapnya, lihat Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration).

  • Dapatkan detail tugas— Anda dapat membuat permintaan Mendeskripsikan Tugas (GET JobID) untuk mendapatkan informasi status tugas saat tugas sedang berlangsung. Namun, penggunaan notifikasi Amazon SNS untuk menentukan kapan tugas selesai lebih efisien.

catatan

Informasi yang Anda dapatkan melalui notifikasi sama dengan yang Anda dapatkan dengan memanggil Mendeskripsikan Tugas (GET JobID).

Jika untuk acara tertentu, Anda menambahkan konfigurasi notifikasi di vault dan juga menentukan topik SNS dalam permintaan pekerjaan inisiat, Amazon Glacier mengirimkan kedua notifikasi. Untuk informasi selengkapnya, lihat Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration).

Inventaris Vault

Amazon Glacier memperbarui inventaris brankas kira-kira sekali sehari, dimulai pada hari Anda pertama kali mengunggah arsip ke lemari besi. Jika tidak ada penambahan arsip atau penghapusan vault sejak inventaris terakhir, tanggal inventaris tidak diperbarui. Saat Anda memulai pekerjaan untuk inventaris vault, Amazon Glacier mengembalikan inventaris terakhir yang dihasilkannya, yang merupakan point-in-time snapshot dan bukan data real-time.

Setelah Amazon Glacier membuat inventaris pertama untuk lemari besi, biasanya dibutuhkan setengah hari dan hingga sehari sebelum inventaris itu tersedia untuk diambil.

Anda mungkin merasa mengambil inventaris vault untuk setiap unggahan arsip tidak berguna. Namun, misalkan Anda memelihara database di sisi klien terkait metadata tentang arsip yang Anda unggah ke Amazon Glacier. Selanjutnya, Anda mungkin merasa inventaris vault berguna untuk mencocokkan informasi, jika perlu, dalam basis data Anda dengan inventaris vault aktual. Untuk informasi selengkapnya tentang bidang data yang dikembalikan dalam output tugas, lihat Isi Respons.

Pengambilan Inventaris Rentang

Anda dapat membatasi jumlah item inventaris yang diambil dengan memfilter tanggal pembuatan arsip atau dengan menetapkan batas.

Memfilter berdasarkan Tanggal Pembuatan Arsip

Anda dapat mengambil item inventaris untuk arsip yang dibuat antara StartDate dan EndDate dengan menentukan nilai untuk parameter ini dalam permintaan Mulai Tugas. Arsip yang dibuat di atau setelah StartDate dan sebelum EndDate dikembalikan. Jika Anda hanya memberikan StartDate tanpa EndDate, Anda mengambil inventaris untuk semua arsip yang dibuat pada atau setelah StartDate. Jika Anda hanya memberikan EndDate tanpa StartDate, Anda mengambil inventaris untuk semua arsip yang dibuat sebelum EndDate.

Membatasi Item Inventaris per Pengambilan

Anda dapat membatasi jumlah item inventaris yang dikembalikan dengan mengatur parameter Limit dalam permintaan Mulai Tugas. Output tugas inventaris berisi item inventaris sampai dengan Limit yang ditentukan. Jika ada lebih banyak item inventarus yang tersedia, hasilnya adalah pemberian nomor halaman. Setelah tugas selesai, Anda dapat menggunakan operasi Mendeskripsikan Tugas (GET JobID) untuk mendapatkan penanda yang Anda gunakan dalam permintaan Mulai Tugas berikut. Penanda menunjukkan titik awal untuk mengambil sekumpulan item inventaris berikutnya. Anda dapat menelusuri seluruh inventaris dengan berulang kali membuat permintaan Mulai Tugas dengan penanda dari output Jelaskan Tugas sebelumnya. Anda melakukannya sampai Anda mendapatkan penanda dari Jelaskan Tugas yang mengembalikan nol, menunjukkan tidak ada item lainnya yang tersedia.

Anda dapat menggunakan parameter Limit bersama-sama dengan parameter rentang tanggal.

Pengambilan Arsip Berkisar

Anda dapat memulai pengambilan arsip untuk seluruh arsip atau rentang arsip. Dalam hal pengambilan arsip berkisar, Anda menentukan rentang byte untuk dikembalikan atau seluruh arsip. Rentang yang ditentukan harus megabyte (MB) selaras. Dengan kata lain, rentang awal nilai harus habis dibagi 1 MB dan rentang nilai akhir ditambah 1 harus habis dibagi 1 MB atau sama dengan akhir arsip. Jika pengambilan arsip berkisar bukan megabyte selaras, operasi ini mengembalikan respons 400. Selain itu, untuk memastikan Anda mendapatkan nilai checksum untuk data yang Anda unduh menggunakan Dapatkan Output Tugas (Mendapatkan Output Tugas (GET output)), rentang harus berupa tree-hash selaras. Untuk informasi selengkapnya tentang rentang tree-hash selaras, lihat Menerima Checksum Saat Mengunduh Data.

Tingkat Dipercepat, Standar, dan Massal.

Saat memulai pekerjaan pengambilan arsip, Anda dapat menentukan salah satu opsi berikut di Tier bidang badan permintaan:

  • Expedited— Dipercepat memungkinkan Anda mengakses data dengan cepat ketika permintaan mendesak sesekali untuk memulihkan arsip diperlukan. Untuk semua, kecuali arsip terbesar (250 MB+), data yang diakses menggunakan tingkat Dipercepat biasanya disediakan dalam waktu 1–5 menit.

  • Standard – Standar memungkinkan Anda mengakses salah satu arsip Anda dalam beberapa jam. Data yang diakses menggunakan tingkat Standar biasanya tersedia dalam 3–5 jam. Ini adalah opsi default untuk permintaan tugas yang tidak menentukan opsi tingkat.

  • BulkMassal adalah tingkat biaya terendah untuk Amazon Glacier, memungkinkan Anda untuk mengambil sejumlah besar, bahkan petabyte, data murah dalam sehari. Data yang diakses menggunakan tingkat Massal biasanya tersedia dalam 5–12 jam.

Untuk informasi selengkapnya tentang pengambilan yang dipercepat dan massal, lihat Mengambil Arsip Amazon Glacier.

Permintaan

Untuk memulai tugas, Anda menggunakan metode POST HTTP dan mencakup permintaan untuk subsumber daya jobs vault. Anda menentukan detail permintaan tugas dalam dokumen JSON dari permintaan Anda. Tipe tugas ditentukan dengan bidang Type. Secara opsional, Anda dapat menentukan SNSTopic bidang untuk menunjukkan topik Amazon SNS tempat Amazon Glacier dapat memposting pemberitahuan setelah menyelesaikan pekerjaan.

catatan

Untuk mengirim notifikasi ke Amazon SNS, Anda harus membuat topik sendiri jika belum ada. Amazon Glacier tidak membuat topik untuk Anda. Topik harus memiliki izin untuk menerima publikasi dari lemari besi Amazon Glacier. Amazon Glacier tidak memverifikasi apakah brankas memiliki izin untuk mempublikasikan ke topik. Jika izin tidak dikonfigurasi dengan tepat, Anda mungkin tidak menerima notifikasi bahkan setelah tugas selesai.

Sintaksis

Berikut ini adalah sintaks permintaan untuk memulai tugas.

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

{
   "jobParameters": { 
      "ArchiveId": "string",
      "Description": "string",
      "Format": "string",
      "InventoryRetrievalParameters": { 
         "EndDate": "string",
         "Limit": "string",
         "Marker": "string",
         "StartDate": "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"
            }
         }
      },
      "SNSTopic": "string",
      "Tier": "string",
      "Type": "string"
   }
}
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.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON dalam isi permintaan.

jobParameters

Menyediakan opsi untuk menentukan informasi tugas.

Tipe: Objek jobParameters

Wajib: Ya

Respons

Amazon Glacier menciptakan pekerjaan. Sebagai respons, S3 Glacier mengembalikan URI tugas.

Sintaksis

HTTP/1.1 202 Accepted
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: location
x-amz-job-id: jobId
x-amz-job-output-path: jobOutputPath

Header Respons

Header Deskripsi
Location

Jalur URI relatif dari tugas. Anda dapat menggunakan jalur URI ini untuk menemukan status tugas. Untuk informasi selengkapnya, lihat Mendeskripsikan Tugas (GET JobID).

Tipe: String

Default: Tidak ada
x-amz-job-id

ID tugas. Nilai ini juga disertakan sebagai bagian dari header Location.

Tipe: String

Default: Tidak Ada
x-amz-job-output-path

Jalur ke lokasi tempat hasil pilih disimpan.

Tipe: String

Default: Tidak ada

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

Operasi ini mencakup kesalahan atau kesalahan berikut, di samping kemungkinan kesalahan yang umum terjadi pada semua operasi Amazon Glacier. Untuk informasi tentang kesalahan Amazon Glacier dan daftar kode kesalahan, lihat. Respons Kesalahan

Kode Deskripsi Kode Status HTTP Tipe
InsufficientCapacityException Dikembalikan jika kapasitas tidak memadai untuk memproses permintaan yang dipercepat ini. Kesalahan ini hanya berlaku untuk pengambilan yang dipercepat dan bukan untuk pengambilan standar atau massal. 503 Service Unavailable Server

Contoh

Contoh Permintaan: Memulai tugas pengambilan arsip

POST /-/vaults/examplevault/jobs 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

{
  "Type": "archive-retrieval",
  "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId",
  "Description": "My archive description",
  "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example",
  "Tier" : "Bulk"
}

Berikut adalah contoh isi permintaan yang menentukan rentang arsip yang diambil menggunakan bidang RetrievalByteRange.

{
  "Type": "archive-retrieval",
  "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId",
  "Description": "My archive description",
  "RetrievalByteRange": "2097152-4194303",
  "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example",
  "Tier" : "Bulk"
}

Contoh Respons

HTTP/1.1 202 Accepted
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID

Contoh Permintaan: Memulai tugas pengambilan inventaris

Permintaan berikut memulai tugas pengambilan inventaris untuk mendapatkan daftar arsip dari vault examplevault. Format yang ditetapkan ke CSV dalam isi permintaan menunjukkan inventaris dikembalikan dalam format CSV.

POST /-/vaults/examplevault/jobs HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Content-Type: application/x-www-form-urlencoded
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

{
  "Type": "inventory-retrieval",
  "Description": "My inventory job",
  "Format": "CSV",  
  "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example"
}

Contoh Respons

HTTP/1.1 202 Accepted
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT 
Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID

Contoh Permintaan: Memulai tugas pengambilan inventaris menggunakan penyaringan tanggal dengan batas yang ditetapkan, dan permintaan berikutnya untuk mengambil halaman item inventaris berikutnya.

Permintaan berikut memulai tugas pengambilan inventaris vault menggunakan penyaringan tanggal dan menetapkan batas. 


{
    "ArchiveId": null, 
    "Description": null, 
    "Format": "CSV", 
    "RetrievalByteRange": null, 
    "SNSTopic": null, 
    "Type": "inventory-retrieval", 
    "InventoryRetrievalParameters": {
        "StartDate": "2013-12-04T21:25:42Z",
        "EndDate": "2013-12-05T21:25:42Z", 
        "Limit" : "10000"
    }, 
}

Permintaan berikut adalah contoh dari permintaan berikutnya untuk mengambil halaman item inventaris berikutnya menggunakan penanda yang diperoleh dari Mendeskripsikan Tugas (GET JobID). 

{
    "ArchiveId": null, 
    "Description": null, 
    "Format": "CSV", 
    "RetrievalByteRange": null, 
    "SNSTopic": null, 
    "Type": "inventory-retrieval", 
    "InventoryRetrievalParameters": {
        "StartDate": "2013-12-04T21:25:42Z",
        "EndDate": "2013-12-05T21:25:42Z", 
        "Limit": "10000",
        "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0"
    }, 
}

Contoh Respons

HTTP/1.1 202 Accepted
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT 
Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/

Bagian Terkait