Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# ListBucket (API SOAP)
<a name="SOAPListBucket"></a>

**Nota**  
 Le API SOAP per Amazon S3 non sono disponibili per i nuovi clienti, con la fine del ciclo di vita prevista per il 31 agosto 2025. Ti consigliamo di utilizzare l'API REST o gli AWS SDK. 

 L'`ListBucket`operazione restituisce informazioni su alcuni elementi del bucket. 

 Per un'introduzione generale all'operazione di elenco, vedere [ Listing Object Keys](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html).

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

Questo esempio elenca fino a 1000 chiavi nel bucket «quotes» che hanno il prefisso «notes».

### Sintassi
<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>
```

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


|  Nome  |  Description  |  Richiesto  | 
| --- | --- | --- | 
|  prefix  | Limita la risposta alle chiavi che iniziano con il prefisso indicato. È possibile utilizzare i prefissi per separare un bucket in diversi set di chiavi in modo simile a come un file system utilizza le cartelle.<br />Tipo: stringa<br />Impostazione predefinita: nessuna |  No  | 
|  marker  | Indica da dove iniziare l'elenco nel bucket. L'elenco includerà solo le chiavi che compaiono lessicograficamente dopo il marker. Questo è utile per l'impaginazione: per ottenere la pagina successiva dei risultati, usa l'ultima chiave della pagina corrente come indicatore.<br />Tipo: stringa<br />Impostazione predefinita: nessuna |  No  | 
|  max-keys  | Il numero massimo di tasti che vorresti vedere nel corpo della risposta. Il server potrebbe restituire meno di questo numero di chiavi, ma non ne restituirà di più.<br />Tipo: stringa<br />Impostazione predefinita: nessuna |  No  | 
|  delimiter  | Fa sì che le chiavi che contengono la stessa stringa tra il prefisso e la prima occorrenza del delimitatore vengano raggruppate in un unico elemento risultato della raccolta. CommonPrefixes Queste chiavi raggruppate non vengono restituite altrove nella risposta.<br />Tipo: stringa<br />Impostazione predefinita: nessuna |  No  | 

## Risposta di successo
<a name="SOAPBucketGET_ResponseSuccess"></a>

Questa risposta presuppone che il bucket contenga le seguenti chiavi:

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

### Sintassi
<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>
```

Come puoi vedere, molti campi della risposta rispecchiano i parametri della richiesta. `IsTruncated`e `CommonPrefixes` sono gli unici elementi di risposta che possono contenere nuove informazioni. `Contents`

### Elementi di risposta
<a name="SOAPBucketGET_ResponseSuccess-response-elements"></a>


|  Nome  |  Description  | 
| --- | --- | 
|  Contents  | Metadati relativi a ciascun oggetto restituito.<br />Tipo: metadati XML<br />Antenato: ListBucketResult | 
|  CommonPrefixes  |  Una risposta può contenere `CommonPrefixes` solo se si specifica un`delimiter`. Quando lo fai, `CommonPrefixes` contiene tutte le chiavi (se presenti) comprese tra `Prefix` e l'occorrenza successiva della stringa specificata da`delimiter`. In effetti, `CommonPrefixes` elenca le chiavi che agiscono come sottodirectory nella directory specificata da. `Prefix` Ad esempio, se `prefix` è `notes/` ed `delimiter` è una barra (/), in`notes/summer/july`, il prefisso comune è. `notes/summer/` <br />Tipo: stringa<br />Antenato: ListBucketResult | 
|  Delimiter  | Fa sì che le chiavi che contengono la stessa stringa tra il prefisso e la prima occorrenza del delimitatore vengano raggruppate in un unico elemento risultato della raccolta. CommonPrefixes Queste chiavi raggruppate non vengono restituite altrove nella risposta.<br />Tipo: stringa<br />Antenato: ListBucketResult | 
|  IsTruncated  | Specifica se (vero) o meno (falso) sono stati restituiti tutti i risultati. Non è possibile restituire tutti i risultati se il numero di risultati supera quello specificato da. `MaxKeys`<br />Tipo: stringa<br />Antenato: booleano | 
|  Marker  | Indica da dove iniziare l'inserzione nel bucket.<br />Tipo: stringa<br />Antenato: ListBucketResult | 
|  MaxKeys  | Il numero massimo di chiavi restituite nel corpo della risposta.<br />Tipo: stringa<br />Antenato: ListBucketResult | 
|  Name  | Nome del secchio.<br />Tipo: stringa<br />Antenato: ListBucketResult | 
|  Prefix  | Tasti che iniziano con il prefisso indicato.<br />Tipo: stringa<br />Antenato: ListBucketResult | 

## Corpo della risposta
<a name="SOAPListBucketResponseBody"></a>

 Per informazioni sulla risposta all'elenco, vedere [ Listing Keys Response](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html). 

## Controllo degli accessi
<a name="SOAPListBucketAccessControl"></a>

Per elencare le chiavi di un bucket è necessario che sia stato concesso `READ` l'accesso al bucket.