...
Eroare AWS · Sintaxa comenzilor AWS CLI

aws: error: argument --bucket: expected one argument

Pe scurt

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

Greșit
BASH
BUCKET=rapoarte-ana-2026
bash ~/listeaza.sh
# în script: aws s3api list-objects-v2 --bucket $BUCKET
Corect
BASH
# în script, pe primul rând:
BUCKET=rapoarte-ana-2026
aws s3api list-objects-v2 --bucket $BUCKET

Un 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

Greșit
BASH
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 $ID
Corect
BASH
ID=$(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 $ID

Filtrele pe tag-uri țin cont de majuscule. Verifică variabila înainte s-o folosești.

3Ai uitat valoarea sau ai pus două opțiuni lipite

Greșit
BASH
aws s3api list-objects-v2 --bucket --prefix rapoarte/
Corect
BASH
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ă tu

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.

Alte forme ale mesajului

  • aws: error: argument --instance-ids: expected at least one argument
  • aws: error: argument --function-name: expected one argument
  • aws: error: argument --profile: expected one argument

Cum o eviți pe viitor

  • Pune set -u la începutul scripturilor: shell-ul se oprește cu unbound variable câ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 -x ca 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

← Toate erorile AWS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

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