aws: error: the following arguments are required: --bucket
Comanda are nevoie de un parametru obligatoriu pe care nu l-ai dat, aici --bucket (numele bucket-ului). Adaugă parametrul cu valoarea lui, de exemplu --bucket documente-firma-2026, și rulează din nou.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare operație AWS are parametri obligatorii. Comenzile aws s3api lucrează direct cu API-ul S3, deci cer numele bucket-ului ca parametru separat, --bucket nume, nu ca adresă s3://nume cum fac comenzile de nivel înalt aws s3. Mesajul the following arguments are required: --bucket arată exact ce lipsește; dacă lipsesc mai mulți, apar toți, separați prin virgulă.
Apare des când copiezi un exemplu din documentație și ștergi din greșeală o linie, când o variabilă de shell e goală (--bucket $BUCKET cu BUCKET nedefinit, deci CLI-ul vede --bucket urmat de următorul parametru), sau când amesteci sintaxa aws s3 cu aws s3api.
Ca toate erorile de sintaxă, are codul de ieșire 252 și nu ajunge la AWS: nimic nu s-a modificat în cont.
De ce apare: cauzele frecvente
1Parametrul lipsește complet
aws s3api put-bucket-versioning --versioning-configuration Status=Enabledaws s3api put-bucket-versioning --bucket documente-firma-2026 --versioning-configuration Status=EnabledAPI-ul trebuie să știe pe ce bucket aplică setarea; fără --bucket cererea nu se poate construi.
2Sintaxa aws s3 folosită la s3api
aws s3api get-bucket-versioning s3://documente-firma-2026aws s3api get-bucket-versioning --bucket documente-firma-2026s3api nu acceptă adrese s3://; numele merge în --bucket, fără prefix.
3Variabilă de shell goală
aws s3api put-bucket-versioning --bucket $BUCKET --versioning-configuration Status=Enabled
# BUCKET nu e setatBUCKET=documente-firma-2026
aws s3api put-bucket-versioning --bucket "$BUCKET" --versioning-configuration Status=EnabledCu variabila goală, --bucket rămâne fără valoare. Pune variabilele între ghilimele și setează-le înainte.
Repară eroarea, direct în pagină
Scriptul ~/versionare.sh trebuie să activeze versionarea pe bucket-ul documente-firma-2026, dar dă aws: error: the following arguments are required: --bucket. Repară scriptul și rulează-l, astfel încât versionarea bucket-ului să fie Enabled.
Indiciu
aws s3api cere numele bucket-ului în --bucket, fără prefixul s3://.
Reparația
Adaugă --bucket în script:
cat > ~/versionare.sh <<'EOF'
#!/bin/bash
aws s3api put-bucket-versioning --bucket documente-firma-2026 --versioning-configuration Status=Enabled
EOF
bash ~/versionare.shVerifică:
aws s3api get-bucket-versioning --bucket documente-firma-2026De ce merge
put-bucket-versioning are doi parametri obligatorii: --bucket și --versioning-configuration. Scriptul îl dădea doar pe al doilea, așa că CLI-ul a oprit comanda local, cu codul 252, iar bucket-ul a rămas neversionat. Cu --bucket documente-firma-2026 cererea ajunge la S3 și versionarea devine Enabled; o verifici cu get-bucket-versioning.
Alte forme ale mesajului
aws: error: the following arguments are required: --bucket, --keyaws: error: the following arguments are required: --instance-idsaws: error: the following arguments are required: --public-access-block-configurationaws: error: argument --bucket: expected one argument
Cum o eviți pe viitor
- Verifică parametrii obligatorii cu
aws s3api <operație> help(secțiunea SYNOPSIS: cei fără paranteze drepte sunt obligatorii). - În scripturi pune variabilele între ghilimele și adaugă
set -u, ca o variabilă nedefinită să oprească scriptul. - Reține diferența:
aws s3foloseștes3://bucket/cheie,aws s3apifolosește--bucketși--key.
Întrebări frecvente
De ce aws s3 ls s3://bucket merge, dar s3api vrea --bucket?
aws s3 e un set de comenzi de nivel înalt, gândit pentru fișiere, care înțelege adrese s3://. aws s3api expune operațiile API una câte una, cu parametrii lor exacți.
Cum văd toți parametrii unei operații?
aws s3api put-bucket-versioning help sau --generate-cli-skeleton, care afișează un JSON cu toți parametrii posibili.
Erori înrudite
aws: error: argument operation: Invalid choice, valid choices are: Numele comenzii (operației) nu există pentru serviciul respectiv: de obicei e scris greșit, de exemplu describe-instance în loc de describe-instances sau copy în loc de cp. Citește sugestia „maybe you meant” de la finalul mesajului și scrie numele exact. Parameter validation failed:
Unknown parameter in Tags[0]: "Echipa", must be one of: Key, Value Tag-urile EC2 se scriu ca listă de perechi Key=...,Value=..., nu ca Echipa=web. CLI-ul a citit Echipa ca nume de câmp și nu îl găsește în structura Tag. Scrie --tags Key=Echipa,Value=web Key=Mediu,Value=productie. An error occurred (NoSuchBucket) when calling the ListObjectsV2 operation: The specified bucket does not exist S3 nu găsește bucket-ul cu numele din comandă: e scris greșit (numele sunt exacte, cu litere mici), a fost șters sau încă nu l-ai creat. Verifică numele cu aws s3 ls și corectează comanda, ori creează bucket-ul cu aws s3 mb. Învață AWS de la zero, cu exerciții la fiecare lecție
Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
