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. S3 Glacier mengembalikan daftar bagian diurutkan berdasarkan rentang yang Anda tentukan di setiap unggahan bagian. Jika Anda mengirim permintaan Cantumkan Bagian setelah menyelesaikan unggahan multipart, Amazon S3 Glacier (S3 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 bukan nol, untuk mengambil serangkaian bagian berikutnya, Anda mengirim permintaan Cantumkan Bagian lainnya dengan parameter permintaan marker yang diatur ke nilai penanda S3 Glacier yang dikembalikan sebagai respons atas permintaan Cantumkan Bagian 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

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	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 pohon SHA256 yang S3 Glacier hitung 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 dan pesan kesalahan Amazon S3 Glacier, 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 respons, S3 Glacier mengembalikan daftar bagian yang diunggah yang terkait dengan ID unggahan multipart 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 respons, S3 Glacier mengembalikan daftar bagian yang diunggah yang terkait dengan ID unggahan multipart yang sedang berlangsung.

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"
}	

Bagian Terkait

• Memulai Unggahan Multipart (POST multipart-uploads)

• Mengunggah Bagian (PUT UploadID)

• Menyelesaikan Unggahan Multipart (POST uploadID)

• Membatalkan Unggahan Multipart (DELETE uploadID)

• Mencantumkan Unggahan Multipart (GET multipart-uploads)

• Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)

• Identity and Access Management untuk Amazon S3 Glacier