Elencare cartelle e prefissi tramite S3

dosya associa ogni spazio di lavoro a un contenitore S3 denominato con il suo ID. I nomi di file e cartelle diventano chiavi; un delimitatore barra restituisce i file immediati come oggetti e le cartelle immediate come CommonPrefixes.

Prima di iniziare

Usa una chiave API con permesso di lettura o accesso completo e S3 consentito. Una chiave per il solo caricamento può elencare i contenitori per avviare il client, ma l’elenco degli oggetti restituisce AccessDenied: API key scope ‘upload’ cannot list files. Il ruolo del membro deve consentire sia S3 sia l’accesso ai file.

Una chiave ancorata a una cartella parte da questa come radice logica. I prefissi sono relativi all’ancoraggio: non anteporre il percorso superiore nascosto.

Passaggi

1. Elenca i contenitori e scegli il valore wks_… esatto dello spazio di lavoro; non sostituirlo con il nome visualizzato.
2. Richiedi la radice con delimiter=/ e max-keys pari o inferiore a 1000.
3. Separa le voci Contents restituite da CommonPrefixes; un prefisso comune termina con / e rappresenta una cartella dosya.
4. Scegli un prefisso figlio, ad esempio photos/, e invia la richiesta successiva rispettando maiuscole e barra finale.
5. Quando IsTruncated è true, passa NextContinuationToken alla richiesta V2 successiva; i client V1 devono continuare con NextMarker.
6. Fermati solo quando l’ultima pagina indica che non ci sono risultati troncati, poi confronta l’insieme completo con la cartella consentita in dosya.

Risultato previsto

Il client percorre l’albero dosya accessibile senza saltare voci dopo i primi 1.000 risultati. I prefissi corrispondenti a un file esatto restituiscono solo quel file, i prefissi parziali filtrano gli elementi allo stesso livello e un prefisso inesistente dà un risultato vuoto senza estendere la ricerca alla radice del contenitore.

Se il contenitore appare ma non il contenuto, controlla ambito della chiave API, permesso del membro per i file, regole sui file nascosti ed eventuale ancoraggio a una cartella. Una chiave vincolata elenca solo lo spazio di lavoro associato.

Guide correlate

• Collegare un client S3
• Limitare i permessi S3