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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Înainte să trimită cererea, AWS CLI validează parametrii după modelul API-ului. --tags la EC2 este o listă de structuri Tag, fiecare cu două câmpuri: Key și Value. În sintaxa prescurtată (shorthand), un element se scrie Key=Echipa,Value=web, iar elementele se separă prin spațiu.
Când scrii Echipa=web, CLI-ul înțelege „câmpul Echipa al primului tag are valoarea web”. Câmpul nu există, deci primești Unknown parameter in Tags[0]: "Echipa", must be one of: Key, Value. Tags[0] arată poziția din listă (primul tag), iar finalul mesajului îți spune câmpurile acceptate.
Aceeași formă de mesaj apare pentru orice parametru structurat scris greșit, de exemplu Unknown parameter in Filters[0] sau Missing required parameter in Tags[0]: "Key". Codul de ieșire este 252 și nimic nu se schimbă în cont.
De ce apare: cauzele frecvente
1Tag scris ca cheie=valoare
aws ec2 create-tags --resources $ID --tags Echipa=webaws ec2 create-tags --resources $ID --tags Key=Echipa,Value=webShorthand-ul cere numele câmpurilor structurii: Key și Value.
2Mai multe tag-uri despărțite prin virgulă
aws ec2 create-tags --resources $ID --tags Key=Echipa,Value=web,Key=Mediu,Value=productieaws ec2 create-tags --resources $ID --tags Key=Echipa,Value=web Key=Mediu,Value=productieElementele listei se separă prin spațiu; virgulele separă câmpurile aceluiași element.
3Câmp scris cu literă mică
aws ec2 create-tags --resources $ID --tags key=Echipa,value=webaws ec2 create-tags --resources $ID --tags Key=Echipa,Value=webNumele câmpurilor sunt case-sensitive: Key, nu key.
Repară eroarea, direct în pagină
Instanța EC2 cu tag-ul Name=web trebuie să primească tag-urile Echipa=web și Mediu=productie. Comanda aws ec2 create-tags --resources <ID> --tags Echipa=web Mediu=productie dă Parameter validation failed. Adaugă cele două tag-uri cu sintaxa corectă.
Indiciu
Fiecare tag: Key=...,Value=...; tag-urile se separă prin spațiu. ID-ul îl afli cu describe-instances și filtrul tag:Name.
Reparația
Află ID-ul instanței și adaugă tag-urile în forma Key=...,Value=...:
ID=$(aws ec2 describe-instances --filters Name=tag:Name,Values=web --query 'Reservations[0].Instances[0].InstanceId' --output text)
aws ec2 create-tags --resources $ID --tags Key=Echipa,Value=web Key=Mediu,Value=productie
aws ec2 describe-tags --filters Name=resource-id,Values=$IDDe ce merge
La EC2, --tags este o listă de structuri cu câmpurile Key și Value. Echipa=web cerea un câmp inexistent Echipa, deci CLI-ul a refuzat comanda înainte să ajungă la AWS. În forma Key=Echipa,Value=web Key=Mediu,Value=productie, fiecare element din listă are cele două câmpuri, iar create-tags le adaugă pe ambele, fără să le atingă pe cele existente (Name=web rămâne).
Alte forme ale mesajului
Parameter validation failed: Missing required parameter in Tags[0]: "Key"Parameter validation failed: Unknown parameter in Filters[0]: "name", must be one of: Name, ValuesParameter validation failed: Invalid type for parameter MaxCount, value: abc, type: <class 'str'>, valid types: <class 'int'>
Cum o eviți pe viitor
- Pentru structuri complicate folosește JSON:
--tags '[{"Key":"Echipa","Value":"web"}]'. aws ec2 create-tags helparată sintaxa shorthand exactă a fiecărui parametru.- Atenție: unele servicii au alte formate (
aws lambda tag-resource --tags Echipa=webe o hartă, nu o listă). Verifică în help pentru serviciul respectiv.
Întrebări frecvente
De ce la Lambda merge --tags Echipa=web, iar la EC2 nu?
La Lambda Tags este o hartă (cheie → valoare), deci shorthand-ul e Echipa=web. La EC2 Tags este o listă de structuri {Key, Value}. Formatul depinde de modelul API-ului fiecărui serviciu.
Pot pune tag-urile direct la run-instances?
Da, cu --tag-specifications 'ResourceType=instance,Tags=[{Key=Name,Value=web}]'. E mai bine așa: instanța are tag-urile din prima secundă.
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. An error occurred (InvalidInstanceID.NotFound) when calling the StopInstances operation: The instance ID 'i-0123456789abcdef0' does not exist EC2 nu găsește instanța cu acest ID în regiunea în care ai trimis cererea. De obicei instanța e în altă regiune decât cea din profil, ID-ul e copiat greșit sau instanța a fost terminată de mult. Adaugă --region cu regiunea instanței sau verifică ID-ul cu describe-instances. Î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.
