aws: error: argument --bucket: expected one argument
Opțiunea --bucket a rămas fără valoare: după ea urmează altă opțiune sau nimic. Cel mai des, variabila din comandă ($BUCKET) e goală în scriptul tău. Definește variabila în script sau scrie valoarea direct.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
CLI-ul citește opțiunile pereche: --bucket trebuie urmat imediat de o valoare. Mesajul expected one argument apare când după opțiune nu mai e nimic sau urmează direct altă opțiune (--bucket --query ...).
Aproape niciodată nu uiți să tastezi valoarea. De obicei valoarea vine dintr-o variabilă care e goală: ai rulat BUCKET=facturi-2026 în terminal, apoi ai pornit un script cu bash script.sh. Scriptul rulează într-un shell nou și nu vede variabila, așa că --bucket $BUCKET devine --bucket gol. Același lucru apare când o comandă de tipul ID=$(aws ... --query ...) a eșuat sau n-a găsit nimic.
Mesajul numește exact opțiunea fără valoare (--bucket, --instance-ids, --function-name). Ca să vezi comanda așa cum o primește CLI-ul, rulează scriptul cu bash -x script.sh sau pune echo "BUCKET=$BUCKET" înainte de comandă.
De ce apare: cauzele frecvente
1Variabila e definită doar în terminal, nu și în script
BUCKET=rapoarte-ana-2026
bash ~/listeaza.sh
# în script: aws s3api list-objects-v2 --bucket $BUCKET# în script, pe primul rând:
BUCKET=rapoarte-ana-2026
aws s3api list-objects-v2 --bucket $BUCKETUn script pornit cu bash nu moștenește variabilele simple din terminal. Fie le definești în script, fie le exporți (export BUCKET=...).
2Comanda care trebuia să dea ID-ul n-a găsit nimic
ID=$(aws ec2 describe-instances --filters Name=tag:Name,Values=Web \
--query 'Reservations[0].Instances[0].InstanceId' --output text)
aws ec2 stop-instances --instance-ids $IDID=$(aws ec2 describe-instances --filters Name=tag:Name,Values=web \
--query 'Reservations[0].Instances[0].InstanceId' --output text)
[ -n "$ID" ] && [ "$ID" != None ] && aws ec2 stop-instances --instance-ids $IDFiltrele pe tag-uri țin cont de majuscule. Verifică variabila înainte s-o folosești.
3Ai uitat valoarea sau ai pus două opțiuni lipite
aws s3api list-objects-v2 --bucket --prefix rapoarte/aws s3api list-objects-v2 --bucket rapoarte-ana-2026 --prefix rapoarte/După --bucket CLI-ul a găsit --prefix, adică altă opțiune, nu o valoare.
Repară eroarea, direct în pagină
Scriptul ~/listeaza.sh trebuie să salveze în ~/chei.txt numele fișierelor din bucket-ul rapoarte-ana-2026. Ai definit BUCKET doar în terminal, iar scriptul dă argument --bucket: expected one argument. Repară scriptul ca să-și definească singur variabila, apoi rulează-l.
Indiciu
Adaugă BUCKET=rapoarte-ana-2026 pe primul rând din ~/listeaza.sh.
Reparația
Definește variabila în script:
cat > ~/listeaza.sh <<'EOF'
BUCKET=rapoarte-ana-2026
aws s3api list-objects-v2 --bucket $BUCKET --query 'Contents[].Key' --output text > ~/chei.txt
EOF
bash ~/listeaza.sh
cat ~/chei.txtDe ce merge
Scriptul rulează într-un shell nou, care nu vede variabila BUCKET definită în terminal. $BUCKET era gol, deci CLI-ul a primit --bucket fără valoare. Cu variabila definită în script, comanda primește numele bucket-ului și ~/chei.txt conține raport.txt. Ca să nu mai depinzi de terminal, orice script trebuie să-și definească singur valorile de care are nevoie.
Alte forme ale mesajului
aws: error: argument --instance-ids: expected at least one argumentaws: error: argument --function-name: expected one argumentaws: error: argument --profile: expected one argument
Cum o eviți pe viitor
- Pune
set -ula începutul scripturilor: shell-ul se oprește cuunbound variablecând folosești o variabilă nedefinită, în loc să trimită o opțiune goală. - Definește în script toate variabilele de care are nevoie sau citește-le ca argumente (
BUCKET=${1:?dă numele bucket-ului}). - Pune variabilele între ghilimele (
"$BUCKET"), ca să vezi clar când sunt goale. - Rulează scripturile noi cu
bash -xca să vezi fiecare comandă după expandare.
Întrebări frecvente
De ce merge comanda în terminal, dar nu în script?
În terminal variabila există, pentru că ai definit-o acolo. Scriptul pornit cu bash script.sh e un proces nou, care vede doar variabilele exportate (export BUCKET=...) sau pe cele definite în el.
Ce diferență e între expected one argument și expected at least one argument?
Prima apare la opțiunile cu o singură valoare (--bucket), a doua la listele (--instance-ids, --subnets). Cauza e aceeași: opțiunea a rămas fără valoare.
Erori înrudite
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. Unknown options: --tags, Name=web Comanda nu are opțiunea pe care ai scris-o (sau ai dat o valoare în plus, fără opțiune). CLI-ul îți listează exact cuvintele neînțelese. Caută numele corect în aws <serviciu> <comandă> help: de exemplu, describe-instances filtrează cu --filters Name=tag:Name,Values=web, nu cu --tags. 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.
