An error occurred (BadRequestException) when calling the CreateRoute operation: Unable to create route /produse. The route key must be '$default' or a valid HTTP method and path, for example 'GET /pets'.
Cheia rutei trebuie să fie metoda HTTP cu majuscule, un spațiu și calea care începe cu /: 'GET /produse'. Sau $default pentru toate cererile. Lipsa metodei, metoda cu litere mici ori lipsa spațiului dau această eroare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La un API HTTP din API Gateway, --route-key are o formă fixă:
METODA /cale, de exempluGET /produse,POST /comenzi,ANY /admin;- căi cu parametri:
GET /produse/{id}, sau{proxy+}pentru tot ce urmează; $default, ruta care prinde orice cerere fără altă potrivire.
Metoda se scrie cu majuscule (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS, ANY), urmată de un spațiu și de calea care începe cu /. Greșeli tipice: doar calea (/produse), metoda cu litere mici (get /produse), lipsa spațiului (GET/produse).
În terminal, cheia trebuie pusă între ghilimele, pentru că are un spațiu, iar $default între ghilimele simple, altfel shell-ul înlocuiește $default cu o variabilă goală.
De ce apare: cauzele frecvente
1Lipsește metoda
aws apigatewayv2 create-route --api-id $API --route-key '/produse' --target integrations/$INTaws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' --target integrations/$INTCheia are nevoie de metodă și cale.
2Metoda cu litere mici
--route-key 'get /produse'--route-key 'GET /produse'Metodele HTTP se scriu cu majuscule în cheia rutei.
3$default între ghilimele duble
--route-key "$default"--route-key '$default'Între ghilimele duble, shell-ul înlocuiește $default cu o variabilă (goală).
Repară eroarea, direct în pagină
Scriptul ~/ruta.sh trebuie să adauge în magazin-api ruta care trimite cererile GET de pe /produse la funcția produse, dar dă The route key must be '$default' or a valid HTTP method and path. Repară cheia rutei și rulează scriptul.
Indiciu
Cheia corectă este 'GET /produse' (metoda cu majuscule, un spațiu, apoi calea).
Reparația
Scrie metoda în cheia rutei:
cat > ~/ruta.sh <<'EOF'
API=$(aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text)
INT=$(aws apigatewayv2 get-integrations --api-id $API --query 'Items[0].IntegrationId' --output text)
aws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' --target integrations/$INT
EOF
bash ~/ruta.shDe ce merge
Cheia rutei unui API HTTP are forma METODA /cale. /produse nu spunea metoda, așa că API Gateway a refuzat-o. Cu 'GET /produse', ruta se creează și trimite cererile GET de pe /produse la integrarea cu funcția produse. Stage-ul $default publică ruta imediat.
Alte forme ale mesajului
An error occurred (BadRequestException) when calling the CreateRoute operation: Unable to create route get /produse. The route key must be '$default' or a valid HTTP method and path, for example 'GET /pets'.
Cum o eviți pe viitor
- Scrie cheile de rută în formatul
METODA /caleși pune-le între ghilimele simple. - Pentru un API cu multe rute, ține-le într-o listă în script și creează-le într-o buclă.
- Testează fiecare rută cu
curl -idupă creare. - Ruta
$defaulte utilă ca rezervă, dar nu înlocuiește rutele explicite.
Întrebări frecvente
Ce prinde ruta ANY /produse?
Orice metodă (GET, POST, PUT...) pe calea /produse. Funcția primește metoda în eveniment și decide ce face.
E la fel la API-urile REST (v1)?
Nu. API-urile REST definesc resursele și metodele separat (create-resource, put-method). Cheia METODA /cale e specifică API-urilor HTTP (apigatewayv2).
Erori înrudite
An error occurred (ConflictException) when calling the CreateRoute operation: Route with key GET /produse already exists for this API API-ul are deja o rută cu aceeași metodă și cale. Nu o crea din nou: ia-i RouteId-ul cu aws apigatewayv2 get-routes și schimb-o cu update-route (de exemplu --target integrations/<id>), sau șterge ruta veche înainte. {"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 (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. Î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.
