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

An error occurred (InvalidParameterValue) when calling the RunInstances operation: Value (rol-web) for parameter iamInstanceProfile.name is invalid. Invalid IAM Instance Profile name

Pe scurt

La --iam-instance-profile ai dat un nume de instance profile care nu există, de obicei numele rolului. Un rol creat din CLI nu are automat instance profile: creează-l cu aws iam create-instance-profile, adaugă rolul cu add-role-to-instance-profile, apoi pornește instanța.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O instanță EC2 nu primește un rol direct, ci printr-un instance profile: un „container” care ține un rol și pe care EC2 îl atașează instanței. Aplicațiile din instanță primesc apoi credențiale temporare ale rolului.

Când creezi rolul din consolă (cu tipul EC2), consola creează și un instance profile cu același nume. Din CLI, create-role creează doar rolul. Dacă apoi dai --iam-instance-profile Name=rol-web, EC2 caută un instance profile cu acest nume, nu-l găsește și răspunde cu mesajul de mai sus.

Mesajul poate apărea și imediat după crearea profilului, pentru că IAM are nevoie de câteva secunde să-l propage: în acest caz, încearcă din nou după 10–15 secunde.

De ce apare: cauzele frecvente

1Rolul există, instance profile-ul nu

Greșit
BASH
aws iam create-role --role-name rol-web --assume-role-policy-document file://trust-ec2.json
aws ec2 run-instances ... --iam-instance-profile Name=rol-web
Corect
BASH
aws iam create-instance-profile --instance-profile-name rol-web
aws iam add-role-to-instance-profile --instance-profile-name rol-web --role-name rol-web
aws ec2 run-instances ... --iam-instance-profile Name=rol-web

Instance profile-ul este cel pe care îl caută EC2; rolul trebuie pus în el.

2Numele profilului diferă de al rolului

Greșit
BASH
aws ec2 run-instances ... --iam-instance-profile Name=rol-web
Corect
BASH
aws iam list-instance-profiles-for-role --role-name rol-web \
  --query 'InstanceProfiles[].InstanceProfileName'
aws ec2 run-instances ... --iam-instance-profile Name=profil-web

Dacă profilul are alt nume decât rolul, dai numele profilului.

3Profil creat chiar acum

Greșit
BASH
aws iam create-instance-profile --instance-profile-name rol-web
aws iam add-role-to-instance-profile --instance-profile-name rol-web --role-name rol-web
aws ec2 run-instances ... --iam-instance-profile Name=rol-web
Corect
BASH
aws iam wait instance-profile-exists --instance-profile-name rol-web
sleep 10
aws ec2 run-instances ... --iam-instance-profile Name=rol-web

În AWS real, profilul nou poate să nu fie încă vizibil pentru EC2 câteva secunde.

Repară tu

Repară eroarea, direct în pagină

Serverul web trebuie să citească din S3 prin rolul rol-web (are deja AmazonS3ReadOnlyAccess), fără chei de acces. Scriptul ~/server.sh dă Invalid IAM Instance Profile name. Repară scriptul ca, înainte de pornire, să creeze instance profile-ul rol-web cu rolul rol-web în el, apoi rulează-l.

Indiciu

aws iam create-instance-profile --instance-profile-name rol-web și aws iam add-role-to-instance-profile --instance-profile-name rol-web --role-name rol-web.

Alte forme ale mesajului

  • An error occurred (InvalidParameterValue) when calling the AssociateIamInstanceProfile operation: Value (rol-web) for parameter iamInstanceProfile.name is invalid. Invalid IAM Instance Profile name
  • An error occurred (InvalidParameterValue) when calling the RunInstances operation: Value (arn:aws:iam::123456789012:instance-profile/rol-web) for parameter iamInstanceProfile.arn is invalid. Invalid IAM Instance Profile ARN

Cum o eviți pe viitor

  • În scripturi, după create-role pentru EC2 scrie mereu și create-instance-profile + add-role-to-instance-profile.
  • Dă profilului același nume ca rolului, ca să nu le încurci.
  • Verifică înainte de pornire: aws iam get-instance-profile --instance-profile-name rol-web.

Întrebări frecvente

Câte roluri poate avea un instance profile?

Unul singur. Al doilea add-role-to-instance-profile dă LimitExceeded ... InstanceSessionsPerInstanceProfile: 1.

Pot pune rolul pe o instanță care rulează deja?

Da: aws ec2 associate-iam-instance-profile --instance-id $ID --iam-instance-profile Name=rol-web. Dacă instanța are deja un profil, folosești replace-iam-instance-profile-association.

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.