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.

# PutObject (SOAP-API)
<a name="SOAPPutObject"></a>

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

**Example**  
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`  

```
 1. <PutObject xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 2.   <Bucket>quotes</Bucket>
 3.   <Key>Nelson</Key>
 4.   <Metadata>
 5.     <Name>Content-Type</Name>
 6.     <Value>text/plain</Value>
 7.   </Metadata>
 8.   <Metadata>
 9.     <Name>family</Name>
10.     <Value>Muntz</Value>
11.   </Metadata>
12.   <ContentLength>5</ContentLength>
13.   <AccessControlList>
14.     <Grant>
15.       <Grantee xsi:type="CanonicalUser">
16.         <ID>a9a7b886d6241bf9b1c61be666e9</ID>
17.         <DisplayName>chriscustomer</DisplayName>
18.       </Grantee>
19.       <Permission>FULL_CONTROL</Permission>
20.     </Grant>
21.     <Grant>
22.       <Grantee xsi:type="Group">
23.         <URI>http://acs.amazonaws.com/groups/global/AllUsers<URI>
24.       </Grantee>
25.       <Permission>READ</Permission>
26.     </Grant>
27.   </AccessControlList>
28.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
29.   <Timestamp>2007-05-11T12:00:00.183Z</Timestamp>
30.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
31. </PutObject>
```
`Sample Response`  

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

## Elemente
<a name="SOAPPutObjectElements"></a>
+  `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
<a name="SOAPPutObjectResponse"></a>
+ `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
<a name="SOAPPutObjectAccessControl"></a>

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

## Verwandte Ressourcen
<a name="SOAPPutObject_RelatedResources"></a>
+  [CopyObject (SOAP-API)](SOAPCopyObject.md)