View a markdown version of this page

PutObjectInline (SOAP-API) - Amazon Simple Storage Service
ElementeAntwortenZugriffskontrolleVerwandte Ressourcen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

PutObjectInline (SOAP-API)

Anmerkung

SOAP APIs für Amazon S3 sind für Neukunden nicht verfügbar und nähern sich am 31. August 2025 dem Ende des Lebenszyklus (EOL). Wir empfehlen, entweder die REST-API oder die AWS SDKs zu verwenden.

Die PutObjectInline Operation fügt einem Bucket ein Objekt hinzu. Die Daten für das Objekt werden im Hauptteil der SOAP-Nachricht bereitgestellt.

Wenn ein Objekt bereits in einem Bucket existiert, überschreibt es das neue Objekt, da Amazon S3 die letzte Schreibanforderung speichert. Amazon S3 ist jedoch ein verteiltes System. Wenn Amazon S3 fast gleichzeitig mehrere Schreibanforderungen für dasselbe Objekt erhält, werden möglicherweise alle Objekte gespeichert, auch wenn am Ende nur eines gewinnt. Amazon S3 bietet keine Objektsperrung. Wenn Sie diese benötigen, stellen Sie sicher, dass Sie sie in Ihre Anwendungsebene integrieren.

Um sicherzustellen, dass ein Objekt im Netzwerk nicht beschädigt wird, können Sie den MD5-Wert eines Objekts berechnen, es in Amazon S3 speichern und das zurückgegebene Etag mit dem berechneten MD5-Wert vergleichen.

PutObjectInline ist nicht für die Verwendung mit großen Objekten geeignet. Das System beschränkt diesen Vorgang auf die Arbeit mit Objekten von 1 MB oder weniger. PutObjectInlineschlägt mit dem InlineDataTooLargeError Statuscode fehl, wenn der Datenparameter ein Objekt kodiert, das größer als 1 MB ist. Um große Objekte hochzuladen, sollten Sie erwägen, stattdessen die PutObject Nicht-Inline-API oder die REST-API zu verwenden.

Beispiel

In diesem Beispiel werden Text und Metadaten in das „Nelson“ -Objekt im Bucket „quotes“ geschrieben, einem Benutzer (normalerweise dem Eigentümer) FULL_CONTROL Zugriff auf das Objekt gewährt und das Objekt für anonyme Parteien lesbar gemacht.

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>

Elemente

  • Bucket:Der Bucket, dem das Objekt hinzugefügt werden soll.

  • Key:Der Schlüssel, der dem Objekt zugewiesen werden soll.

  • Metadata:Sie können Name-Wert-Metadatenpaare im Metadatenelement angeben. Diese werden zusammen mit dem Objekt gespeichert.

  • Data:Die Base-64-kodierte Form der Daten.

  • ContentLength:Die Länge der Daten in Byte.

  • AccessControlList:Eine Zugriffskontrollliste für die Ressource. Das Element ist optional. Wenn nicht angegeben, erhält der Anforderer FULL_CONTROL Zugriff auf das Objekt. Wenn das Objekt bereits existiert, wird die bereits bestehende Zugriffskontrollrichtlinie ersetzt.

Antworten

  • ETag:Das Entitäts-Tag ist ein MD5-Hash des Objekts, mit dem Sie bedingte Abrufe des Objekts durchführen können. GetObjectExtended Das ETag spiegelt nur Änderungen am Inhalt eines Objekts wider, nicht an seinen Metadaten.

  • LastModified:Der Amazon S3-Zeitstempel für das gespeicherte Objekt.

Zugriffskontrolle

Sie müssen WRITE Zugriff auf den Bucket haben, um Objekte in den Bucket legen zu können.

Verwandte Ressourcen