Mencantumkan Unggahan Multipart (GET multipart-uploads) - 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 Unggahan Multipart (GET multipart-uploads)

Deskripsi

Operasi unggahan multipart ini mencantumkan unggahan multiparti yang sedang berlangsung untuk vault yang ditentukan. Unggahan multipart yang sedang berlangsung adalah unggahan multipart yang telah dimulai menggunakan memulai permintaan Memulai Unggahan Multipart (POST multipart-uploads), tetapi belum diselesaikan atau dihentikan. Daftar yang dikembalikan dalam respons Cantumkan Unggahan Multipart memiliki urutan tidak terjamin.

Operasi Cantumkan Unggahan Multipart mendukung pemberian nomor halaman. Secara default, operasi ini mengembalikan hingga 50 unggahan multipart dalam respons. 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 tidak null, untuk mengambil kumpulan unggahan multipart berikutnya, Anda mengirim permintaan Unggahan Multipart Daftar lainnya dengan parameter marker permintaan yang disetel ke nilai penanda Amazon Glacier (Amazon Glacier) yang dikembalikan sebagai tanggapan atas permintaan Unggahan Multipart Daftar sebelumnya. marker

Perhatikan perbedaan antara operasi ini dan operasi Mencantumkan Bagian (GET uploadID)). Operasi Cantumkan Unggahan Multipart mencantumkan semua unggahan multipart untuk vault. Operasi Cantumkan Bagian mengembalikan bagian unggahan multiparti spesifik yang diidentifikasi oleh ID Unggah.

Untuk informasi tentang unggahan multipart, lihat Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart).

Permintaan

Sintaksis

Untuk mencantumkan unggahan multipart, kirim permintaan GET ke URI dari subsumber daya multipart-uploads vault. Anda dapat secara opsional menentukan parameter marker dan limit.

GET /AccountId/vaults/VaultName/multipart-uploads 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

Menentukan jumlah maksimum unggahan yang dikembalikan dalam isi respons. Jika tidak ditentukan, operasi Cantumkan Daftar akan mengembalikan hingga 50 unggahan.

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 unggahan tempat cantuman unggahan harus dimulai. Dapatkan nilai marker dari respons Cantumkan Unggahan sebelumnya. Anda hanya perlu menyertakan marker jika Anda melanjutkan pemberian nomor halaman dari hasil yang dimulai dalam permintaan Cantumkan Unggahan 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

{
  "Marker": String,
  "UploadsList" : [ 
    {
      "ArchiveDescription": String,
      "CreationDate": String,
      "MultipartUploadId": String,
      "PartSizeInBytes": Number,
      "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 Unggahan Multipart baru untuk mendapatkan lebih banyak unggahan dalam daftar. Jika tidak ada lagi unggahan, nilai ini adalah null.

Tipe: String

PartSizeInBytes

Ukuran bagian yang ditentukan dalam permintaan Memulai Unggahan Multipart (POST multipart-uploads). Ini adalah ukuran semua bagian dalam unggahan kecuali bagian terakhir, yang mungkin lebih kecil dari ukuran ini.

Tipe: Angka

MultipartUploadId

ID unggahan multipart.

Tipe: String

UploadsList

Daftar metadata tentang objek unggahan multipart. Setiap item dalam daftar berisi serangkaian pasangan nama nilai untuk unggahan yang sesuai, termasuk ArchiveDescription, CreationDate, MultipartUploadId, PartSizeInBytes, dan VaultARN.

Tipe: Array

Vaultarn

Amazon Resource Name (ARN) dari vault yang berisi arsip.

Tipe: String

Kesalahan

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

Contoh

Contoh: Mencantumkan Semua Unggahan Multipart

Contoh berikut mencantumkan semua unggahan multipart yang sedang berlangsung untuk vault. Contoh ini menunjukkan permintaan GET HTTP ke URI dari subsumber daya multipart-uploads vault tertentu. Karena parameter marker dan limit tidak ditentukan dalam permintaan, hingga 1.000 unggahan multipart yang sedang berlangsung dikembalikan.

Contoh Permintaan

GET /-/vaults/examplevault/multipart-uploads 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 semua unggahan multipart yang sedang berlangsung untuk vault yang ditentukan. Bidang marker adalah null, yang menunjukkan tidak ada lagi unggahan ke daftar. 

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: 1054
      
{
  "Marker": null, 
  "UploadsList": [ 
    {
      "ArchiveDescription": "archive 1",
      "CreationDate": "2012-03-19T23:20:59.130Z",
      "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }, 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    },
    {
      "ArchiveDescription": "archive 3",
      "CreationDate": "2012-03-20T17:03:43.221Z",
      "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    } 
  ]
}

Contoh: Mencantumkan Bagian dari Unggahan Multipart

Contoh berikut menunjukkan cara menggunakan pemberian nomor halaman untuk mendapatkan sejumlah hasil terbatas. Contoh ini menunjukkan permintaan GET HTTP ke URI dari subsumber daya multipart-uploads untuk vault tertentu. Dalam contoh ini, parameter limit diatur ke 1, yang berarti hanya satu unggahan yang dikembalikan dalam daftar, dan parameter marker menunjukkan ID unggahan multipart tempat daftar yang dikembalikan dimulai.

Contoh Permintaan

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev 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 (Amazon Glacier) mengembalikan daftar tidak lebih dari dua unggahan multipart yang sedang berlangsung untuk vault yang ditentukan, dimulai dari penanda yang ditentukan dan menampilkan dua hasil. 

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: 470

{
  "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
  "UploadsList" : [ 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }
  ]
}