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.

# CopyObject (SOAP-API)
<a name="SOAPCopyObject"></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. 

## Description
<a name="SOAPCopyObject_Description"></a>

Der `CopyObject` Vorgang erstellt eine Kopie eines Objekts, wenn Sie den Schlüssel und den Bucket eines Quellobjekts sowie den Schlüssel und den Bucket eines Zielziels angeben. 

Beim Kopieren eines Objekts können Sie alle Metadaten beibehalten (Standard) oder neue Metadaten angeben. Die ACL wird jedoch nicht beibehalten und ist `private` für den Benutzer, der die Anfrage stellt, auf gesetzt. Um die ACL-Standardeinstellung außer Kraft zu setzen, geben Sie beim Generieren einer Kopieranforderung eine neue ACL an. Weitere Informationen finden Sie unter [Verwendung von ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html).

Alle Kopieranfragen müssen authentifiziert werden. Darüber hinaus müssen Sie * * Lesezugriff auf das Quellobjekt und * * Schreibzugriff auf den Ziel-Bucket haben. Weitere Informationen finden Sie unter [ Verwenden des Authentifizierungszugriffs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html). 

Um ein Objekt nur unter bestimmten Bedingungen zu kopieren, z. B. ob das Etag übereinstimmt oder ob das Objekt vor oder nach einem bestimmten Datum geändert wurde, verwenden Sie die Anforderungsparameter`CopySourceIfUnmodifiedSince`, `CopyIfUnmodifiedSince``CopySourceIfMatch`, oder`CopySourceIfNoneMatch`. 

**Anmerkung**  
 Möglicherweise müssen Sie das SOAP-Stack-Socket-Timeout für das Kopieren großer Objekte konfigurieren. 

## Anforderungssyntax
<a name="SOAPCopyObject_RequestSyntax"></a>

```
 1. <CopyObject xmlns="http://bucket_name.s3.amazonaws.com/2006-03-01">
 2.   <SourceBucket>source_bucket</SourceBucket>
 3.   <SourceObject>source_object</SourceObject>
 4.   <DestinationBucket>destination_bucket</DestinationBucket>
 5.   <DestinationObject>destination_object</DestinationObject>
 6.   <MetadataDirective>{REPLACE | COPY}</MetadataDirective>
 7.   <Metadata>
 8.     <Name>metadata_name</Name>
 9.     <Value>metadata_value</Value>
10.   </Metadata>
11.   ...
12.   <AccessControlList>
13.     <Grant>
14.       <Grantee xsi:type="user_type">
15.         <ID>user_id</ID>
16.         <DisplayName>display_name</DisplayName>
17.       </Grantee>
18.       <Permission>permission</Permission>
19.     </Grant>
20.     ...
21.   </AccessControlList>
22.   <CopySourceIfMatch>etag</CopySourceIfMatch>
23.   <CopySourceIfNoneMatch>etag</CopySourceIfNoneMatch>
24.   <CopySourceIfModifiedSince>date_time</CopySourceIfModifiedSince>
25.   <CopySourceIfUnmodifiedSince>date_time</CopySourceIfUnmodifiedSince>
26.   <AWSAccessKeyId>AWSAccessKeyId</AWSAccessKeyId>
27.   <Timestamp>TimeStamp</Timestamp>
28.   <Signature>Signature</Signature>
29. </CopyObject>
```

## Anforderungsparameter
<a name="SOAPCopyObject_RequestParameters"></a>


