

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

# Objek POST
<a name="RESTObjectPOST"></a>

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

`POST`Operasi menambahkan objek ke bucket tertentu dengan menggunakan formulir HTML. `POST`adalah bentuk alternatif `PUT` yang memungkinkan unggahan berbasis browser sebagai cara memasukkan objek ke dalam bucket. Parameter yang diteruskan `PUT` melalui header HTTP malah diteruskan sebagai bidang formulir ke `POST` dalam badan pesan yang dikodekan multipart/form -data. Untuk menambahkan objek ke bucket, Anda harus memiliki `WRITE` akses pada bucket. Amazon S3 tidak pernah menyimpan sebagian objek. Jika Anda menerima respons yang berhasil, Anda dapat yakin bahwa seluruh objek disimpan.

Amazon S3 adalah sistem terdistribusi. Kecuali Anda telah mengaktifkan pembuatan versi untuk bucket, jika Amazon S3 menerima beberapa permintaan penulisan untuk objek yang sama secara bersamaan, hanya versi terakhir dari objek yang ditulis yang disimpan.

Untuk memastikan bahwa data tidak rusak saat melintasi jaringan, gunakan kolom `Content-MD5` formulir. Saat Anda menggunakan bidang formulir ini, Amazon S3 memeriksa objek terhadap nilai MD5 yang disediakan. Jika tidak cocok, Amazon S3 mengembalikan kesalahan. Selain itu, Anda dapat menghitung nilai MD5 saat memposting objek ke Amazon S3 dan membandingkan nilai yang dikembalikan `ETag` ke nilai MD5 yang dihitung. ETag hanya mencerminkan perubahan pada isi objek, bukan metadatanya.

**catatan**  
Untuk mengonfigurasi aplikasi Anda untuk mengirim header permintaan sebelum mengirim isi permintaan, gunakan kode status HTTP 100 (Lanjutkan). Untuk `POST` operasi, menggunakan kode status ini membantu Anda menghindari pengiriman isi pesan jika pesan ditolak berdasarkan header (misalnya, karena kegagalan otentikasi atau pengalihan). Untuk informasi selengkapnya tentang kode status HTTP 100 (Lanjutkan), buka Bagian 8.2.3 dari [ http://www.ietf.org/rfc/rfc2616.txt](http://www.ietf.org/rfc/rfc2616.txt).

Amazon S3 secara otomatis mengenkripsi semua objek baru yang diunggah ke bucket S3. Pengaturan enkripsi objek yang diunggah tergantung pada konfigurasi enkripsi default dari bucket tujuan. Secara default, semua bucket memiliki konfigurasi enkripsi default yang menggunakan enkripsi sisi server dengan kunci terkelola Amazon S3 ()SSE-S3. 

Jika bucket tujuan memiliki konfigurasi enkripsi yang menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS), enkripsi sisi server lapis ganda dengan kunci (SSE-KMS), atau AWS KMS kunci enkripsi yang disediakan pelanggan (DSSE-KMS), Amazon S3 menggunakan kunci KMS yang sesuai atau kunci yang disediakan pelanggan untuk mengenkripsi objek yang diunggah. SSE-C Saat mengunggah objek, jika Anda ingin mengubah pengaturan enkripsi objek yang diunggah, Anda dapat menentukan jenis enkripsi sisi server. Anda dapat mengkonfigurasi SSE-S3, SSE-KMS, DSSE-KMS, atau SSE-C. Untuk informasi selengkapnya, lihat [Melindungi data menggunakan enkripsi sisi server](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) di *Panduan Pengguna Amazon Simple Storage Service*.

**penting**  
Saat membuat permintaan Anda, pastikan bahwa `file` bidang tersebut adalah bidang terakhir dalam formulir.

## Permohonan
<a name="RESTObjectPOST-requests"></a>

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

