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.

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

 Der `ListBucket` Vorgang gibt Informationen zu einigen Elementen im Bucket zurück. 

 Eine allgemeine Einführung in den Listenvorgang finden Sie unter Objektschlüssel [ auflisten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html).

## Anforderungen
<a name="SOAPBucketGET_Request"></a>

In diesem Beispiel werden bis zu 1000 Schlüssel im Bucket „Anführungszeichen“ aufgeführt, die das Präfix „notes“ haben.

### Syntax
<a name="SOAPBucketGET_RequestSyntax"></a>

```
1. <ListBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
2.   <Bucket>quotes</Bucket>
3.   <Prefix>notes/</Prefix>
4.   <Delimiter>/</Delimiter>
5.   <MaxKeys>1000</MaxKeys>
6.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
7.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
8.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
9. </ListBucket>
```

### Parameter
<a name="SOAPBucketGET_RequestHeaders"></a>


|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
|  prefix  | Beschränkt die Antwort auf Schlüssel, die mit dem angegebenen Präfix beginnen. Sie können Präfixe verwenden, um einen Bucket in verschiedene Schlüsselsätze zu unterteilen, ähnlich wie ein Dateisystem Ordner verwendet.<br />Typ: Zeichenfolge<br />Standard: keiner |  Nein  | 
|  marker  | Gibt an, an welcher Stelle im Bucket mit der Auflistung begonnen werden soll. Die Liste enthält nur Schlüssel, die lexikografisch hinter der Markierung vorkommen. Das ist praktisch für die Seitennummerierung: Um zur nächsten Ergebnisseite zu gelangen, verwenden Sie den letzten Schlüssel der aktuellen Seite als Markierung.<br />Typ: Zeichenfolge<br />Standard: keiner |  Nein  | 
|  max-keys  | Die maximale Anzahl von Schlüsseln, die Sie im Antworttext sehen möchten. Der Server gibt möglicherweise weniger als so viele Schlüssel zurück, aber nicht mehr.<br />Typ: Zeichenfolge<br />Standard: keiner |  Nein  | 
|  delimiter  | Bewirkt, dass Schlüssel, die dieselbe Zeichenfolge zwischen dem Präfix und dem ersten Vorkommen des Trennzeichens enthalten, zu einem einzigen Ergebniselement in der CommonPrefixes Auflistung zusammengefasst werden. Diese zusammengefassten Schlüssel werden an keiner anderen Stelle in der Antwort zurückgegeben.<br />Typ: Zeichenfolge<br />Standard: keiner |  Nein  | 

## Antwort: Erfolg
<a name="SOAPBucketGET_ResponseSuccess"></a>

Bei dieser Antwort wird davon ausgegangen, dass der Bucket die folgenden Schlüssel enthält:

```
1. notes/todos.txt
2. notes/2005-05-23/customer_mtg_notes.txt
3. notes/2005-05-23/phone_notes.txt
4. notes/2005-05-28/sales_notes.txt
```

### Syntax
<a name="SOAPBucketGET_ResponseSuccess-syntax"></a>

```
 1. <?xml version="1.0" encoding="UTF-8"?>
 2. <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
 3.   <Name>backups</Name>
 4.   <Prefix>notes/</Prefix>
 5.   <MaxKeys>1000</MaxKeys>
 6.   <Delimiter>/</Delimiter>
 7.   <IsTruncated>false</IsTruncated>
 8.   <Contents>
 9.     <Key>notes/todos.txt</Key>
10.     <LastModified>2006-01-01T12:00:00.000Z</LastModified>
11.     <ETag>&quot;828ef3fdfa96f00ad9f27c383fc9ac7f&quot;</ETag>
12.     <Size>5126</Size>
13.     <StorageClass>STANDARD</StorageClass>
14.     <Owner>
15.       <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
16.       <DisplayName>webfile</DisplayName>
17.     </Owner>
18.     <StorageClass>STANDARD</StorageClass>
19.   </Contents>
20.   <CommonPrefixes>
21.     <Prefix>notes/2005-05-23/</Prefix>
22.   </CommonPrefixes>
23.   <CommonPrefixes>
24.     <Prefix>notes/2005-05-28/</Prefix>
25.   </CommonPrefixes>
26.   </ListBucketResult>
```

Wie Sie sehen können, geben viele Felder in der Antwort die Anforderungsparameter wieder. `IsTruncated``Contents`, und `CommonPrefixes` sind die einzigen Antwortelemente, die neue Informationen enthalten können.

### Antwortelemente
<a name="SOAPBucketGET_ResponseSuccess-response-elements"></a>


|  Name  |  Description  | 
| --- | --- | 
|  Contents  | Metadaten zu jedem zurückgegebenen Objekt.<br />Typ: XML-Metadaten<br />Vorfahr: ListBucketResult | 
|  CommonPrefixes  |  Eine Antwort kann `CommonPrefixes` nur enthalten, wenn Sie eine `delimiter` angeben. Wenn Sie dies tun, `CommonPrefixes` enthält sie alle Schlüssel (falls es welche gibt) zwischen `Prefix` und dem nächsten Vorkommen der Zeichenfolge, die durch angegeben ist`delimiter`. `CommonPrefixes`Listet tatsächlich Schlüssel auf, die sich wie Unterverzeichnisse in dem von `Prefix` angegebenen Verzeichnis verhalten. Wenn beispielsweise ein Schrägstrich (/) `prefix` `delimiter` ist `notes/` und ein Schrägstrich (/) ist, ist in `notes/summer/july` das allgemeine Präfix. `notes/summer/` <br />Typ: Zeichenfolge<br />Vorfahr: ListBucketResult | 
|  Delimiter  | Bewirkt, dass Schlüssel, die dieselbe Zeichenfolge zwischen dem Präfix und dem ersten Vorkommen des Trennzeichens enthalten, zu einem einzigen Ergebniselement in der Sammlung zusammengefasst werden. CommonPrefixes Diese zusammengefassten Schlüssel werden an keiner anderen Stelle in der Antwort zurückgegeben.<br />Typ: Zeichenfolge<br />Vorfahr: ListBucketResult | 
|  IsTruncated  | Gibt an, ob (wahr) oder nicht (falsch) alle Ergebnisse zurückgegeben wurden. Es werden möglicherweise nicht alle Ergebnisse zurückgegeben, wenn die Anzahl der Ergebnisse die angegebene Anzahl von überschreitet`MaxKeys`.<br />Typ: Zeichenfolge<br />Vorfahr: boolesch | 
|  Marker  | Gibt an, an welcher Stelle im Bucket mit dem Listing begonnen werden soll.<br />Typ: Zeichenfolge<br />Vorfahr: ListBucketResult | 
|  MaxKeys  | Die maximale Anzahl von Schlüsseln, die im Antworttext zurückgegeben werden.<br />Typ: Zeichenfolge<br />Vorfahr: ListBucketResult | 
|  Name  | Name des Eimers.<br />Typ: Zeichenfolge<br />Vorfahr: ListBucketResult | 
|  Prefix  | Schlüssel, die mit dem angegebenen Präfix beginnen.<br />Typ: Zeichenfolge<br />Vorfahr: ListBucketResult | 

## Antworttext
<a name="SOAPListBucketResponseBody"></a>

 Informationen zur Listenantwort finden Sie unter [ Listing Keys Response](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html). 

## Zugriffskontrolle
<a name="SOAPListBucketAccessControl"></a>

Um die Schlüssel eines Buckets aufzulisten, müssen Sie `READ` Zugriff auf den Bucket erhalten haben.