Mencantumkan Unggahan Multipart (GET multipart-uploads) - Amazon S3 Glacier
DeskripsiPermintaanResponsContohBagian Terkait

Halaman ini hanya untuk pelanggan lama dari layanan S3 Glacier menggunakan Vaults dan asli dari 2012. REST API

Jika Anda mencari solusi penyimpanan arsip, kami sarankan untuk menggunakan kelas penyimpanan S3 Glacier di Amazon S3, Pengambilan Instan Gletser S3, Pengambilan Fleksibel Gletser S3, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat Kelas penyimpanan S3 Glacier dan Penyimpanan data jangka panjang menggunakan kelas penyimpanan S3 Glacier di Panduan Pengguna Amazon S3. Kelas penyimpanan ini menggunakan Amazon S3API, tersedia di semua wilayah, dan dapat dikelola dalam konsol Amazon S3. Mereka menawarkan fitur seperti Analisis Biaya Penyimpanan, Lensa Penyimpanan, fitur enkripsi opsional canggih, dan banyak lagi.

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 marker bukan nol, untuk mengambil serangkaian unggahan multipart berikutnya, Anda mengirim permintaan Cantumkan Unggahan Multipart lainnya dengan parameter permintaan marker yang diatur ke nilai penanda yang Amazon S3 Glacier (S3 Glacier) kembalikan sebagai respons atas permintaan Cantumkan Unggahan Multipart sebelumnya.

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

Nilai AccountId adalah ID Akun AWS dari akun yang memiliki vault. Anda dapat menentukan ID Akun AWS atau secara opsional satu '-' (tanda hubung), dalam hal ini, Amazon S3 Glacier menggunakan ID Akun AWS yang terkait dengan kredensial 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 dan pesan kesalahan Amazon S3 Glacier, 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 respons, S3 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 respons, Amazon S3 Glacier (S3 Glacier) mengembalikan daftar dari tidak lebih dari dua unggahan multipart yang sedang berlangsung untuk vault tertentu, mulai dari penanda yang ditentukan dan mengembalikan 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"
    }
  ]
}