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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Aproape toate serviciile AWS sunt regionale: o instanță EC2 din Frankfurt (eu-central-1) nu se vede din Irlanda (eu-west-1). Ca să trimită cererea, CLI-ul trebuie să construiască adresa endpoint-ului, de exemplu ec2.eu-central-1.amazonaws.com, deci are nevoie de regiune.
Regiunea se ia, în ordine, din --region, din variabilele AWS_REGION / AWS_DEFAULT_REGION și din region din profilul curent în ~/.aws/config. Dacă nu găsește nimic, CLI-ul se oprește cu acest mesaj și codul 253, fără să contacteze AWS.
Apare de obicei când ai sărit peste întrebarea Default region name la aws configure, când folosești un profil nou creat doar cu chei, sau într-un container ori job CI unde nu există ~/.aws/config. Câteva comenzi globale (aws sts get-caller-identity, aws iam ..., aws s3 ls) merg și fără regiune, de aceea problema apare abia la prima comandă EC2 sau Lambda.
De ce apare: cauzele frecvente
1Profilul nu are regiune
cat ~/.aws/config
# [default]
# output = json
aws ec2 describe-instancesaws configure set region eu-central-1
aws ec2 describe-instancesFără region în profil, CLI-ul nu poate alege endpoint-ul. Setată o dată, regiunea rămâne în ~/.aws/config.
2Profil nou configurat doar cu chei
aws configure set aws_access_key_id AKIA... --profile test
aws configure set aws_secret_access_key ... --profile test
aws lambda list-functions --profile testaws configure set region eu-central-1 --profile test
aws lambda list-functions --profile testFiecare profil are setările lui; regiunea din default nu se moștenește.
3Container sau CI fără configurare
docker run --rm -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY amazon/aws-cli ec2 describe-instancesdocker run --rm -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_REGION=eu-central-1 amazon/aws-cli ec2 describe-instancesÎn medii fără ~/.aws/config regiunea vine din variabila AWS_REGION (sau --region).
Repară eroarea, direct în pagină
Pe calculatorul tău, aws ec2 describe-instances dă You must specify a region. Setează permanent regiunea implicită eu-central-1 (nu doar cu --region la o comandă), apoi salvează în ~/zone.txt numele zonelor de disponibilitate ale regiunii (aws ec2 describe-availability-zones, doar câmpul ZoneName, în format text).
Indiciu
aws configure set region eu-central-1 scrie regiunea în ~/.aws/config; pentru zone: --query 'AvailabilityZones[].ZoneName' --output text.
Reparația
Setează regiunea în profilul implicit:
aws configure set region eu-central-1
aws configure get regionAcum comenzile EC2 merg fără --region:
aws ec2 describe-availability-zones --query 'AvailabilityZones[].ZoneName' --output text > ~/zone.txt
cat ~/zone.txtDe ce merge
Profilul default avea în ~/.aws/config doar formatul de ieșire, fără region, iar EC2 e un serviciu regional: CLI-ul nu știa ce endpoint să folosească. aws configure set region eu-central-1 adaugă linia region = eu-central-1 în profil, așa că de acum orice comandă fără --region merge în Frankfurt. describe-availability-zones confirmă: zonele listate sunt eu-central-1a, b și c.
Alte forme ale mesajului
botocore.exceptions.NoRegionError: You must specify a region.MissingRegion: could not find region configuration
Cum o eviți pe viitor
- La
aws configurecompletează mereuDefault region name(de exemplueu-central-1). - Pentru fiecare profil nou setează și regiunea:
aws configure set region ... --profile nume. - În scripturi poți fixa explicit
--region, ca să nu depinzi de configurarea calculatorului. aws configure listîți arată regiunea activă și de unde vine.
Întrebări frecvente
De ce aws s3 ls merge, iar aws ec2 describe-instances nu?
Lista de bucket-uri și STS au endpoint-uri globale, deci CLI-ul nu are nevoie de regiune pentru ele. EC2 e regional, așa că fără regiune comanda nu poate pleca.
Ce regiune aleg?
Una apropiată de utilizatori și care are serviciile de care ai nevoie. Pentru România se folosesc des eu-central-1 (Frankfurt) și eu-south-2 sau eu-west-1. Important e să folosești aceeași regiune peste tot, altfel nu-ți vezi resursele.
Erori înrudite
Unable to locate credentials. You can configure credentials by running "aws configure". AWS CLI nu a găsit nicio cheie de acces pentru profilul cu care rulezi comanda, deci nu poate semna cererea. Rulează aws configure (sau aws configure --profile nume) și introdu Access Key ID și Secret Access Key, apoi verifică cu aws sts get-caller-identity. The config profile (prod) could not be found Ai cerut un profil (cu --profile sau AWS_PROFILE) care nu există în ~/.aws/config sau ~/.aws/credentials. Verifică lista cu aws configure list-profiles și fie folosește numele corect, fie creează profilul cu aws configure --profile prod. 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.