```
 1. POST / HTTP/1.1
 2. Host: {{destinationBucket}}.s3.amazonaws.com
 3. User-Agent: {{browser_data}}
 4. Accept: {{file_types}}
 5. Accept-Language: {{Regions}}
 6. Accept-Encoding: {{encoding}}
 7. Accept-Charset: {{character_set}}
 8. Keep-Alive: 300
 9. Connection: keep-alive
10. Content-Type: multipart/form-data; boundary=9431149156168
11. Content-Length: {{length}}
12. 
13. --9431149156168
14. Content-Disposition: form-data; name="key"
15. 
16. acl
17. --9431149156168
18. Content-Disposition: form-data; name="tagging"
19. 
20. <Tagging><TagSet><Tag><Key>{{Tag Name}}</Key><Value>{{Tag Value}}</Value></Tag></TagSet></Tagging>
21. --9431149156168
22. Content-Disposition: form-data; name="success_action_redirect"
23. 
24. success_redirect
25. --9431149156168
26. Content-Disposition: form-data; name="Content-Type"
27. 
28. content_type
29. --9431149156168
30. Content-Disposition: form-data; name="x-amz-meta-uuid"
31. 
32. uuid
33. --9431149156168
34. Content-Disposition: form-data; name="x-amz-meta-tag"
35. 
36. metadata
37. --9431149156168
38. Content-Disposition: form-data; name="AWSAccessKeyId"
39. 
40. access-key-id
41. --9431149156168
42. Content-Disposition: form-data; name="Policy"
43. 
44. encoded_policy
45. --9431149156168
46. Content-Disposition: form-data; name="Signature"
47. 
48. signature=
49. --9431149156168
50. Content-Disposition: form-data; name="file"; filename="{{MyFilename.jpg}}"
51. Content-Type: image/jpeg
52. 
53. file_content
54. --9431149156168
55. Content-Disposition: form-data; name="submit"
56. 
57. Upload to Amazon S3
58. --9431149156168--
```

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

Implementasi operasi ini tidak menggunakan parameter permintaan.

### Bidang Formulir
<a name="RESTObjectPOST-requests-form-fields"></a>

Operasi ini dapat menggunakan kolom formulir berikut.


