View a markdown version of this page

ListBucket (API SOAP) - Amazon Simple Storage Service
RichiesteRisposta di successoCorpo della rispostaControllo degli accessi

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)

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'ListBucketoperazione restituisce informazioni su alcuni elementi del bucket.

Per un'introduzione generale all'operazione di elenco, vedere Listing Object Keys.

Richieste

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

Sintassi

<ListBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
  <Bucket>quotes</Bucket>
  <Prefix>notes/</Prefix>
  <Delimiter>/</Delimiter>
  <MaxKeys>1000</MaxKeys>
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</ListBucket>

Parametri

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.

Tipo: stringa

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.

Tipo: stringa

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

Tipo: stringa

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.

Tipo: stringa

Impostazione predefinita: nessuna

 No

Risposta di successo

Questa risposta presuppone che il bucket contenga le seguenti chiavi:

notes/todos.txt
notes/2005-05-23/customer_mtg_notes.txt
notes/2005-05-23/phone_notes.txt
notes/2005-05-28/sales_notes.txt

Sintassi

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Name>backups</Name>
  <Prefix>notes/</Prefix>
  <MaxKeys>1000</MaxKeys>
  <Delimiter>/</Delimiter>
  <IsTruncated>false</IsTruncated>
  <Contents>
    <Key>notes/todos.txt</Key>
    <LastModified>2006-01-01T12:00:00.000Z</LastModified>
    <ETag>&quot;828ef3fdfa96f00ad9f27c383fc9ac7f&quot;</ETag>
    <Size>5126</Size>
    <StorageClass>STANDARD</StorageClass>
    <Owner>
      <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
      <DisplayName>webfile</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
  <CommonPrefixes>
    <Prefix>notes/2005-05-23/</Prefix>
  </CommonPrefixes>
  <CommonPrefixes>
    <Prefix>notes/2005-05-28/</Prefix>
  </CommonPrefixes>
  </ListBucketResult>

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

Elementi di risposta

Nome Description
Contents

Metadati relativi a ciascun oggetto restituito.

Tipo: metadati XML

Antenato: ListBucketResult
CommonPrefixes

Una risposta può contenere CommonPrefixes solo se si specifica undelimiter. Quando lo fai, CommonPrefixes contiene tutte le chiavi (se presenti) comprese tra Prefix e l'occorrenza successiva della stringa specificata dadelimiter. In effetti, CommonPrefixes elenca le chiavi che agiscono come sottodirectory nella directory specificata da. Prefix Ad esempio, se prefix è notes/ ed delimiter è una barra (/), innotes/summer/july, il prefisso comune è. notes/summer/

Tipo: stringa

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.

Tipo: stringa

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

Tipo: stringa

Antenato: booleano
Marker

Indica da dove iniziare l'inserzione nel bucket.

Tipo: stringa

Antenato: ListBucketResult
MaxKeys

Il numero massimo di chiavi restituite nel corpo della risposta.

Tipo: stringa

Antenato: ListBucketResult
Name

Nome del secchio.

Tipo: stringa

Antenato: ListBucketResult
Prefix

Tasti che iniziano con il prefisso indicato.

Tipo: stringa

Antenato: ListBucketResult

Corpo della risposta

Per informazioni sulla risposta all'elenco, vedere Listing Keys Response.

Controllo degli accessi

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