View a markdown version of this page

PutObjectInline (API SABUN) - Amazon Simple Storage Service
ElemenResponsKontrol AksesSumber Daya Terkait

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

PutObjectInline (API SABUN)

catatan

SOAP API untuk Amazon S3 tidak tersedia untuk pelanggan baru, dan mendekati End of Life (EOL) pada 31 Agustus 2025. Kami menyarankan Anda menggunakan REST API atau AWS SDK.

PutObjectInlineOperasi menambahkan objek ke ember. Data untuk objek disediakan di badan pesan SOAP.

Jika objek sudah ada dalam bucket, objek baru akan menuliskannya karena Amazon S3 menyimpan permintaan tulis terakhir. Namun, Amazon S3 adalah sistem terdistribusi. Jika Amazon S3 menerima beberapa permintaan tulis untuk objek yang sama hampir secara bersamaan, semua objek mungkin disimpan, meskipun hanya satu yang menang pada akhirnya. Amazon S3 tidak menyediakan penguncian objek; jika Anda membutuhkan ini, pastikan untuk memasukkannya ke dalam lapisan aplikasi Anda.

Untuk memastikan objek tidak rusak melalui jaringan, Anda dapat menghitung MD5 objek, MEMASUKkannya ke Amazon S3, dan membandingkan Etag yang dikembalikan dengan nilai MD5 yang dihitung.

PutObjectInline tidak cocok untuk digunakan dengan benda besar. Sistem membatasi operasi ini untuk bekerja dengan objek 1MB atau lebih kecil. PutObjectInlineakan gagal dengan kode InlineDataTooLargeError status jika parameter Data mengkodekan objek yang lebih besar dari 1MB. Untuk mengunggah objek besar, pertimbangkan untuk menggunakan PutObject API non-inline, atau REST API sebagai gantinya.

contoh

Contoh ini menulis beberapa teks dan metadata ke dalam objek “Nelson” di bucket “quote”, memberikan pengguna (biasanya pemilik) FULL_CONTROL akses ke objek, dan membuat objek dapat dibaca oleh pihak anonim.

Sample Request

<PutObjectInline xmlns="https://doc.s3.amazonaws.com/2006-03-01">
  <Bucket>quotes</Bucket>
  <Key>Nelson</Key>
  <Metadata>
    <Name>Content-Type</Name>
    <Value>text/plain</Value>
  </Metadata>
  <Metadata>
    <Name>family</Name>
    <Value>Muntz</Value>
  </Metadata>
  <Data>aGEtaGE=</Data>
  <ContentLength>5</ContentLength>
  <AccessControlList>
    <Grant>
      <Grantee xsi:type="CanonicalUser">
        <ID>a9a7b886d6fde241bf9b1c61be666e9</ID>
        <DisplayName>chriscustomer</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
    <Grant>
      <Grantee xsi:type="Group">
        <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>
      </Grantee>
      <Permission>READ</Permission>
    </Grant>
  </AccessControlList>
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</PutObjectInline>

Sample Response

<PutObjectInlineResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <PutObjectInlineResponse>
    <ETag>&quot828ef3fdfa96f00ad9f27c383fc9ac7f&quot</ETag>
    <LastModified>2006-01-01T12:00:00.000Z</lastModified>
  </PutObjectInlineResponse>
</PutObjectInlineResponse>

Elemen

  • Bucket:Ember untuk menambahkan objek.

  • Key:Kunci untuk menetapkan ke objek.

  • Metadata:Anda dapat memberikan pasangan metadata nama-nilai di elemen metadata. Ini akan disimpan dengan objek.

  • Data:Bentuk data yang dikodekan basis 64.

  • ContentLength:Panjang data dalam byte.

  • AccessControlList:Daftar Kontrol Akses untuk sumber daya. Elemen ini opsional. Jika dihilangkan, pemohon diberikan FULL_CONTROL akses ke objek. Jika objek sudah ada, kebijakan kontrol akses yang sudah ada sebelumnya diganti.

Respons

  • ETag:Tag entitas adalah hash MD5 dari objek yang dapat Anda gunakan untuk melakukan pengambilan bersyarat dari objek yang digunakan. GetObjectExtended ETag hanya mencerminkan perubahan pada konten objek, bukan metadatanya.

  • LastModified:Stempel waktu Amazon S3 untuk objek yang disimpan.

Kontrol Akses

Anda harus memiliki WRITE akses ke ember untuk memasukkan benda ke dalam ember.

Sumber Daya Terkait