View a markdown version of this page

PutObject (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.

PutObject (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.

PutObjectOperasi menambahkan objek ke ember. Data untuk objek dilampirkan sebagai lampiran DIME.

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.

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.

contoh

Contoh ini menempatkan beberapa data dan metadata dalam objek “Nelson” dari bucket “quote”, memberikan pengguna (biasanya pemilik) FULL_CONTROL akses ke objek, dan membuat objek dapat dibaca oleh pihak anonim. Dalam sampel ini, lampiran aktual tidak ditampilkan.

Sample Request

<PutObject 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>
  <ContentLength>5</ContentLength>
  <AccessControlList>
    <Grant>
      <Grantee xsi:type="CanonicalUser">
        <ID>a9a7b886d6241bf9b1c61be666e9</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>2007-05-11T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</PutObject>

Sample Response

<PutObjectResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <PutObjectResponse>
    <ETag>&quot;828ef3fdfa96f00ad9f27c383fc9ac7f&quot;</ETag>
    <LastModified>2006-03-01T12:00:00.183Z</LastModified>
  </PutObjectResponse>
</PutObjectResponse>

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.

  • 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

Untuk memasukkan benda ke dalam ember, Anda harus memiliki WRITE akses ke ember.

Sumber Daya Terkait