|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
|  SourceBucket  | Der Name des Quell-Buckets.<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Ein gültiger Quell-Bucket. |  Ja  | 
|  SourceKey  | Der Schlüsselname des Quellobjekts.<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Der Schlüssel für ein gültiges Quellobjekt, auf das Sie LESE-Zugriff haben. |  Ja  | 
|  DestinationBucket  | Der Name des -Ziel-Buckets.<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Sie müssen WRITE-Zugriff auf den Ziel-Bucket haben. |  Ja  | 
|  DestinationKey  |  Der Schlüssel des Zielobjekts.<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Sie müssen WRITE-Zugriff auf den Ziel-Bucket haben. |  Ja  | 
|  MetadataDirective  |  Gibt an, ob die Metadaten aus dem Quellobjekt kopiert oder durch die in der Anforderung bereitgestellten Metadaten ersetzt werden.<br />Typ: Zeichenfolge<br />Standard: COPY<br />Gültige Werte: COPY \| REPLACE<br />Einschränkungen: Andere Werte als `COPY` oder `REPLACE` führen zu einem sofortigen Fehler. Sie können ein Objekt nur in sich selbst kopieren, wenn der MetadataDirective Header angegeben und sein Wert auf gesetzt ist`REPLACE`. |  Nein  | 
|  Metadata  |  Gibt Metadaten-Name-Wert-Paare an, die für das Objekt festgelegt werden sollen. Wenn auf gesetzt MetadataDirective ist`COPY`, werden alle Metadaten ignoriert.<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Keine. |  Nein  | 
|  AccessControlList  | Gewährt Benutzern Zugriff über E-Mail-Adressen oder kanonische Benutzer-IDs.<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Keine |  Nein  | 
|  CopySourceIfMatch  | Kopiert das Objekt, wenn sein Entitäts-Tag (ETag) mit dem angegebenen Tag übereinstimmt; gibt andernfalls a zurück. PreconditionFailed<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Keine. Wenn das Etag nicht übereinstimmt, wird das Objekt nicht kopiert. |  Nein  | 
|  CopySourceIfNoneMatch  | Kopiert das Objekt, wenn sein Entitäts-Tag (ETag) vom angegebenen Etag abweicht; andernfalls wird ein Fehler zurückgegeben.<br />Typ: Zeichenfolge<br />Standard: keiner<br />Einschränkungen: Keine.  |  Nein  | 
|  CopySourceIfUnmodifiedSince  |  Kopiert das Objekt, wenn es seit der angegebenen Zeit nicht geändert wurde; andernfalls wird ein zurückgegeben PreconditionFailed.<br />Typ: DateTime<br />Standard: keiner |  Nein  | 
|  CopySourceIfModifiedSince  | Kopiert das Objekt, wenn es seit dem angegebenen Zeitpunkt geändert wurde; andernfalls wird ein Fehler zurückgegeben.<br />Typ: DateTime<br />Standard: keiner |  Nein  | 

## Antwortsyntax
<a name="SOAPCopyObject_ResponseSyntax"></a>

```
1. <CopyObjectResponse xmlns="http://bucket_name.s3.amazonaws.com/2006-03-01">
2.   <CopyObjectResponse>
3.     <ETag>"etag"</ETag>
4.     <LastModified>timestamp</LastModified>
5.   </CopyObjectResponse>
6. </CopyObjectResponse>
```

## Antwortelemente
<a name="SOAPCopyObject_CommonResponseElements"></a>

Im Folgenden finden Sie eine Liste der Antwortelemente.

**Anmerkung**  
 Die SOAP-API gibt kein zusätzliches Leerzeichen zurück. Zusätzliche Leerzeichen werden nur von der REST-API zurückgegeben. 


|  Name  |  Description  | 
| --- | --- | 
|  Etag  | Gibt das Etag des neuen Objekts zurück. Das ETag spiegelt nur Änderungen am Inhalt eines Objekts wider, nicht an seinen Metadaten.<br />Typ: Zeichenfolge<br />Vorfahr: CopyObjectResult | 
|  LastModified  | Gibt das Datum zurück, an dem das Objekt zuletzt geändert wurde.<br />Typ: Zeichenfolge<br />Vorfahr: CopyObjectResult | 

