...
Eroare AWS · EC2: AMI, chei, security groups și SSH

An error occurred (ParameterNotFound) when calling the GetParameter operation:

Pe scurt

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ă

Greșit
BASH
aws ssm get-parameter \
  --name /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86
Corect
BASH
aws ssm get-parameter \
  --name /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64

Numele trebuie să fie exact, până la ultimul caracter.

2Parametrul tău e în altă regiune

Greșit
BASH
aws ssm get-parameter --name /magazin/prod/db-host
# parametrul a fost creat în eu-west-1
Corect
BASH
aws ssm get-parameter --name /magazin/prod/db-host --region eu-west-1

Parametrii din Parameter Store sunt regionali.

3Nu știi exact numele

Greșit
BASH
aws ssm get-parameter --name /aws/service/ami-amazon-linux-latest/al2023
Corect
BASH
aws 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ă tu

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.

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

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