An error occurred (NotFoundException) when calling the CreateStage operation: Invalid API identifier specified 123456789012:magazin-api
La --api-id ai dat altceva decât ID-ul API-ului, de obicei numele lui (magazin-api) sau un ID din altă regiune. ID-ul are 10 caractere, de exemplu a1b2c3d4e5. Îl afli cu aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Comenzile apigatewayv2 (create-route, create-stage, create-integration, get-api...) identifică API-ul prin ApiId, un cod scurt generat de AWS (10 litere și cifre), nu prin nume. Mesajul arată valoarea căutată, cu ID-ul contului în față: 123456789012:magazin-api. Dacă după două puncte vezi numele API-ului, ai dat numele în loc de ID.
Alte cauze: API-ul e în altă regiune (ID-urile sunt regionale), a fost șters și recreat (ID nou), sau variabila $API din script e goală ori a rămas de la alt API.
Tot ID-ul apare în adresa API-ului: https://<ApiId>.execute-api.eu-central-1.amazonaws.com. Pentru API-urile REST (comanda apigateway, fără v2), mesajul are altă formă, dar aceeași cauză.
De ce apare: cauzele frecvente
1Numele API-ului în loc de ID
aws apigatewayv2 create-stage --api-id magazin-api --stage-name prodAPI=$(aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text)
aws apigatewayv2 create-stage --api-id $API --stage-name prodget-apis întoarce ID-ul API-ului după nume.
2API-ul e în altă regiune
aws apigatewayv2 get-api --api-id a1b2c3d4e5
# API-ul a fost creat în eu-west-1aws apigatewayv2 get-api --api-id a1b2c3d4e5 --region eu-west-1Același ID nu există în altă regiune.
Repară eroarea, direct în pagină
API-ul magazin-api are deja ruta GET /salut și stage-ul $default. Scriptul ~/stage.sh trebuie să-i adauge stage-ul prod cu auto-deploy, dar dă Invalid API identifier specified 123456789012:magazin-api. Repară scriptul ca să folosească ID-ul API-ului și rulează-l.
Indiciu
API=$(aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text), apoi --api-id $API.
Reparația
Află ID-ul API-ului și folosește-l:
cat > ~/stage.sh <<'EOF'
API=$(aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text)
aws apigatewayv2 create-stage --api-id $API --stage-name prod --auto-deploy
EOF
bash ~/stage.shDe ce merge
--api-id așteaptă ID-ul generat de AWS, iar „magazin-api” este doar numele, deci API Gateway n-a găsit niciun API cu acest identificator. Scriptul citește acum ID-ul după nume cu get-apis și îl dă la create-stage, iar magazin-api primește stage-ul prod, disponibil la adresa .../prod/salut.
Alte forme ale mesajului
An error occurred (NotFoundException) when calling the GetApi operation: Invalid API identifier specified 123456789012:abc123An error occurred (NotFoundException) when calling the CreateRoute operation: Invalid API identifier specified 123456789012:magazin-apiAn error occurred (NotFoundException) when calling the GetRestApi operation: Invalid API identifier specified 123456789012:magazin-api
Cum o eviți pe viitor
- Salvează ID-ul la creare:
API=$(aws apigatewayv2 create-api ... --query ApiId --output text). - În scripturi separate, citește-l după nume cu
get-apisși verifică să nu fie gol. - Dă API-urilor nume unice în regiune, ca
get-apissă întoarcă un singur ID.
Întrebări frecvente
Pot avea două API-uri cu același nume?
Da, numele nu trebuie să fie unic, de aceea comenzile cer ID-ul. Cu nume duplicate, get-apis filtrat după nume întoarce mai multe ID-uri; evită situația.
Unde văd ID-ul în consolă?
În API Gateway → APIs, coloana ID, și în adresa de invocare a API-ului.
Erori înrudite
{"message":"Not Found"} Nicio rută a API-ului nu se potrivește cu metoda și calea cererii. Verifică cu aws apigatewayv2 get-routes cheile exacte (de exemplu "GET /salut"): calea e sensibilă la majuscule, iar metoda trebuie să fie aceeași. Corectează ruta sau adresa cererii. An error occurred (ResourceNotFoundException) when calling the Invoke operation: Function not found: arn:aws:lambda:eu-central-1:123456789012:function:salut Nu există o funcție Lambda cu acest nume în regiunea și contul din ARN-ul afișat. Cel mai des funcția e în altă regiune sau numele e scris altfel. Verifică cu aws lambda list-functions --region <regiune> și invocă funcția cu numele și regiunea corecte. 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.
