Connettere AWS CLI a dosya S3

Usa un profilo AWS CLI dedicato con nome per provare dosya S3 senza cambiare le normali credenziali AWS. Questa guida elenca uno spazio di lavoro, carica un file di testo dal nome univoco, lo scarica e ne controlla i byte. Usa chiamate dirette s3api per facilitare il controllo del test su file piccolo.

Prima di iniziare

Installa AWS CLI v2 seguendo le istruzioni AWS per la tua piattaforma, poi esegui aws --version. Gli esempi usano la sintassi POSIX di macOS/Linux; i comandi aws funzionano anche in PowerShell, ma sostituisci i controlli locali printf, cmp e $? con gli equivalenti.

Nello spazio di lavoro dosya desiderato, apri Integrazioni → S3 e copia l’ID del Bucket. L’endpoint è https://api.dosya.dev/s3, la regione us-east-1, con indirizzamento path. Non c’è il prefisso WebDAV All/. Per una chiave vincolata a una cartella, i percorsi partono sotto la cartella di ancoraggio: usa aws-check.txt per scrivere al suo interno, non AnchorName/aws-check.txt.

Prepara le credenziali da Profilo → Chiavi API → Crea una chiave API: scegli Accesso completo per tutti e tre i test, lo Spazio di lavoro desiderato e Gateway S3 in Restrizioni e scadenza → Protocolli → Solo quelli che scelgo. Genera la chiave, espandi la sua riga e scegli credenziali S3 → Attiva. Copia ID chiave di accesso e Chiave di accesso segreta dalla finestra. Il token dos_… non è il segreto AWS CLI. Il segreto S3 è mostrato solo alla generazione; Attive · mostra non può recuperarlo in seguito. Se lo perdi, sostituisci chiave e coppia, migra i client e revoca la vecchia chiave.

Il tuo ruolo deve consentire S3, elenco, caricamento e download dei file. Un nuovo prefisso annidato richiede anche la creazione di cartelle. Il piano gratuito è utilizzabile entro le quote previste; un account gratuito può avere tre chiavi API, con un massimo globale di 20. Le restrizioni esplicite di accesso e utilizzo valgono per ogni comando.

Passaggi: configurare un profilo privato

1. Scegli un profilo che non esiste già. Queste istruzioni usano dosya-help-check. Controlla prima aws configure list-profiles. Se il profilo appartiene a una connessione esistente, usa sempre un altro nome.
2. Inserisci la coppia in modo interattivo. Esegui:

aws configure --profile dosya-help-check

Alle richieste inserisci l’ID di accesso S3 generato, il relativo segreto S3, us-east-1 e json. Non incollare credenziali come argomenti del comando e non fare commit dei file risultanti. L’inserimento evita di includere il segreto nella cronologia dei comandi, ma non usarlo in una sessione di terminale registrata: la configurazione AWS CLI non garantisce che l’input sia nascosto.

Per impostazione predefinita AWS CLI salva la coppia in ~/.aws/credentials e le impostazioni in ~/.aws/config, anche su Windows nella cartella utente. Sono file locali, non un archivio password cifrato. Su un account Unix privato limita l’accesso ai file dopo la configurazione:

chmod 600 ~/.aws/credentials ~/.aws/config

3. Imposta l’indirizzamento path S3 per questo profilo. Cambia solo la sua configurazione:

aws configure set s3.addressing_style path --profile dosya-help-check
aws configure get region --profile dosya-help-check
aws configure get s3.addressing_style --profile dosya-help-check

Dovresti ottenere us-east-1 e path. Ogni comando remoto seguente specifica --endpoint-url; se lo ometti, la richiesta può raggiungere AWS anziché dosya. Non usare un comando di identità STS per verificare queste credenziali: dosya offre un gateway S3, non AWS STS.

4. Controlla privatamente le origini selezionate. Esegui aws configure list --profile dosya-help-check: in questa procedura con profilo nominato esplicito, le credenziali dovrebbero provenire dal file condiviso delle credenziali e la regione dalla sua configurazione. I comandi senza --profile seguono un ordine di risoluzione diverso e possono scegliere le credenziali dell’ambiente; mantieni l’opzione del profilo in ogni test. Anche se l’elenco maschera gran parte dei caratteri delle credenziali, il risultato resta riservato alla diagnostica privata. Vedi precedenza delle credenziali AWS.

Passaggi: elencare, caricare e scaricare un file di prova

Sostituisci ovunque ws_example con l’ID dello spazio di lavoro copiato e aws-check-20261014-unique.txt con un nome nuovo che hai verificato non essere usato. Esegui i comandi da una cartella di lavoro locale temporanea. Non scegliere una chiave esistente importante: PUT può sostituirne il contenuto con una nuova versione dosya.

aws --profile dosya-help-check --region us-east-1 --endpoint-url https://api.dosya.dev/s3 s3api list-objects-v2 --bucket ws_example --max-keys 10 --no-paginate
printf 'Dosya AWS CLI connection check\n' > ./aws-check-20261014-unique.txt
aws --profile dosya-help-check --region us-east-1 --endpoint-url https://api.dosya.dev/s3 s3api put-object --bucket ws_example --key aws-check-20261014-unique.txt --body ./aws-check-20261014-unique.txt
aws --profile dosya-help-check --region us-east-1 --endpoint-url https://api.dosya.dev/s3 s3api head-object --bucket ws_example --key aws-check-20261014-unique.txt
aws --profile dosya-help-check --region us-east-1 --endpoint-url https://api.dosya.dev/s3 s3api get-object --bucket ws_example --key aws-check-20261014-unique.txt ./aws-check-downloaded.txt
cmp ./aws-check-20261014-unique.txt ./aws-check-downloaded.txt

