...
Eroare AWS · Credențiale, profiluri și regiuni

You must specify a region. You can also configure your region by running "aws configure".

Pe scurt

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

Greșit
BASH
cat ~/.aws/config
# [default]
# output = json
aws ec2 describe-instances
Corect
BASH
aws configure set region eu-central-1
aws ec2 describe-instances

Fă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

Greșit
BASH
aws configure set aws_access_key_id AKIA... --profile test
aws configure set aws_secret_access_key ... --profile test
aws lambda list-functions --profile test
Corect
BASH
aws configure set region eu-central-1 --profile test
aws lambda list-functions --profile test

Fiecare profil are setările lui; regiunea din default nu se moștenește.

3Container sau CI fără configurare

Greșit
BASH
docker run --rm -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY amazon/aws-cli ec2 describe-instances
Corect
BASH
docker 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ă tu

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.

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 configure completează mereu Default region name (de exemplu eu-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

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