An error occurred (ParameterNotFound) when calling the GetParameter operation:
Parametrul cerut din SSM Parameter Store nu există în regiunea curentă: numele e scris greșit sau parametrul e în altă regiune. Pentru AMI-ul Amazon Linux 2023, calea completă este /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
aws ssm get-parameter citește o valoare din Parameter Store. AWS publică acolo parametri publici, de exemplu ID-ul celui mai nou AMI Amazon Linux din fiecare regiune, ca să nu scrii ID-uri fixe (ami-...) care se schimbă la fiecare versiune.
ParameterNotFound înseamnă că nu există niciun parametru cu exact acest nume în regiunea curentă. Mesajul are după operation: un text gol, deci nu spune ce nume ai cerut: caută-l chiar în comanda ta. Cauzele: o literă lipsă din cale (x86 în loc de x86_64), altă regiune, un parametru propriu care nu a fost creat sau o cale de AMI veche.
Într-un script, eroarea lasă variabila goală (AMI=), iar comanda următoare dă altă eroare, de exemplu la run-instances. De aceea uită-te la prima eroare din ieșire, nu la ultima.
De ce apare: cauzele frecvente
1Calea parametrului e incompletă
aws ssm get-parameter \
--name /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86aws ssm get-parameter \
--name /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64Numele trebuie să fie exact, până la ultimul caracter.
2Parametrul tău e în altă regiune
aws ssm get-parameter --name /magazin/prod/db-host
# parametrul a fost creat în eu-west-1aws ssm get-parameter --name /magazin/prod/db-host --region eu-west-1Parametrii din Parameter Store sunt regionali.
3Nu știi exact numele
aws ssm get-parameter --name /aws/service/ami-amazon-linux-latest/al2023aws ssm get-parameters-by-path --path /aws/service/ami-amazon-linux-latest \
--query 'Parameters[].Name'Listează parametrii de sub cale și copiază numele exact.
Repară eroarea, direct în pagină
Scriptul ~/server.sh caută ultimul AMI Amazon Linux 2023 în Parameter Store, apoi pornește serverul web. Dă ParameterNotFound, pentru că numele parametrului e scris greșit. Repară numele (AMI-ul x86_64, kernel implicit) și rulează scriptul.
Indiciu
Numele complet: /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64.
Reparația
Folosește numele complet al parametrului:
cat > ~/server.sh <<'EOF'
set -e
AMI=$(aws ssm get-parameter --name /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64 --query Parameter.Value --output text)
ID=$(aws ec2 run-instances --image-id $AMI --instance-type t3.micro --tag-specifications 'ResourceType=instance,Tags=[{Key=Name,Value=web}]' --query 'Instances[0].InstanceId' --output text)
aws ec2 wait instance-running --instance-ids $ID
EOF
bash ~/server.shDe ce merge
Parameter Store caută numele exact, iar ...-x86 nu există, așa că get-parameter a eșuat și scriptul s-a oprit (set -e) înainte de run-instances. Cu sufixul x86_64, comanda întoarce ID-ul celui mai nou AMI Amazon Linux 2023 din Frankfurt, iar serverul web pornește din el.
Alte forme ale mesajului
An error occurred (ParameterNotFound) when calling the GetParameter operation: Parameter /magazin/prod/db-host not found.An error occurred (ValidationException) when calling the GetParameters operation: Invalid parameter name. Please use correct syntax for referencing a version/label <name>:<version/label>
Cum o eviți pe viitor
- Copiază căile parametrilor publici din documentație sau din
get-parameters-by-path. - Pune
set -eîn scripturi și verifică variabila:[ -n "$AMI" ] || exit 1. - Pentru parametrii tăi, folosește o schemă clară (
/aplicatie/mediu/nume) și creează-i în aceeași regiune ca resursele.
Întrebări frecvente
De ce mesajul nu spune ce parametru lipsește?
La parametrii publici AWS, răspunsul ParameterNotFound vine fără text. Numele căutat este cel din comanda ta, deci verifică-l acolo.
Costă citirea parametrilor publici?
Nu. Parametrii standard (inclusiv cei publici AWS) se citesc gratuit, în limita de cereri pe secundă.
Erori înrudite
An error occurred (InvalidAMIID.NotFound) when calling the RunInstances operation: The image id '[ami-0abcdef1234567890]' does not exist ID-ul AMI din comandă nu există în regiunea în care lansezi: AMI-urile sunt regionale, iar ID-urile copiate din tutoriale sunt de obicei din altă regiune sau vechi. Ia ID-ul curent din SSM (/aws/service/ami-amazon-linux-latest/...) sau cu describe-images, în regiunea ta. An error occurred (DryRunOperation) when calling the RunInstances operation: Request would have succeeded, but DryRun flag is set. Nu e o eroare reală: comanda are --dry-run, deci EC2 doar a verificat că ai permisiunile și că parametrii sunt corecți, fără să creeze nimic. Scoate --dry-run ca să pornești de fapt instanța. You must specify a region. You can also configure your region by running "aws configure". Comanda e pentru un serviciu regional (EC2, Lambda, RDS...), dar profilul nu are nicio regiune setată, așa că CLI-ul nu știe unde să trimită cererea. Setează-o o dată cu aws configure set region eu-central-1 sau adaugă --region eu-central-1 la comandă. Î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.