--max-keys 10 --no-paginate richiede una piccola pagina di elenco; una radice autorizzata vuota può non avere Contents. Questo non dimostra che non esistano altre pagine. Per elenchi più grandi segui la paginazione: il gateway limita ogni pagina a 1.000 voci.

PUT normalmente produce JSON con ETag; HEAD include ContentLength; GET scrive il file di destinazione e stampa i metadati della risposta. La riga di esempio sopra è di 31 byte, incluso il ritorno a capo. Scegli anche un nuovo nome per il download, perché un file locale esistente può essere sovrascritto. cmp non stampa nulla ed esce con zero per file identici. In PowerShell confronta (Get-FileHash ./source.txt).Hash con (Get-FileHash ./download.txt).Hash e controlla $LASTEXITCODE subito dopo ogni comando AWS nativo. Nelle shell POSIX usa subito echo $?: un comando successivo sostituisce quello stato.

In dosya File, verifica nome e dimensione del file nello spazio di lavoro scelto o nella cartella di ancoraggio della chiave. Il test della connessione richiede codice di uscita CLI zero e byte scaricati corrispondenti; gli ETag dei file multipart non sono normali hash MD5. Questa procedura non concede a nessun destinatario un link pubblico.

Risultato previsto e pulizia consapevole

Hai un profilo dedicato che elenca direttamente il bucket e un file di prova verificato byte per byte dopo il download. Conserva il profilo solo se intendi usarlo e mantieni privati i file delle credenziali.

Per rimuovere solo questo file di prova, ricontrolla bucket e chiave, poi esegui:

aws --profile dosya-help-check --region us-east-1 --endpoint-url https://api.dosya.dev/s3 s3api delete-object --bucket ws_example --key aws-check-20261014-unique.txt

DeleteObject restituisce 204 anche se la chiave è assente: una risposta silenziosa non prova che l’oggetto esistesse. Un’eliminazione effettiva invia il file nel cestino di dosya e ne revoca le condivisioni; non libera subito spazio di archiviazione. La pulizia del cestino segue la conservazione effettiva del proprietario: sette giorni per il piano gratuito o 30 per quello a pagamento. L’eliminazione definitiva distrugge i byte recuperabili.

Per ritirare la connessione, usa Revoca sulla chiave API dedicata. L’azione è irreversibile e disattiva anche la coppia S3, senza rimuovere i dati nel cloud. Dopo aver verificato che stai modificando il profilo giusto, rimuovi solo il blocco [dosya-help-check] dal file locale delle credenziali e il blocco [profile dosya-help-check] dalla configurazione; non eliminare i file di configurazione AWS condivisi. Cancella i file di prova locali solo dopo i controlli ancora necessari.

Risoluzione dei problemi

AccessDenied durante l’elenco o il download. Solo caricamento non basta. Controlla permessi della chiave, protocollo S3, vincolo allo spazio di lavoro, ruolo del membro, indirizzo e orari attivi. L’elenco della radice S3 usa normali percorsi di file, non nomi di raccolte WebDAV.

SignatureDoesNotMatch. Verifica che ID di accesso e segreto provengano dalla stessa finestra S3 e che il client firmi endpoint, regione e percorso effettivamente inviati. Una riscrittura del proxy o un altro profilo scelto da un programma intermediario può far fallire un profilo salvato correttamente.

Limitazione dell’utilizzo o all’ingresso. Una risposta XML 429 SlowDown deriva dai limiti d’uso della chiave o del ruolo: leggi Message e rispetta Retry-After se presente. Riduci i trasferimenti paralleli in caso di rifiuto per concorrenza; riprovare non ripristina la quota di byte. La limitazione separata all’ingresso restituisce JSON 429 {“ok”:false,“error”:“Too many requests”}, con Retry-After, dopo l’esaurimento del limite di 600 richieste/minuto per utente o 1.200/minuto per IP. Attendi l’intervallo e scagliona i processi con molte richieste. Le regole dello spazio di lavoro per archiviazione e file e il traffico giornaliero in uscita restano limiti distinti.

Un client di copia di sicurezza richiede versionamento del bucket o Object Lock. Queste funzioni di configurazione AWS non sono supportate; l’indirizzamento path non le abilita. I caricamenti con lo stesso nome usano la cronologia dosya (10 versioni predefinite, con potatura e conservazione di sette giorni delle versioni datate per proprietari gratuiti), non gli ID di versione AWS S3. Conserva originali indipendenti.

Non inserire mai credenziali complete, URL di richieste firmate o output --debug non oscurato in una segnalazione pubblica. Per i rifiuti legati all’orologio e alle firme anticipate consulta la guida dedicata a firma e ora.

Guide correlate

• Impostazioni S3, operazioni supportate ed errori di permesso
• Firma delle richieste S3 e risoluzione dei problemi di scadenza
• Riferimento per la configurazione AWS CLI