View a markdown version of this page

PutObjectInline (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à.

PutObjectInline (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'PutObjectInlineoperazione aggiunge un oggetto a un bucket. I dati per l'oggetto sono forniti nel corpo del messaggio SOAP.

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.

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.

PutObjectInline non è adatto all'uso con oggetti di grandi dimensioni. Il sistema limita questa operazione a lavorare con oggetti di dimensioni pari o inferiori a 1 MB. PutObjectInlineavrà esito negativo con il codice di InlineDataTooLargeError stato se il parametro Data codifica un oggetto di dimensioni superiori a 1 MB. Per caricare oggetti di grandi dimensioni, valuta la possibilità di utilizzare invece l'API non in linea o l' PutObject API REST.

Esempio

Questo esempio scrive del testo e dei metadati nell'oggetto «Nelson» nel bucket «quotes», fornisce a un utente (di solito il proprietario) l'FULL_CONTROLaccesso all'oggetto e lo rende leggibile da parti anonime.

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>

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.

  • Data:La forma codificata in base 64 dei dati.

  • 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

È necessario avere WRITE accesso al bucket per inserire oggetti nel bucket.

Risorse correlate