Elemente Antworten Zugriffskontrolle Verwandte Ressourcen

PutObject (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 PutObject Operation fügt einem Bucket ein Objekt hinzu. Die Daten für das Objekt werden als DIME-Anlage angehängt.

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

Wenn ein Objekt bereits in einem Bucket existiert, überschreibt das neue Objekt es, 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.

Beispiel

In diesem Beispiel werden einige Daten und Metadaten in das „Nelson“ -Objekt des Buckets „Quotes“ eingefügt, einem Benutzer (in der Regel dem Eigentümer) FULL_CONTROL Zugriff auf das Objekt gewährt und das Objekt für anonyme Parteien lesbar gemacht. In diesem Beispiel wird der eigentliche Anhang nicht angezeigt.

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>

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

Um Objekte in einen Bucket zu legen, müssen Sie WRITE Zugriff auf den Bucket haben.