Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemulihan objek POST

Deskripsi

Operasi ini melakukan jenis permintaan berikut:

Untuk menggunakan operasi ini, Anda harus memiliki izin untuk melakukan s3:GetObject tindakan s3:RestoreObject dan. Pemilik bucket memiliki izin ini secara default dan dapat memberikan izin ini kepada orang lain. Untuk informasi selengkapnya tentang izin, lihat Izin Terkait Operasi Sub-Sumber Daya Bucket dan M engelola Izin Akses ke Sumber Daya Amazon S3 Anda di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Mengkueri Arsip dengan Permintaan Pilihan

Anda menggunakan jenis permintaan tertentu untuk melakukan kueri SQL pada objek yang diarsipkan. Objek yang diarsipkan yang sedang ditanyakan oleh permintaan pilih harus diformat sebagai file nilai yang dipisahkan koma (CSV) yang tidak terkompresi. Anda dapat menjalankan kueri dan analitik kustom pada data yang diarsipkan tanpa harus mengembalikan data ke tingkat Amazon S3 yang lebih panas. Untuk ikhtisar tentang permintaan tertentu, lihat Mengkueri Objek yang Diarsipkan di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Saat membuat permintaan pilih, lakukan hal berikut:

Untuk informasi selengkapnya tentang menggunakan SQL dengan pemulihan Amazon Glacier Select, lihat Referensi SQL untuk Amazon S3 Select dan Amazon Glacier Select di Panduan Pengguna Amazon Simple Storage Service.

Saat membuat permintaan pilih, Anda juga dapat melakukan hal berikut:

Berikut ini adalah fakta penting tambahan tentang fitur pilih:

Memulihkan Arsip

Objek di kelas penyimpanan GLACIER dan DEEP_ARCHIVE diarsipkan. Untuk mengakses objek yang diarsipkan, Anda harus terlebih dahulu memulai permintaan pemulihan. Ini mengembalikan salinan sementara dari objek yang diarsipkan. Dalam permintaan pemulihan, Anda menentukan jumlah hari di mana Anda ingin salinan yang dipulihkan ada. Setelah periode yang ditentukan, Amazon S3 menghapus salinan sementara tetapi objek tetap diarsipkan di kelas penyimpanan GLACIER atau DEEP_ARCHIVE tempat objek dipulihkan.

Untuk mengembalikan versi objek tertentu, Anda dapat memberikan ID versi. Jika Anda tidak memberikan ID versi, Amazon S3 mengembalikan versi saat ini.

Waktu yang dibutuhkan pekerjaan pemulihan untuk menyelesaikan tergantung pada kelas penyimpanan objek yang dipulihkan dan tingkat akses data yang Anda tentukan.

Saat memulihkan objek yang diarsipkan (atau menggunakan permintaan pilih), Anda dapat menentukan salah satu opsi tingkat akses data berikut di Tier elemen badan permintaan:

Untuk informasi selengkapnya tentang opsi pengambilan arsip dan kapasitas yang disediakan untuk akses Expedited data, lihat Memulihkan Objek yang Diarsipkan di Panduan Pengguna Amazon Simple Storage Service.

Anda dapat menggunakan peningkatan kecepatan pemulihan Amazon S3 untuk mengubah kecepatan pemulihan ke kecepatan yang lebih cepat saat sedang berlangsung. Anda meningkatkan kecepatan pemulihan yang sedang berlangsung dengan mengeluarkan permintaan pemulihan lain ke objek yang sama, menyetel elemen Tier permintaan baru. Ketika mengeluarkan permintaan untuk meningkatkan tingkat pemulihan, Anda harus memilih tingkat yang lebih cepat daripada tingkat yang sedang digunakan untuk pemulihan. Anda tidak boleh mengubah parameter lain, seperti elemen permintaan Days. Untuk informasi selengkapnya, lihat Meng upgrade Kecepatan Pem In-Progress ulihan di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Untuk mendapatkan status pemulihan objek, Anda dapat mengirim HEAD permintaan. Operasi mengembalikan x-amz-restore header, yang memberikan informasi tentang status pemulihan, dalam respons. Anda dapat menggunakan notifikasi peristiwa Amazon S3 untuk memberi tahu Anda saat pemulihan dimulai atau selesai. Untuk informasi selengkapnya, lihat Meng onfigurasi Pemberitahuan Peristiwa Amazon S3 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Setelah memulihkan objek yang diarsipkan, Anda dapat memperbarui periode pemulihan dengan menerbitkan kembali permintaan dengan periode baru. Amazon S3 memperbarui periode pemulihan relatif terhadap waktu saat ini dan hanya mengenakan biaya untuk permintaan—tidak ada biaya transfer data. Anda tidak dapat memperbarui periode pemulihan saat Amazon S3 secara aktif memproses permintaan pemulihan Anda saat ini untuk objek tersebut.

