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

# Pemulihan objek POST
<a name="RESTObjectPOSTrestore"></a>

## Deskripsi
<a name="RESTObjectPOSTrestore-description"></a>

Operasi ini melakukan jenis permintaan berikut: 
+ `select`— Lakukan kueri pilih pada objek yang diarsipkan
+ `restore an archive`— Kembalikan objek yang diarsipkan

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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources) dan M [ engelola Izin Akses ke Sumber Daya Amazon S3 Anda ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) di Panduan * Pengguna Layanan Penyimpanan Sederhana * Amazon.

## Mengkueri Arsip dengan Permintaan Pilihan
<a name="RESTObjectPOSTrestore-select-request"></a>

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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/querying-glacier-archives.html) di Panduan * Pengguna Layanan Penyimpanan Sederhana * Amazon.

Saat membuat permintaan pilih, lakukan hal berikut:
+ Tentukan lokasi keluaran untuk output kueri pilih. Ini harus berupa bucket Amazon S3 yang Wilayah AWS sama dengan bucket yang berisi objek arsip yang sedang ditanyakan. Akun AWS Yang memulai pekerjaan harus memiliki izin untuk menulis ke bucket S3. Anda dapat menentukan kelas penyimpanan dan enkripsi untuk objek output yang disimpan dalam bucket. Untuk informasi selengkapnya tentang keluaran, lihat Mengku [ eri Objek yang Diarsipkan ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/querying-glacier-archives.html) di Panduan * Pengguna Layanan Penyimpanan Sederhana * Amazon.

  Untuk informasi selengkapnya tentang `S3` struktur dalam badan permintaan, lihat berikut ini:
  + [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
  + [Mengelola Akses dengan ACL ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon *
  + [Melindungi Data Menggunakan Server-Side Enkripsi ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon *
+ Tentukan ekspresi SQL untuk `SELECT` jenis pemulihan untuk kueri Anda dalam `SelectParameters` struktur badan permintaan. Anda dapat menggunakan ekspresi seperti contoh berikut.
  + Ekspresi berikut mengembalikan semua catatan dari objek yang ditentukan.

    ```
    SELECT * FROM Object
    ```
  + Dengan asumsi bahwa Anda tidak menggunakan header apa pun untuk data yang disimpan dalam objek, Anda dapat menentukan kolom dengan header posisi.

    ```
    SELECT s._1, s._2 FROM Object s WHERE s._3 > 100
    ```
  + Jika Anda memiliki header dan Anda mengatur `CSV` struktur `fileHeaderInfo` di badan permintaan ke`USE`, Anda dapat menentukan header dalam kueri. (Jika Anda mengatur bidang `fileHeaderInfo` ke `IGNORE`, baris pertama dilewati untuk kueri.) Anda tidak dapat mencampur posisi ordinal dengan nama kolom header. 

    ```
    SELECT s.Id, s.FirstName, s.SSN FROM S3Object s
    ```

Untuk informasi selengkapnya tentang menggunakan SQL dengan pemulihan Amazon Glacier Select, lihat Referensi [ SQL untuk Amazon S3 Select dan Amazon Glacier ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference.html) Select di Panduan Pengguna * Amazon Simple Storage Service*. 

Saat membuat permintaan pilih, Anda juga dapat melakukan hal berikut:
+ Untuk mempercepat kueri Anda, tentukan tingkatnya. `Expedited` Untuk informasi selengkapnya tentang tingkatan, lihat “Memulihkan Arsip,” nanti dalam topik ini.
+ Tentukan detail tentang format serialisasi data dari objek input yang sedang ditanyakan dan serialisasi hasil kueri. CSV-encoded 

Berikut ini adalah fakta penting tambahan tentang fitur pilih:
+ Hasil output adalah objek Amazon S3 baru. Tidak seperti pengambilan arsip, mereka disimpan hingga dihapus secara eksplisit — secara manual atau melalui kebijakan siklus hidup.
+ Anda dapat mengeluarkan lebih dari satu permintaan pilih pada objek Amazon S3 yang sama. Amazon S3 tidak mendeduplikasi permintaan, jadi hindari mengeluarkan permintaan duplikat.
+  Amazon S3 menerima permintaan pilih meskipun objek telah dipulihkan. Permintaan pilih tidak mengembalikan respons kesalahan`409`.

## Memulihkan Arsip
<a name="RESTObjectPOSTrestore-restore-request"></a>

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: 
+ **`Expedited`**- Pengambilan yang dipercepat memungkinkan Anda untuk dengan cepat mengakses data Anda yang disimpan di kelas penyimpanan GLACIER ketika permintaan mendesak sesekali untuk subset arsip diperlukan. Untuk semua kecuali objek yang diarsipkan terbesar (250 MB\+), data yang diakses menggunakan pengambilan cepat biasanya tersedia dalam 1—5 menit. Kapasitas yang disediakan memastikan bahwa kapasitas pengambilan untuk pengambilan yang dipercepat tersedia saat Anda membutuhkannya. Pengambilan yang dipercepat dan kapasitas yang disediakan tidak tersedia untuk kelas penyimpanan DEEP\_ARCHIVE.
+ **`Standard`**- Pengambilan standar memungkinkan Anda untuk mengakses salah satu objek yang diarsipkan dalam beberapa jam. Ini adalah opsi default untuk permintaan pengambilan GLACIER dan DEEP\_ARCHIVE yang tidak menentukan opsi pengambilan. Pengambilan standar biasanya selesai dalam waktu 3-5 jam dari kelas penyimpanan GLACIER dan biasanya selesai dalam waktu 12 jam dari kelas penyimpanan DEEP\_ARCHIVE. 
+ **`Bulk`**- Pengambilan massal adalah opsi pengambilan biaya terendah Amazon Glacier, memungkinkan Anda mengambil data dalam jumlah besar, bahkan petabyte, dengan harga murah dalam sehari. Pengambilan massal biasanya selesai dalam 5-12 jam dari kelas penyimpanan GLACIER dan biasanya selesai dalam waktu 48 jam dari kelas penyimpanan DEEP\_ARCHIVE.

Untuk informasi selengkapnya tentang opsi pengambilan arsip dan kapasitas yang disediakan untuk akses `Expedited` data, lihat Memulihkan Objek [ yang Diarsipkan ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html#restoring-objects-upgrade-tier.title.html) 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 *](https://docs.aws.amazon.com/AmazonS3/latest/userguide/NotificationHowTo.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html) dan [ Manajemen Siklus Hidup Ob ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) jek di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*.

## Permintaan
<a name="RESTObjectPOSTrestore-requests"></a>

### Sintaksis
<a name="RESTObjectPOSTrestore-requests-syntax"></a>

```
1. POST /{{ObjectName}}?restore&versionId={{VersionID}} HTTP/1.1
2. Host: {{BucketName}}.s3.amazonaws.com
3. Date: {{date}}
4. Authorization: {{authorization string}} (see Permintaan Otentikasi (AWS Versi Tanda Tangan 4))
5. Content-MD5: {{MD5}}
6. 
7.  {{request body }}
```

**catatan**  
Sintaks menunjukkan beberapa header permintaan. Untuk daftar lengkapnya, lihat “Minta Header,” nanti dalam topik ini.

### Parameter Permintaan
<a name="RESTObjectPOSTrestore-requests-request-parameters"></a>

Implementasi operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="RESTObjectPOSTrestore-requests-request-headers"></a>


|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| Content-MD5 | Intisari data MD5 128-bit yang dikodekan base64. Anda harus menggunakan header ini sebagai pemeriksaan integritas pesan untuk memverifikasi bahwa badan permintaan tidak rusak saat transit. Untuk informasi lebih lanjut, lihat [ RFC 1864](http://www.ietf.org/rfc/rfc1864.txt).<br />Tipe: String <br />Default: Tidak Ada | Ya  | 

### Elemen permintaan
<a name="RESTObjectPOSTrestore-requests-request-elements"></a>

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. 


|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| RestoreRequest | Wadah untuk memulihkan informasi.<br />Tipe: Kontainer | Ya | 
| Days | Seumur hidup salinan yang dipulihkan (aktif). Jumlah hari minimum Anda dapat memulihkan objek dari Amazon Glacier adalah 1. Setelah salinan objek mencapai masa pakai yang ditentukan, Amazon S3 menghapusnya dari bucket. Jika Anda memulihkan arsip, elemen ini diperlukan. <br />Jangan gunakan elemen ini dengan `SELECT` jenis permintaan.<br />Jenis: Integer positif<br />Leluhur: `RestoreRequest` | Ya, jika memulihkan arsip | 
| GlacierJobParameters | Wadah untuk parameter pekerjaan kelas penyimpanan S3 Glacier.<br />Jangan gunakan elemen ini dengan `SELECT` jenis permintaan.<br />Tipe: Kontainer<br />Nenek moyang: `RestoreRequest` | Tidak | 
| Tier | Tingkat akses data yang akan digunakan saat memulihkan arsip. `Standard`adalah default.<br />Jenis: Enum<br />Nilai valid: `Expedited` \| `Standard` \| `Bulk`<br />Nenek moyang: `GlacierJobParameters` | Tidak | 

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. 


|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| RestoreRequest | Wadah untuk memulihkan informasi.<br />Tipe: Kontainer | Ya | 
| Tier | Tingkat akses data yang akan digunakan saat memulihkan arsip. `Standard`adalah default.<br />Jenis: Enum<br />Nilai valid: `Expedited` \| `Standard` \| `Bulk`<br />Nenek moyang: `RestoreRequest` | Tidak | 
| Description | Deskripsi opsional untuk permintaan.<br />Tipe: String<br />Nenek moyang: `RestoreRequest` | Tidak | 
| SelectParameters | Menjelaskan parameter untuk permintaan pekerjaan yang dipilih.<br />Tipe: Kontainer<br />Nenek moyang: `RestoreRequest` | Ya, jika jenis permintaan adalah SELECT  | 
| OutputLocation | Menjelaskan lokasi yang menerima hasil permintaan pemulihan pilih.<br />Jenis: Wadah untuk Amazon S3<br />Leluhur: `RestoreRequest` | Ya, jika jenis permintaan adalah SELECT  | 


**Elem `SelectParameters` en wadah berisi elemen-elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| Expression | Ekspresi SQL. Contoh:+  Ekspresi SQL berikut mengambil kolom pertama data dari objek yang disimpan dalam format CSV: <br />`SELECT s._1 FROM Object s` <br />+  Ekspresi SQL berikut mengembalikan semuanya dari objek: <br />`SELECT * FROM Object` <br />Tipe: String<br />Leluhur: `SelectParameters` | Ya | 
| ExpressionType | Mengidentifikasi jenis ekspresi.<br />Tipe: String<br />Nilai yang valid: `SQL`<br />Leluhur: `SelectParameters` | Ya | 
| InputSerialization | Menjelaskan format serialisasi objek.<br />Jenis: Wadah untuk CSV<br />Leluhur: `SelectParameters` | Ya | 
| OutputSerialization | Menjelaskan bagaimana hasil dari tugas pilih diserialkan.<br />Jenis: Wadah untuk CSV<br />Leluhur: `SelectParameters` | Ya | 


**Elemen penampung CSV dalam `InputSerialization` elemen berisi elemen-elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| RecordDelimiter | Karakter tunggal digunakan untuk memisahkan catatan individu dalam input. Alih-alih nilai default, Anda dapat menentukan pembatas arbitrer.<br />Tipe: String<br />Default: `\n`<br />Leluhur: `CSV` | Tidak | 
| FieldDelimiter | Karakter tunggal digunakan untuk memisahkan bidang individual dalam catatan. Anda dapat menentukan pembatas sewenang-wenang. <br />Tipe: String<br />Default: `,`<br />Leluhur: `CSV` | Tidak | 
| QuoteCharacter | Karakter tunggal yang digunakan untuk melarikan diri ketika pembatas bidang adalah bagian dari nilai.<br />Pertimbangkan contoh ini dalam file CSV: <br />`"a, b" `<br />Membungkus nilai dalam tanda kutip membuat nilai ini menjadi satu bidang. Jika Anda tidak menggunakan tanda kutip, koma adalah pembatas bidang (yang menjadikannya dua nilai bidang terpisah, a dan b).<br />Tipe: String<br />Default: `"`<br />Leluhur: `CSV` | Tidak | 
| QuoteEscapeCharacter | Karakter tunggal yang digunakan untuk melarikan diri dari karakter tanda kutip di dalam nilai yang sudah lolos. Misalnya, nilainya `""" a , b """` diurai sebagai`" a , b "`.<br />Tipe: String<br />Default: `"`<br />Leluhur: `CSV` | Tidak | 
| FileHeaderInfo | Menjelaskan baris pertama dalam data input. Ini adalah salah satu nilai ENUM.+  `NONE`: Baris pertama bukan header. <br />+  `IGNORE`: Baris pertama adalah header, tetapi Anda tidak dapat menggunakan nilai header untuk menunjukkan kolom dalam ekspresi. Anda dapat menggunakan posisi kolom (seperti \_1, \_2,...) untuk menunjukkan kolom (`SELECT s._1 FROM OBJECT s`). <br />+  `Use`: Baris pertama adalah header, dan Anda dapat menggunakan nilai header untuk mengidentifikasi kolom dalam ekspresi (`SELECT "name" FROM OBJECT`).  <br />Jenis: Enum<br />Nilai yang valid: `NONE \| USE \| IGNORE`<br />Leluhur: `CSV` | Tidak | 
| Comments | Karakter tunggal yang digunakan untuk menunjukkan baris harus diabaikan ketika karakter muncul di awal baris tersebut. Anda dapat menentukan karakter apa pun untuk menunjukkan baris komentar.<br />Tipe: String<br />Leluhur: `CSV` | Tidak | 


**Elemen penampung CSV (dalam `OutputSerialization` elemen) berisi elemen-elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| QuoteFields | Menunjukkan apakah akan menggunakan tanda kutip di sekitar bidang keluaran. +  `ALWAYS`: Selalu gunakan tanda kutip untuk bidang keluaran. <br />+  `ASNEEDED`: Gunakan tanda kutip untuk bidang keluaran bila diperlukan. <br />Jenis: Enum<br />Nilai yang valid: `ALWAYS \| ASNEEDED`<br />Default: `AsNeeded`<br />Leluhur: `CSV` | Tidak | 
| RecordDelimiter | Karakter tunggal digunakan untuk memisahkan catatan individu dalam output. Alih-alih nilai default, Anda dapat menentukan pembatas arbitrer. <br />Tipe: String<br />Default: `\n`<br />Leluhur: `CSV` | Tidak | 
| FieldDelimiter | Karakter tunggal digunakan untuk memisahkan bidang individual dalam catatan. Anda dapat menentukan pembatas sewenang-wenang. <br />Tipe: String<br />Default: `,`<br />Leluhur: `CSV` | Tidak | 
| QuoteCharacter | Karakter tunggal yang digunakan untuk melarikan diri ketika pembatas bidang adalah bagian dari nilai. Misalnya, jika nilainya adalah`a, b`, Amazon S3 membungkus nilai bidang ini dalam tanda kutip, sebagai berikut:`" a , b "`.<br />Tipe: String<br />Default: `"`<br />Leluhur: `CSV` | Tidak | 
| QuoteEscapeCharacter | Karakter tunggal yang digunakan untuk melarikan diri dari karakter tanda kutip di dalam nilai yang sudah lolos. Misalnya, jika nilainya adalah`" a , b "`, Amazon S3 membungkus nilai dalam tanda kutip, sebagai berikut:`""" a , b """`.<br />Tipe: String<br />Leluhur: `CSV` | Tidak | 


**Elemen wadah S3 (dalam `OutputLocation` elemen) berisi elemen-elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| AccessControlList | Daftar hibah yang mengontrol akses ke hasil bertahap. <br />Jenis: Wadah untuk Hibah<br />Leluhur: `S3` | Tidak | 
| BucketName | Nama bucket S3 tempat hasil pemulihan pilih disimpan. Bucket harus Wilayah AWS sama dengan bucket yang berisi objek arsip input.<br />Tipe: String<br />Leluhur: `S3` | Ya | 
| CannedACL | Daftar kontrol akses terkaleng (ACL) untuk diterapkan pada hasil pemulihan yang dipilih.<br />Tipe: String<br />Nilai yang valid: ` private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control`<br />Leluhur: `S3` | Tidak | 
| Encryption | Berisi informasi enkripsi untuk hasil yang disimpan.<br />Jenis: Wadah untuk Enkripsi<br />Leluhur: `S3` | Tidak | 
| Prefix | Awalan yang ditambahkan ke hasil pemulihan pilih. Panjang maksimum prefiks adalah 512 byte.<br />Tipe: String<br />Leluhur: `S3` | Ya | 
| StorageClass | Kelas penyimpanan yang digunakan untuk menyimpan hasil permintaan pilih.<br />Tipe: String<br />Nilai valid: `STANDARD` \| `REDUCED_REDUNDANCY` \| `STANDARD_IA` \| `ONEZONE_IA` <br />Leluhur: `S3 ` | Tidak | 
| Tagging | Wadah untuk informasi tag.<br />Jenis: Struktur tag<br />Leluhur: `S3 ` | Tidak | 
| UserMetadata | Berisi daftar metadata untuk disimpan dengan hasil pemulihan pilih.<br />Jenis: MetadataEntry struktur<br />Leluhur: `S3` | Tidak | 


**Elemen kontainer Grantee (dalam `AccessControlList` elemen) berisi elemen-elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| DisplayName | Nama layar penerima izin.<br />Tipe: String<br />Leluhur: `Grantee` | Tidak | 
| EmailAddress | Alamat email penerima izin.<br />Tipe: String<br />Leluhur: `Grantee` | Tidak | 
| ID | ID pengguna kanonik penerima izin.<br />Tipe: String<br />Leluhur: `Grantee` | Tidak | 
| Type | Tipe penerima izin.<br />Tipe: String<br />Leluhur: `Grantee` | Tidak | 
| URI | URI dari grup penerima izin.<br />Tipe: String<br />Leluhur: `Grantee` | Tidak | 
| Permission | Diberikan izin.<br />Tipe: String<br />Leluhur: `Grantee` | Tidak | 


**Elem `en` wadah Enkripsi (dalam S3) berisi elemen-elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| EncryptionType | Algoritma enkripsi sisi server yang digunakan saat menyimpan hasil pekerjaan. Defaultnya adalah tidak ada enkripsi.<br />Tipe: String<br />Nilai yang Valid `aws:kms \| AES256`<br />Leluhur: `Encryption`  | Tidak | 
| KMSContext | Tidak wajib. Jika jenis enkripsi adalah`aws:kms`, Anda dapat menggunakan nilai ini untuk menentukan konteks enkripsi untuk hasil pemulihan yang dipilih.<br />Tipe: String<br />Leluhur: Enkripsi  | Tidak | 
| KMSKeyId | ID kunci AWS Key Management Service (AWS KMS) untuk digunakan untuk enkripsi objek.<br />Tipe: String<br />Leluhur: `Encryption`  | Tidak | 


**Elem `TagSet` en wadah (dalam `elemen` Tagging) berisi elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| Tag | Berisi tag.<br />Tipe: Kontainer<br />Leluhur: `TagSet`  | Tidak | 


**Elemen wadah Tag (dalam `TagSet` elemen) berisi elemen-elemen berikut.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| Key | Nama tanda. <br />Tipe: String<br />Leluhur: `Tag` | Tidak | 
| Value | Nilai tag.<br />Tipe: String<br />Leluhur: `Tag` | Tidak | 


**Elemen `MetadataEntry` wadah (dalam `UserMetadata` elemen) berisi elemen pasangan kunci-nilai berikut untuk disimpan dengan objek.**  

|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| MetadataKey | Kunci metadata.<br />Tipe: String<br />Leluhur: `` | Tidak | 
| MetadataEntry | Nilai metadata.<br />Tipe: String<br />Leluhur: `` | Tidak | 

## Respons
<a name="RESTObjectPOSTrestore-responses"></a>

Operasi yang berhasil mengembalikan kode `202 Accepted` status `200 OK` atau. 
+ Jika salinan objek sebelumnya tidak dipulihkan, maka Amazon S3 kembali `202 Accepted` dalam respons. 
+ Jika salinan objek dipulihkan sebelumnya, Amazon S3 kembali `200 OK` dalam respons. 

### Header Respons
<a name="RESTObjectPOSTrestore-responses-response-headers"></a>

Implementasi operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi selengkapnya, lihat [ Header Respons Umum. ](RESTCommonResponseHeaders.md)

### Elemen Respons
<a name="RESTObjectPOSTrestore-responses-response-elements"></a>

Operasi ini tidak mengembalikan elemen respons.

### Kesalahan Khusus
<a name="RESTObjectPOSTrestore-responses-special-errors"></a>


| Kode Kesalahan | Deskripsi | Kode Status HTTP | Awalan Kode Kesalahan SOAP | 
| --- | --- | --- | --- | 
| RestoreAlreadyInProgress | Pemulihan objek sudah berlangsung. (Kesalahan ini tidak berlaku untuk permintaan tipe SELECT.) | 409 Konflik | Klien | 
| GlacierExpeditedRetrievalNotAvailable | Pengambilan dipercepat kelas penyimpanan S3 Glacier saat ini tidak tersedia. Coba lagi nanti. (Dikembalikan jika kapasitas tidak mencukupi untuk memproses Expedited permintaan. Kesalahan ini hanya berlaku untuk Expedited pengambilan dan bukan untuk Standard atau pengambilan.Bulk) | 503 | N/A | 

## Contoh
<a name="RESTObjectPOSTrestore-responses-examples"></a>

### Kembalikan Objek selama Dua Hari Menggunakan Opsi Pengambilan Dipercepat
<a name="RESTObjectPOSTrestore-responses-examples-sample-request"></a>

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

```
 1. POST /photo1.jpg?restore HTTP/1.1
 2. Host: examplebucket.s3.amazonaws.com
 3. Date: Mon, 22 Oct 2012 01:49:52 GMT
 4. Authorization: {{authorization string}}
 5. Content-Length: {{content length}}
 6. 
 7. <RestoreRequest>
 8.   <Days>2</Days>
 9.   <GlacierJobParameters>
10.     <Tier>Expedited</Tier>
11.   </GlacierJobParameters>
12. </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
<a name="RESTObjectPOSTrestore-responses-examples-select-request"></a>

Berikut ini adalah contoh pilih permintaan pemulihan.

```
 1. POST /object-one.csv?restore HTTP/1.1
 2. Host: examplebucket.s3.amazonaws.com
 3. Date: Date: Sat, 20 Oct 2012 23:54:05 GMT
 4. Authorization: {{authorization string}}
 5. Content-Length: {{content length}}
 6. 
 7. <RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
 8.   <Type>SELECT</Type>
 9.   <Tier>Expedited</Tier>
10.   <Description>this is a description</Description>
11.   <SelectParameters>
12.     <InputSerialization>
13.       <CSV>
14.         <FileHeaderInfo>IGNORE</FileHeaderInfo>
15.         <Comments>#</Comments>
16.         <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
17.         <RecordDelimiter>\n</RecordDelimiter>
18.         <FieldDelimiter>,</FieldDelimiter>
19.         <QuoteCharacter>"</QuoteCharacter>
20.       </CSV>
21.     </InputSerialization>
22.     <ExpressionType>SQL</ExpressionType>
23.     <Expression>select * from object</Expression>
24.     <OutputSerialization>
25.       <CSV>
26.         <QuoteFields>ALWAYS</QuoteFields>
27.         <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
28.         <RecordDelimiter>\n</RecordDelimiter>
29.         <FieldDelimiter>\t</FieldDelimiter>
30.         <QuoteCharacter>\'</QuoteCharacter>
31.       </CSV>
32.     </OutputSerialization>
33.   </SelectParameters>
34.   <OutputLocation>
35.     <S3>
36.       <BucketName>example-output-bucket</BucketName>
37.       <Prefix>test-s3</Prefix>
38.       <AccessControlList>
39.         <Grant>
40.           <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AmazonCustomerByEmail">
41.             <EmailAddress>jane-doe@example.com</EmailAddress>
42.           </Grantee>
43.           <Permission>FULL_CONTROL</Permission>
44.         </Grant>
45.       </AccessControlList>
46.       <UserMetadata>
47.         <MetadataEntry>
48.           <Name>test</Name>
49.           <Value>test-value</Value>
50.         </MetadataEntry>
51.         <MetadataEntry>
52.           <Name>other</Name>
53.           <Value>something else</Value>
54.         </MetadataEntry>
55.       </UserMetadata>
56.       <StorageClass>STANDARD</StorageClass>
57.     </S3>
58.   </OutputLocation>
59. </RestoreRequest>
```

 Amazon S3 mengembalikan `202 Accepted` respons berikut. 

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

## Info Selengkapnya
<a name="RESTObjectPOSTrestore-responses-related-resources-post-res"></a>
+  [GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html) 
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [Referensi SQL untuk Amazon S3 Select dan Amazon Glacier Select ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon *