...
Eroare AWS · Sintaxa comenzilor AWS CLI

Unknown options: --tags, Name=web

Pe scurt

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ă

Greșit
BASH
aws ec2 describe-instances --tags Name=web
Corect
BASH
aws ec2 describe-instances --filters Name=tag:Name,Values=web

describe-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

Greșit
BASH
aws s3api create-bucket --bucket-name facturi-2026 --region eu-central-1
Corect
BASH
aws s3api create-bucket --bucket facturi-2026 --region eu-central-1 \
  --create-bucket-configuration LocationConstraint=eu-central-1

Opț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

Greșit
BASH
aws s3 cp raport.csv s3://rapoarte-ana-2026/ --content-type text/csv utf-8
Corect
BASH
aws 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ă tu

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.

Alte forme ale mesajului

  • Unknown options: --bucket-name, facturi-2026
  • Unknown options: --force-glacier-transfer
  • Unknown 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 pentru aws 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

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