Jika bucket Anda memiliki konfigurasi siklus hidup dengan aturan yang menyertakan tindakan kedaluwarsa, kedaluwarsa objek menggantikan rentang hidup yang Anda tentukan dalam permintaan pemulihan. Misalnya, jika Anda memulihkan salinan objek selama 10 hari, tetapi objek dijadwalkan kedaluwarsa dalam 3 hari, Amazon S3 menghapus objek dalam 3 hari. Untuk informasi selengkapnya tentang konfigurasi siklus hidup, lihat PutBucketLifecycleConfiguration dan Manajemen Siklus Hidup Ob jek di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Permintaan

Sintaksis

POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see Permintaan Otentikasi (AWS Versi Tanda Tangan 4))
Content-MD5: MD5

 request body 
 

Parameter Permintaan

Implementasi operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Elemen permintaan

Berikut ini adalah contoh XML dari badan permintaan untuk memulihkan arsip.

<RestoreRequest>
   <Days>2</Days> 
   <GlacierJobParameters>
     <Tier>Bulk</Tier>
   </GlacierJobParameters> 
</RestoreRequest> 

Tabel berikut menjelaskan XML untuk pemulihan arsip di badan permintaan.

XML berikut adalah badan permintaan untuk kueri pilih pada objek yang diarsipkan:

<RestoreRequest>
    <Type>SELECT</Type>
    <Tier>Expedited</Tier>
    <Description>Job description</Description>
    <SelectParameters>
          <Expression>Select * from Object</Expression>
          <ExpressionType>SQL</ExpressionType>
          <InputSerialization>
              <CSV>
                  <FileHeaderInfo>IGNORE</FileHeaderInfo>
                  <RecordDelimiter>\n</RecordDelimiter>
                  <FieldDelimiter>,</FieldDelimiter>
                  <QuoteCharacter>"</QuoteCharacter>
                  <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
                  <Comments>#</Comments>
              </CSV>
           </InputSerialization>
         <OutputSerialization>
             <CSV>
                 <QuoteFields>ASNEEDED</QuoteFields>
                 <RecordDelimiter>\n</RecordDelimiter>
                 <FieldDelimiter>,</FieldDelimiter>
                 <QuoteCharacter>"</QuoteCharacter>
                 <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
             </CSV>                                
         </OutputSerialization>
    </SelectParameters>
    <OutputLocation>
        <S3>
	     <BucketName>Name of bucket</BucketName>
            <Prefix>Key prefix</Prefix>
	      <CannedACL>Canned ACL string</CannedACL>
	      <AccessControlList>
		    <Grantee>
		        <Type>Grantee Type</Type>
			 <ID>Grantee identifier</ID>
			 <URI>Grantee URI</URI>
		       <Permission>Granted permission</Permission>
                    <DisplayNmae>Display Name</DisplayName>
                    <EmailAddress>email</EmailAddress>
		    </Grantee>
	      </AccessControlList>
	      <Encryption>
	            <EncryptionType>Encryption type</EncryptionType>
		     <KMSKeyId>KMS Key ID</KMSKeyId>
		     <KMSContext>Base64-encoded JSON<KMSContext>
            </Encryption>
	     <UserMetadata>
               <MetadataEntry>
                   <Name>Key</Name>
                   <Value>Value</Value>
               </MetadataEntry>
            </UserMetadata>
            <Tagging>
                <TagSet>
                    <Tag>
                        <Key>Tag name</Key>
                        <Value>Tag value</Value>
                    </Tag>
               </TagSet>
            </Tagging>
            <StorageClass>Storage class</StorageClass>
	 </S3>
    </OutputLocation>
