...
Eroare AWS · Sintaxa comenzilor AWS CLI

Parameter validation failed: Unknown parameter in Tags[0]: "Echipa", must be one of: Key, Value

Pe scurt

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

Greșit
BASH
aws ec2 create-tags --resources $ID --tags Echipa=web
Corect
BASH
aws ec2 create-tags --resources $ID --tags Key=Echipa,Value=web

Shorthand-ul cere numele câmpurilor structurii: Key și Value.

2Mai multe tag-uri despărțite prin virgulă

Greșit
BASH
aws ec2 create-tags --resources $ID --tags Key=Echipa,Value=web,Key=Mediu,Value=productie
Corect
BASH
aws ec2 create-tags --resources $ID --tags Key=Echipa,Value=web Key=Mediu,Value=productie

Elementele listei se separă prin spațiu; virgulele separă câmpurile aceluiași element.

3Câmp scris cu literă mică

Greșit
BASH
aws ec2 create-tags --resources $ID --tags key=Echipa,value=web
Corect
BASH
aws ec2 create-tags --resources $ID --tags Key=Echipa,Value=web

Numele câmpurilor sunt case-sensitive: Key, nu key.

Repară tu

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.

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, Values
  • Parameter 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 help arată sintaxa shorthand exactă a fiecărui parametru.
  • Atenție: unele servicii au alte formate (aws lambda tag-resource --tags Echipa=web e 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

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