...
Eroare AWS · API Gateway și SNS

An error occurred (NotFoundException) when calling the CreateStage operation: Invalid API identifier specified 123456789012:magazin-api

Pe scurt

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

Greșit
BASH
aws apigatewayv2 create-stage --api-id magazin-api --stage-name prod
Corect
BASH
API=$(aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text)
aws apigatewayv2 create-stage --api-id $API --stage-name prod

get-apis întoarce ID-ul API-ului după nume.

2API-ul e în altă regiune

Greșit
BASH
aws apigatewayv2 get-api --api-id a1b2c3d4e5
# API-ul a fost creat în eu-west-1
Corect
BASH
aws apigatewayv2 get-api --api-id a1b2c3d4e5 --region eu-west-1

Același ID nu există în altă regiune.

Repară tu

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.

Alte forme ale mesajului

  • An error occurred (NotFoundException) when calling the GetApi operation: Invalid API identifier specified 123456789012:abc123
  • An error occurred (NotFoundException) when calling the CreateRoute operation: Invalid API identifier specified 123456789012:magazin-api
  • An 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-apis să î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

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