</RestoreRequest>

Tabel berikut menjelaskan XML untuk SELECT jenis restorasi dalam badan permintaan.

Respons

Operasi yang berhasil mengembalikan kode 202 Accepted status 200 OK atau.

Header Respons

Implementasi operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi selengkapnya, lihat Header Respons Umum.

Elemen Respons

Operasi ini tidak mengembalikan elemen respons.

Kesalahan Khusus

Contoh

Kembalikan Objek selama Dua Hari Menggunakan Opsi Pengambilan Dipercepat

Permintaan pemulihan berikut mengembalikan salinan photo1.jpg objek dari Amazon Glacier selama dua hari menggunakan opsi pengambilan yang dipercepat.

POST /photo1.jpg?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Mon, 22 Oct 2012 01:49:52 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest>
  <Days>2</Days>
  <GlacierJobParameters>
    <Tier>Expedited</Tier>
  </GlacierJobParameters>
</RestoreRequest>

Jika examplebucket tidak memiliki salinan objek yang dipulihkan, Amazon S3 mengembalikan 202 Accepted respons berikut.

HTTP/1.1 202 Accepted
x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
x-amz-request-id: 9F341CD3C4BA79E0
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3

Jika salinan objek sudah dipulihkan, Amazon S3 mengembalikan 200 OK respons, dan hanya memperbarui waktu kedaluwarsa salinan yang dipulihkan.

Kueri Arsip dengan Permintaan SELECT

Berikut ini adalah contoh pilih permintaan pemulihan.

POST /object-one.csv?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Date: Sat, 20 Oct 2012 23:54:05 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Type>SELECT</Type>
  <Tier>Expedited</Tier>
  <Description>this is a description</Description>
  <SelectParameters>
    <InputSerialization>
      <CSV>
        <FileHeaderInfo>IGNORE</FileHeaderInfo>
        <Comments>#</Comments>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>,</FieldDelimiter>
        <QuoteCharacter>"</QuoteCharacter>
      </CSV>
    </InputSerialization>
    <ExpressionType>SQL</ExpressionType>
    <Expression>select * from object</Expression>
    <OutputSerialization>
      <CSV>
        <QuoteFields>ALWAYS</QuoteFields>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>\t</FieldDelimiter>
        <QuoteCharacter>\'</QuoteCharacter>
      </CSV>
    </OutputSerialization>
  </SelectParameters>
  <OutputLocation>
    <S3>
      <BucketName>example-output-bucket</BucketName>
      <Prefix>test-s3</Prefix>
      <AccessControlList>
        <Grant>
          <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AmazonCustomerByEmail">
            <EmailAddress>jane-doe@example.com</EmailAddress>
          </Grantee>
          <Permission>FULL_CONTROL</Permission>
        </Grant>
      </AccessControlList>
      <UserMetadata>
        <MetadataEntry>
          <Name>test</Name>
          <Value>test-value</Value>
        </MetadataEntry>
        <MetadataEntry>
          <Name>other</Name>
          <Value>something else</Value>
        </MetadataEntry>
      </UserMetadata>
      <StorageClass>STANDARD</StorageClass>
    </S3>
  </OutputLocation>
</RestoreRequest>

Amazon S3 mengembalikan 202 Accepted respons berikut.

HTTP/1.1 202 Accepted
x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
x-amz-request-id: 9F341CD3C4BA79E0
x-amz-restore-output-path: js-test-s3/qE8nk5M0XIj-LuZE2HXNw6empQm3znLkHlMWInRYPS-Orl2W0uj6LyYm-neTvm1-btz3wbBxfMhPykd3jkl-lvZE7w42/
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3

Info Selengkapnya