View a markdown version of this page

PutObject (API SOAP) - Amazon Simple Storage Service
ElementiRisposteControllo degli accessiRisorse correlate

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

PutObject (API SOAP)

Nota

Le API SOAP per Amazon S3 non sono disponibili per i nuovi clienti, con la fine del ciclo di vita prevista per il 31 agosto 2025. Ti consigliamo di utilizzare l'API REST o gli AWS SDK.

L'PutObjectoperazione aggiunge un oggetto a un bucket. I dati dell'oggetto sono allegati come allegato DIME.

Per assicurarti che un oggetto non sia danneggiato sulla rete, puoi calcolare l'MD5 di un oggetto, INSERIRLO in Amazon S3 e confrontare l'Etag restituito con il valore MD5 calcolato.

Se un oggetto esiste già in un bucket, il nuovo oggetto lo sovrascriverà perché Amazon S3 memorizza l'ultima richiesta di scrittura. Tuttavia, Amazon S3 è un sistema distribuito. Se Amazon S3 riceve più richieste di scrittura per lo stesso oggetto quasi contemporaneamente, tutti gli oggetti potrebbero essere archiviati, anche se alla fine solo uno vince. Amazon S3 non prevede il blocco degli oggetti; se ne hai bisogno, assicurati di integrarlo nel livello dell'applicazione.

Esempio

Questo esempio inserisce alcuni dati e metadati nell'oggetto «Nelson» del bucket «quotes», consente a un utente (di solito il proprietario) di FULL_CONTROL accedere all'oggetto e lo rende leggibile da parti anonime. In questo esempio, l'allegato effettivo non viene mostrato.

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>

Elementi

  • Bucket:Il bucket in cui aggiungere l'oggetto.

  • Key:La chiave da assegnare all'oggetto.

  • Metadata:È possibile fornire coppie di metadati nome-valore nell'elemento metadati. Questi verranno archiviati con l'oggetto.

  • ContentLength:La lunghezza dei dati in byte.

  • AccessControlList:Un elenco di controllo degli accessi per la risorsa. Questo elemento è facoltativo. Se omesso, al richiedente viene concesso FULL_CONTROL l'accesso all'oggetto. Se l'oggetto esiste già, la politica di controllo degli accessi preesistente viene sostituita.

Risposte

  • ETag:Il tag di entità è un hash MD5 dell'oggetto che è possibile utilizzare per eseguire recuperi condizionali dell'oggetto utilizzando. GetObjectExtended L'ETag riflette solo le modifiche al contenuto di un oggetto, non i suoi metadati.

  • LastModified:Il timestamp di Amazon S3 per l'oggetto salvato.

Controllo degli accessi

Per inserire oggetti in un bucket, devi avere WRITE accesso al bucket.

Risorse correlate