Mencantumkan Bagian (GET uploadID) - 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.

Mencantumkan Bagian (GET uploadID)

Deskripsi

Operasi unggahan multipart ini mencantumkan bagian arsip yang telah diunggah dalam unggahan multipart tertentu yang diidentifikasi oleh ID unggah. Untuk informasi tentang unggahan multipart, lihat Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart).

Anda dapat membuat permintaan ini kapan saja selama unggahan multipart yang sedang berlangsung sebelum menyelesaikan unggahan multipart. Amazon Glacier mengembalikan daftar bagian yang diurutkan berdasarkan rentang yang Anda tentukan di setiap unggahan bagian. Jika Anda mengirim permintaan Suku Cadang Daftar setelah menyelesaikan unggahan multibagian, Amazon Glacier (Amazon Glacier) mengembalikan kesalahan.

Operasi Cantumkan Bagian mendukung pemberian nomor halaman. Anda harus selalu memeriksa bidang Marker dalam isi respons untuk penanda tempat untuk melanjutkan daftar; jika tidak ada lagi item, bidang marker adalah null. Jika marker tidak null, untuk mengambil kumpulan bagian berikutnya, Anda mengirim permintaan Bagian Daftar lain dengan parameter marker permintaan yang disetel ke nilai penanda Amazon Glacier yang dikembalikan sebagai tanggapan atas permintaan Bagian Daftar Anda sebelumnya.

Anda juga dapat membatasi jumlah bagian yang dikembalikan dalam respons dengan menentukan parameter limit dalam permintaan.

Permintaan

Sintaksis

Untuk mencantumkan bagian dari unggahan multipart yang sedang berlangsung, Anda mengirim permintaan GET ke URI dari sumber daya ID unggahan multipart. ID unggahan multipart dikembalikan ketika Anda memulai unggahan multipart (Memulai Unggahan Multipart (POST multipart-uploads)). Anda dapat secara opsional menentukan parameter marker dan limit.

GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
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

Nama Deskripsi Wajib
limit

Jumlah maksimum bagian yang dikembalikan. Batas default adalah 50. Jumlah bagian yang dikembalikan mungkin kurang dari batas yang ditentukan, tetapi jumlah bagian yang dikembalikan tidak pernah melebihi batas.

Tipe: String

Batasan: Nilai bilangan bulat minimum 1. Nilai bilangan bulat maksimum 50.

 Tidak
marker

String buram yang digunakan untuk pemberian nomor halaman. marker menentukan bagian tempat cantuman bagian harus dimulai. Dapatkan nilai marker dari respons dari respons Cantumkan Bagian sebelumnya. Anda hanya perlu menyertakan marker jika Anda melanjutkan pemberian nomor halaman dari hasil yang dimulai dalam permintaan Cantumkan Bagian sebelumnya.

Tipe: String

Batasan: Tidak Ada

 Tidak

Header Permintaan

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Header Respons Umum.

Isi Permintaan

Operasi ini tidak memiliki isi permintaan.

Respons

Sintaksis

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "VaultARN" : String
}

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Header Respons Umum.

Isi Respons

Isi respons berisi bidang JSON berikut.

ArchiveDescription

Deskripsi arsip yang ditentukan dalam permintaan Mulai Unggahan Multipart. Bidang ini adalah null jika tidak ada deskripsi arsip yang ditentukan dalam operasi Mulai Unggahan Multipart.

Tipe: String

CreationDate

Waktu UTC unggahan multipart dimulai.

Tipe: String. Representasi string dalam format tanggal ISO 8601, misalnya 2013-03-20T17:03:43.221Z.

Penanda

String buram yang mewakili tempat untuk melanjutkan pemberian nomor halaman hasil. Anda menggunakan marker dalam permintaan Cantumkan Bagian baru untuk mendapatkan lebih banyak tugas dalam daftar. Jika tidak ada lagi bagian, nilai ini adalah null.

Tipe: String

MultipartUploadId

ID upload yang bagian-bagiannya terkait.

Tipe: String

PartSizeInBytes

Ukuran bagian dalam byte. Ini adalah nilai yang sama dengan yang Anda tentukan dalam permintaan Mulai Unggahan Multipart.

Tipe: Angka

Bagian

Daftar ukuran bagian dari unggahan multipart. Setiap objek dalam array berisi pasangan nama/nilai RangeBytes dan sha256-tree-hash.

Tipe: Array

RangeInBytes

Rentang byte bagian, termasuk nilai atas rentang.

Tipe: String

SHA256TreeHash

Nilai hash SHA256 pohon yang dihitung Amazon Glacier untuk bagian tersebut. Bidang ini tidak pernah ada null.

Tipe: String

Vaultarn

Amazon Resource Name (ARN) dari vault tempat unggahan multipart dimulai.

Tipe: String

Kesalahan

Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. Respons Kesalahan

Contoh

Contoh: Mencantumkan Bagian dari Unggahan Multipart

Contoh berikut mencantumkan semua bagian dari unggah. Contoh mengirimkan permintaan GET HTTP ke URI ID unggahan multipart spesifik dari unggahan multipart yang sedang berlangsung dan mengembalikan hingga 1.000 bagian.

Contoh Permintaan

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 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

Sebagai tanggapan, Amazon Glacier mengembalikan daftar bagian yang diunggah yang terkait dengan ID unggahan multibagian yang ditentukan. Dalam contoh ini, hanya ada dua bagian. Bidang Marker yang dikembalikan adalah null yang menunjukkan tidak ada lagi bagian dari unggahan multipart.

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: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

Contoh: Mencantumkan Bagian dari Unggahan Multipart (Menentukan Penanda dan Parameter Permintaan Batas)

Contoh berikut menunjukkan cara menggunakan pemberian nomor halaman untuk mendapatkan sejumlah hasil terbatas. Contoh mengirimkan permintaan GET HTTP ke URI ID unggahan multipart spesifik dari unggahan multipart yang sedang berlangsung untuk mengembalikan satu bagian. Parameter marker yang memulai menentukan di bagian mana untuk memulai daftar bagian. Anda bisa mendapatkan nilai marker dari respons permintaan sebelumnya untuk daftar bagian. Selain itu, dalam contoh ini, parameter limit diatur ke 1 dan mengembalikan satu bagian. Perhatikan bahwa bidang Marker bukan null, yang menunjukkan setidaknya ada satu bagian lagi yang harus didapatkan.

Contoh Permintaan

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 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

Sebagai tanggapan, Amazon Glacier menampilkan daftar bagian yang diunggah yang terkait dengan ID unggahan multibagian yang sedang berlangsung yang ditentukan.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}