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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
AWS CLI citește argumentele comenzii după tabelul de parametri al operației. Tot ce nu se potrivește ajunge în lista de după Unknown options:, separate prin virgulă: întâi opțiunea necunoscută (--tags), apoi valoarea ei (Name=web), pe care CLI-ul nu are cui s-o dea.
Cele mai dese cauze: o opțiune care există la altă comandă (--tags merge la create-tags, nu la describe-instances), un nume ghicit (--bucket-name în loc de --bucket), o valoare în plus pentru o opțiune care primește una singură, sau un comutator (--recursive, --dry-run) urmat de o valoare.
Eroarea apare local, înainte de orice cerere (cod de ieșire 252), deci nu are legătură cu permisiunile. Deasupra ei vezi textul usage: aws [options] <command> <subcommand>, care îți amintește să citești pagina de help a comenzii.
De ce apare: cauzele frecvente
1Opțiune care există doar la altă comandă
aws ec2 describe-instances --tags Name=webaws ec2 describe-instances --filters Name=tag:Name,Values=webdescribe-instances filtrează cu --filters, iar un tag se cere ca filtru tag:<cheie>. --tags e opțiunea comenzilor care pun etichete, ca create-tags.
2Numele opțiunii ghicit
aws s3api create-bucket --bucket-name facturi-2026 --region eu-central-1aws s3api create-bucket --bucket facturi-2026 --region eu-central-1 \
--create-bucket-configuration LocationConstraint=eu-central-1Opțiunile au numele exacte din documentație. aws s3api create-bucket help le listează pe toate.
3Două valori pentru o opțiune care primește una
aws s3 cp raport.csv s3://rapoarte-ana-2026/ --content-type text/csv utf-8aws s3 cp raport.csv s3://rapoarte-ana-2026/ --content-type "text/csv; charset=utf-8"Spațiul desparte argumentele. O valoare cu spații trebuie pusă între ghilimele, altfel bucata a doua devine un argument necunoscut.
Repară eroarea, direct în pagină
Scriptul ~/ip-web.sh trebuie să afișeze IP-ul public al serverului cu tag-ul Name=web, dar dă Unknown options: --tags, Name=web. Repară filtrul din script ca bash ~/ip-web.sh să ruleze fără eroare și să afișeze IP-ul.
Indiciu
describe-instances filtrează după tag cu --filters Name=tag:Name,Values=web.
Reparația
Înlocuiește --tags Name=web cu filtrul corect:
cat > ~/ip-web.sh <<'EOF'
aws ec2 describe-instances --filters Name=tag:Name,Values=web --query 'Reservations[].Instances[].PublicIpAddress' --output text
EOF
bash ~/ip-web.shDe ce merge
describe-instances nu are opțiunea --tags, așa că CLI-ul s-a oprit înainte să trimită cererea. Filtrarea după etichete se face cu --filters, unde numele filtrului este tag: urmat de cheia etichetei, iar Values e valoarea căutată. Cu filtrul corect, AWS întoarce doar serverul web, iar --query scoate din răspuns PublicIpAddress.
Alte forme ale mesajului
Unknown options: --bucket-name, facturi-2026Unknown options: --force-glacier-transferUnknown options: utf-8
Cum o eviți pe viitor
- Rulează
aws <serviciu> <comandă> helpînainte de o comandă nouă și copiază numele opțiunilor de acolo. - Activează completarea automată (
aws_completer): apeși Tab și vezi doar opțiunile valide. - Pune între ghilimele orice valoare cu spații.
- Când copiezi o comandă dintr-un articol, verifică dacă e pentru
aws s3(comenzi de nivel înalt) sau pentruaws s3api(operațiile API): au opțiuni diferite.
Întrebări frecvente
De ce apare și valoarea în listă, nu doar opțiunea?
Pentru că CLI-ul nu știe că Name=web aparține lui --tags. Orice argument neconsumat de o opțiune cunoscută ajunge în listă, în ordinea în care l-ai scris.
E la fel cu „the following arguments are required”?
Nu. Acolo lipsește o opțiune obligatorie; aici ai dat o opțiune pe care comanda nu o are. Pot apărea și împreună, dacă ai scris numele obligatoriu greșit.
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. 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. Error parsing parameter '--tags': Expected: '=', received: 'EOF' for input: Valoarea dată în sintaxa scurtă (shorthand) a AWS CLI nu are forma cheie=valoare: parserul a ajuns la final fără să găsească „=”. Scrie structura complet, de exemplu --tags Key=Proiect,Value=magazin, sau dă-o ca JSON între ghilimele simple. Î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.