Informationen zu allgemeinen Antwortelementen finden Sie unter [ Verwenden von ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HandlingErrors.html#UsingRESTErrorResponseHeaders) REST-Fehlerantwort-Headern.

## Spezielle Fehler
<a name="SOAPCopyObject_SpecialErrors"></a>

Für diesen Vorgang gibt es keine speziellen Fehler. Informationen zu allgemeinen Amazon S3-Fehlern finden Sie unter[Liste der Fehlercodes](ErrorResponses.md#ErrorCodeList).

## Beispiele
<a name="SOAPCopyObject_Examples"></a>

Dieses Beispiel kopiert das `flotsam`-Objekt aus dem `pacific`-Bucket in das `jetsam`-Objekt des `atlantic`-Buckets, wobei seine Metadaten beibehalten werden.

### Beispielanforderung
<a name="SOAPCopyObject_Examples_Request1"></a>

```
1. <CopyObject xmlns="http://doc.s3.amazonaws.com/2006-03-01">
2.   <SourceBucket>pacific</SourceBucket>
3.   <SourceObject>flotsam</SourceObject>
4.   <DestinationBucket>atlantic</DestinationBucket>
5.   <DestinationObject>jetsam</DestinationObject>
6.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
7.   <Timestamp>2008-02-18T13:54:10.183Z</Timestamp>
8.   <Signature>Iuyz3d3P0aTou39dzbq7RrtSFmw=</Signature>
9. </CopyObject>
```

### Beispielantwort
<a name="SOAPCopyObject_Examples_Response1"></a>

```
1. <CopyObjectResponse xmlns="http://doc.s3.amazonaws.com/2006-03-01">
2.   <CopyObjectResponse>
3.     <ETag>"828ef3fdfa96f00ad9f27c383fc9ac7f"</ETag>
4.     <LastModified>2008-02-18T13:54:10.183Z</LastModified>
5.   </CopyObjectResponse>
6. </CopyObjectResponse>
```

In diesem Beispiel wird das Objekt „tweedledee“ aus dem Wonderland-Bucket in das „Tweedledum“ -Objekt des Wonderland-Buckets kopiert und die zugehörigen Metadaten ersetzt.

### Beispielanforderung
<a name="SOAPCopyObject_Examples_Request2"></a>

```
 1. <CopyObject xmlns="http://doc.s3.amazonaws.com/2006-03-01">
 2.   <SourceBucket>wonderland</SourceBucket>
 3.   <SourceObject>tweedledee</SourceObject>
 4.   <DestinationBucket>wonderland</DestinationBucket>
 5.   <DestinationObject>tweedledum</DestinationObject>
 6.   <MetadataDirective >REPLACE</MetadataDirective >
 7.   <Metadata>
 8.     <Name>Content-Type</Name>
 9.     <Value>text/plain</Value>
10.   </Metadata>
11.   <Metadata>
12.     <Name>relationship</Name>
13.     <Value>twins</Value>
14.   </Metadata>
15.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
16.   <Timestamp>2008-02-18T13:54:10.183Z</Timestamp>
17.   <Signature>Iuyz3d3P0aTou39dzbq7RrtSFmw=</Signature>
18. </CopyObject>
```

### Beispielantwort
<a name="SOAPCopyObject_Examples_Response2"></a>

```
1. <CopyObjectResponse xmlns="http://doc.s3.amazonaws.com/2006-03-01">
2.   <CopyObjectResponse>
3.     <ETag>"828ef3fdfa96f00ad9f27c383fc9ac7f"</ETag>
4.     <LastModified>2008-02-18T13:54:10.183Z</LastModified>
5.   </CopyObjectResponse>
6. </CopyObjectResponse>
```

## Verwandte Ressourcen
<a name="SOAPCopyObject_RelatedResources"></a>
+  [PutObject (SOAP-API)](SOAPPutObject.md) 
+  [PutObjectInline (SOAP-API)](SOAPPutObjectInline.md)