| Nama | Deskripsi | Diperlukan | 
| --- | --- | --- | 
| AWSAccessKeyId | ID kunci AWS akses pemilik bucket yang memberikan akses pengguna Anonim untuk permintaan yang memenuhi kumpulan batasan dalam kebijakan.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Diperlukan jika dokumen kebijakan disertakan dengan permintaan.  | Bersyarat | 
| acl | Daftar kontrol akses Amazon S3 (ACL) yang ditentukan. Jika ACL yang ditentukan tidak valid, kesalahan dihasilkan. Untuk informasi selengkapnya tentang ACL, lihat ik [ htisar daftar kontrol akses (ACL) ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon. * <br />Tipe: String<br />Default: privat<br /> Nilai Valid: `private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control `  | Tidak | 
| Cache-Control, Content-Type, Content-Disposition, Content-Encoding, Expires | He REST-specific ader. Untuk informasi selengkapnya, lihat [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).<br />Tipe: String<br />Default: Tidak Ada | Tidak | 
| file | File atau konten teks. <br />File atau konten teks harus menjadi bidang terakhir dalam formulir.<br />Anda tidak dapat mengunggah lebih dari satu file sekaligus.<br />Jenis: File atau konten teks<br />Default: Tidak Ada | Ya | 
| key | Nama kunci yang diunggah.<br />Untuk menggunakan nama file yang disediakan oleh pengguna, gunakan `${filename}` variabel. Misalnya, jika pengguna bernama Mary mengunggah file `example.jpg` dan Anda tentukan`/user/mary/${filename}`, nama kuncinya adalah`/user/mary/example.jpg`.<br />Untuk informasi selengkapnya, lihat [ Kunci objek dan metadata ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*.<br />Tipe: String<br />Default: Tidak Ada | Ya | 
| policy | Kebijakan keamanan yang menjelaskan apa yang diizinkan dalam permintaan. Permintaan tanpa kebijakan keamanan dianggap anonim dan hanya berfungsi pada bucket yang dapat ditulis secara publik. Untuk informasi selengkapnya, lihat [ formulir HTML ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HTTPPOSTForms.html) dan [ Unggah contoh ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HTTPPOSTExamples.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*. <br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Kebijakan keamanan diperlukan jika bucket tidak dapat ditulis secara publik. | Bersyarat | 
| success\_action\_redirect, redirect | URL tempat klien dialihkan setelah unggahan berhasil.<br />Jika `success_action_redirect` tidak ditentukan, maka Amazon S3 akan mengembalikan jenis dokumen kosong yang ditentukan dalam bidang `success_action_status`.<br />Jika Amazon S3 tidak dapat menafsirkan URL, ia bertindak seolah-olah bidang tidak ada.<br />Jika pengunggahan gagal, maka Amazon S3 akan menampilkan pesan kesalahan dan tidak akan mengalihkan pengguna ke URL.<br />Tipe: String<br />Default: Tidak Ada Nama `redirect` bidang tidak digunakan lagi, dan dukungan untuk nama `redirect` bidang akan dihapus di masa mendatang.   | Tidak | 
| success\_action\_status | Jika Anda tidak menentukan`success_action_redirect`, kode status dikembalikan ke klien saat upload berhasil.<br />Bidang ini menerima nilai `200``201`,, atau `204` (default).<br />Jika nilainya disetel ke `200` atau`204`, Amazon S3 mengembalikan dokumen kosong dengan kode status 200 atau 204.<br />Jika nilainya disetel ke`201`, Amazon S3 mengembalikan dokumen XML dengan kode status 201. <br />Jika nilai tidak disetel atau jika disetel ke nilai yang tidak valid, Amazon S3 mengembalikan dokumen kosong dengan kode status 204. <br />Tipe: String<br />Default: Tidak Ada | Tidak | 
| tagging | Kumpulan tag yang ditentukan untuk ditambahkan ke objek. Untuk menambahkan tag, gunakan skema pengkodean berikut.<br /> <pre><Tagging><br />  <TagSet><br />    <Tag><br />      <Key>{{TagName}}</Key><br />      <Value>{{TagValue}}</Value><br />    </Tag><br />    ...<br />  </TagSet><br /></Tagging></pre><br />Untuk informasi selengkapnya, lihat [ Penandaan objek ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) di Panduan * Pengguna Layanan Penyimpanan Sederhana * Amazon.<br />Tipe: String<br />Default: Tidak Ada | Tidak | 
| x-amz-storage-class | Kelas penyimpanan yang digunakan untuk menyimpan objek. Jika Anda tidak menentukan kelas, Amazon S3 menggunakan kelas penyimpanan default,`STANDARD`. Amazon S3 mendukung kelas penyimpanan lainnya. Untuk informasi selengkapnya, lihat [ Kelas penyimpanan ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*. <br />Tipe: String<br />Default: `STANDARD`<br />Nilai yang valid: `REDUCED_REDUNDANCY` `EXPRESS_ONEZONE` `DEEP_ARCHIVE` \| `GLACIER` \| `GLACIER_IR` \| `INTELLIGENT_TIERING` \| `ONEZONE_IA` \| `STANDARD` \| `STANDARD_IA`  | Tidak | 
| x-amz-meta-\* | Header yang dimulai dengan awalan ini adalah metadata yang ditentukan pengguna. Masing-masing disimpan dan dikembalikan sebagai satu set pasangan kunci-nilai. Amazon S3 tidak memvalidasi atau menafsirkan metadata yang ditentukan pengguna. Untuk informasi selengkapnya, lihat [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).<br />Tipe: String<br />Default: Tidak Ada | Tidak | 
| x-amz-security-token | Token DevPay keamanan Amazon. <br />Setiap permintaan yang menggunakan Amazon DevPay memerlukan dua bidang `x-amz-security-token` formulir: satu untuk token produk dan satu untuk token pengguna.<br />Tipe: String<br />Default: Tidak Ada | Tidak | 
| x-amz-signature | (AWS Signature Version 4) HMAC-SHA256 Hash dari kebijakan keamanan.<br />Tipe: String<br />Default: Tidak Ada | Bersyarat | 
| x-amz-website-redirect-location  | Jika bucket dikonfigurasi sebagai situs web, bidang ini mengalihkan permintaan untuk objek ini ke objek lain dalam bucket yang sama atau ke URL eksternal. Amazon S3 menyimpan nilai header ini dalam metadata objek. Untuk informasi tentang metadata objek, lihat K [ unci objek dan metadata ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*.<br />Dalam contoh berikut, header permintaan menetapkan pengalihan ke objek (`anotherPage.html`) dalam bucket yang sama:<br />`x-amz-website-redirect-location: /anotherPage.html`<br />Dalam contoh berikut, header permintaan mengatur pengalihan objek ke situs web lain:<br />`x-amz-website-redirect-location: http://www.example.com/`<br />Untuk informasi selengkapnya tentang hosting situs web di Amazon S3, lihat [ Hosting situs web di Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html) dan [ Cara mengonfigurasi pengalihan halaman situs web ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-page-redirect.html) di Panduan * Pengguna Layanan Penyimpanan Sederhana * Amazon.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Nilai harus diawali dengan`/`,`http://`, atau`https://`. Panjang nilai dibatasi hingga 2 KB. |  Tidak  | 

#### Bidang Formulir Permintaan Checksum Tambahan
<a name="post-object-additional-checksums"></a>

Saat mengunggah objek, Anda dapat menentukan berbagai checksum yang ingin Anda gunakan untuk memverifikasi integritas data Anda. Anda dapat menentukan satu algoritma checksum tambahan untuk Amazon S3 untuk digunakan. Untuk informasi selengkapnya tentang nilai checksum tambahan, lihat Memer [ iksa integritas objek ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) di Panduan * Pengguna Layanan Penyimpanan Sederhana * Amazon.


|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
|  x-amz-checksum-algorithm  | Menunjukkan algoritma yang digunakan untuk membuat checksum untuk objek. Jika nilai ditentukan, Anda harus menyertakan header checksum yang cocok. Jika tidak, permintaan Anda akan menghasilkan kesalahan 400.<br />Nilai yang mungkin termasuk `CRC32`, `CRC32C`, `SHA1`, dan `SHA256`. | Tidak | 
|  x-amz-checksum-crc32  | Menentukan checksum CRC32 32-bit yang dikodekan base64 dari objek.<br />Parameter ini diperlukan jika nilainya `x-amz-checksum-algorithm` adalah`CRC32`. | Bersyarat | 
|  x-amz-checksum-crc32c  | Menentukan checksum objek CRC32C 32-bit yang dikodekan base64.<br />Parameter ini diperlukan jika nilainya `x-amz-checksum-algorithm` adalah`CRC32C`. | Bersyarat | 
|  x-amz-checksum-sha1  | Menentukan ringkasan 160-bit yang dikodekan base64 dari objek SHA-1 .<br />Parameter ini diperlukan jika nilainya `x-amz-checksum-algorithm` adalah`SHA1`. | Bersyarat | 
|  x-amz-checksum-sha256  | Menentukan intisari objek 256-bit yang dikodekan base64 SHA-256 .<br />Parameter ini diperlukan jika nilainya `x-amz-checksum-algorithm` adalah`SHA256`. | Bersyarat | 

#### Server-Side Bidang Formulir Permintaan Khusus Enkripsi
<a name="post-object-sse-specific-request-headers"></a>

Server-side Enkripsi adalah enkripsi data saat diam. Amazon S3 mengenkripsi data Anda saat menulisnya ke disk di pusat AWS data dan mendekripsi data Anda saat Anda mengaksesnya. Saat mengunggah objek, Anda dapat menentukan jenis enkripsi sisi server yang ingin digunakan Amazon S3 untuk mengenkripsi objek. 

Ada empat jenis enkripsi sisi server: 
+ **Server-side enkripsi dengan kunci terkelola Amazon S3 (SSE-S3) ** — Mulai Mei 2022, semua bucket Amazon S3 memiliki enkripsi yang dikonfigurasi secara default. Opsi default untuk enkripsi sisi server adalah dengan. SSE-S3 Setiap objek dienkripsi dengan kunci unik. Sebagai perlindungan tambahan, SSE-S3 mengenkripsi kunci itu sendiri dengan kunci root yang secara teratur diputar. SSE-S3 menggunakan salah satu sandi blok terkuat yang tersedia, 256-bit Advanced Encryption Standard (AES-256), untuk mengenkripsi data Anda.
+ **Server-side enkripsi dengan AWS KMS kunci (SSE-KMS) ** — SSE-KMS disediakan melalui integrasi AWS KMS layanan dengan Amazon S3. Dengan AWS KMS, Anda memiliki kontrol lebih besar atas kunci Anda. Misalnya, Anda dapat melihat kunci terpisah, mengedit kebijakan kontrol, dan mengikuti kunci di AWS CloudTrail. Selain itu, Anda dapat membuat dan mengelola CMK atau menggunakan Kunci yang dikelola AWS yang unik bagi Anda, layanan Anda, dan Wilayah Anda.
+ **Dual-layer enkripsi sisi server dengan AWS KMS kunci (DSSE-KMS) ** — enkripsi Dual-layer sisi server dengan AWS KMS keys (DSSE-KMS) mirip dengan SSE-KMS, tetapi menerapkan dua lapisan individual enkripsi tingkat objek alih-alih satu lapisan. 
+ **Server-side enkripsi dengan kunci yang disediakan pelanggan (SSE-C) ** — Dengan SSE-C, Anda mengelola kunci enkripsi, dan Amazon S3 mengelola enkripsi saat menulis ke disk, dan dekripsi saat Anda mengakses objek Anda. 
**catatan**  
Jika Anda memiliki enkripsi sisi server dengan kunci (SSE-C) yang disediakan pelanggan yang diblokir untuk bucket tujuan umum Anda, Anda akan mendapatkan kesalahan HTTP 403 Access Denied saat Anda menentukan header SSE-C permintaan saat menulis data baru ke bucket Anda. Untuk informasi selengkapnya, lihat Mem [ blokir atau membuka blokir SSE-C untuk bucket ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html) tujuan umum.

Untuk informasi selengkapnya, lihat [ Melindungi data menggunakan enkripsi sisi server ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon. *

Bergantung pada jenis enkripsi sisi server yang ingin Anda gunakan, tentukan bidang formulir berikut. 
+ **Gunakan SSE-S3, SSE-KMS, atau DSSE-KMS ** — Jika Anda ingin menggunakan jenis enkripsi sisi server ini, tentukan bidang formulir berikut dalam permintaan.     
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/AmazonS3/latest/developerguide/RESTObjectPOST.html)
**catatan**  
Jika Anda menentukan `x-amz-server-side-encryption:aws:kms` atau`x-amz-server-side-encryption:aws:kms:dsse`, tetapi tidak memberikan`x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 menggunakan Kunci yang dikelola AWS (`aws/S3`) untuk melindungi data.
+ **Gunakan SSE-C ** — Jika Anda ingin mengelola kunci enkripsi Anda sendiri, Anda harus memberikan semua bidang formulir berikut dalam permintaan. 
**catatan**  
Jika Anda menggunakan SSE-C, `ETag` nilai yang dikembalikan Amazon S3 dalam respons bukanlah MD5 objek.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/AmazonS3/latest/developerguide/RESTObjectPOST.html)

### Respons
<a name="RESTObjectPOST-requests-responses"></a>

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

Implementasi operasi ini dapat mencakup header respons berikut selain header respons yang umum untuk semua tanggapan. Untuk informasi selengkapnya, lihat [ Header Respons Umum. ](RESTCommonResponseHeaders.md)


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  x-amz-checksum-crc32  | Checksum objek CRC32 32-bit yang dikodekan base64.<br />Tipe: String | 
|  x-amz-checksum-crc32c  | Checksum objek CRC32C 32-bit yang dikodekan base64.<br />Tipe: String | 
|  x-amz-checksum-sha1  | Intisari objek 160-bit yang dikodekan base64 SHA-1 .<br />Tipe: String | 
|  x-amz-checksum-sha256  | Intisari objek 256-bit yang dikodekan base64 SHA-256 .<br />Tipe: String | 
|  x-amz-expiration  | Jika `Expiration` tindakan dikonfigurasi untuk objek sebagai bagian dari konfigurasi siklus hidup bucket, Amazon S3 mengembalikan header ini.  Nilai header mencakup `expiry-date` komponen dan URL-encoded `rule-id` komponen.  Untuk bucket berkemampuan versi, header ini hanya berlaku untuk versi saat ini. Amazon S3 tidak menyediakan header untuk menunjukkan kapan versi noncurrent memenuhi syarat untuk penghapusan permanen. Untuk informasi selengkapnya, lihat [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html).<br />Tipe: String | 
|  success\_action\_redirect, redirect  | URL tempat klien diarahkan pada unggahan yang berhasil.<br />Tipe: String<br />Leluhur: PostResponse | 
|  x-amz-server-side-encryption  | Algoritma enkripsi sisi server yang digunakan saat menyimpan objek ini di Amazon S3 (misalnya,, `AES256``aws:kms`,`aws:kms:dsse`).<br />Tipe: String | 
|  x-amz-server-side-encryption-aws-kms-key-id  | Jika `x-amz-server-side-encryption` header memiliki nilai valid`aws:kms`, header ini menentukan ID kunci KMS yang digunakan untuk mengenkripsi objek.<br />Tipe: String | 
|  x-amz-server-side-encryption-bucket-key-enabled  | Jika `x-amz-server-side-encryption` memiliki nilai valid`aws:kms`, header ini menunjukkan apakah objek dienkripsi SSE-KMS dengan menggunakan S3 Bucket Key. Jika header ini disetel ke`true`, objek menggunakan S3 Bucket Key dengan SSE-KMS.<br />Jenis: Boolean | 
|  x-amz-server-side-encryption-customer-algorithm  | Jika SSE-C diminta, respons menyertakan header ini, yang mengkonfirmasi algoritma enkripsi yang digunakan.<br />Tipe: String<br />Nilai yang Valid: `AES256` | 
|  x-amz-server-side-encryption-customer-key-MD5  | Jika SSE-C diminta, respons menyertakan header ini untuk memverifikasi integritas pesan pulang-pergi dari kunci enkripsi yang disediakan pelanggan.<br />Tipe: String | 
| x-amz-version-id | Versi objek.<br />Tipe: String | 

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


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Bucket  | Nama ember tempat objek disimpan.<br />Tipe: String<br />Leluhur: PostResponse | 
|  ETag  | Tag entitas (ETag) adalah hash MD5 dari objek yang dapat Anda gunakan untuk melakukan `GET` operasi bersyarat dengan menggunakan tag `If-Modified` permintaan dengan operasi `GET` permintaan. `ETag`mencerminkan perubahan hanya pada isi objek, bukan pada metadatanya.<br />Tipe: String<br />Leluhur: PostResponse | 
|  Key  | Nama kunci objek.<br />Tipe: String<br />Leluhur: PostResponse | 
|  Location  | URI dari objek.<br />Tipe: String<br />Leluhur: PostResponse | 

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

Implementasi operasi ini tidak mengembalikan kesalahan khusus. Untuk informasi umum tentang kesalahan Amazon S3 dan daftar kode kesalahan, lihat Respons [ Kesalahan](ErrorResponses.md).

## Contoh
<a name="RESTObjectPOST-requests-examples"></a>

### Permintaan Sampel
<a name="ExampleVersionObjectPost"></a>

```
1. POST /Neo HTTP/1.1
2. Content-Length: 4
3. Host: quotes.s3.amazonaws.com
4. Date: Wed, 01 Mar  2006 12:00:00 GMT
5. Authorization: {{authorization string}}
6. Content-Type: text/plain
7. Expect: the 100-continue HTTP status code
8. 
9. {{ObjectContent}}
```

### Sampel Respon dengan Pembuatan Versi Ditangguhkan
<a name="RESTObjectPOST-requests-examples-sample-response-with-versioning-suspended"></a>

Berikut ini adalah contoh respons saat pembuatan versi bucket ditangguhkan:

```
 1. HTTP/1.1 100 Continue
 2. HTTP/1.1 200 OK
 3. x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
 4. x-amz-request-id: 0A49CE4060975EAC
 5. x-amz-version-id: default
 6. Date: Wed, 12 Oct 2009 17:50:00 GMT
 7. ETag: "1b2cf535f27731c974343645a3985328"
 8. Content-Length: 0
 9. Connection: close
10. Server: AmazonS3
```

Dalam respons ini, ID versi adalah`null`.

### Contoh Respon dengan Versioning Diaktifkan
<a name="RESTObjectPOST-requests-examples-sample-response-with-versioning-enabled"></a>

Berikut ini adalah contoh respons saat pembuatan versi bucket diaktifkan.

```
 1. HTTP/1.1 100 Continue
 2. HTTP/1.1 200 OK
 3. x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
 4. x-amz-request-id: 0A49CE4060975EAC
 5. x-amz-version-id: 43jfkodU8493jnFJD9fjj3HHNVfdsQUIFDNsidf038jfdsjGFDSIRp
 6. Date: Wed, 01 Mar  2006 12:00:00 GMT
 7. ETag: "828ef3fdfa96f00ad9f27c383fc9ac7f"
 8. Content-Length: 0
 9. Connection: close
10. Server: AmazonS3
```

## Sumber Daya Terkait
<a name="RESTObjectPOST-requests-related-resources"></a>
+  [CopyObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) 
+  [Objek POST](#RESTObjectPOST) 
+  [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) 