...
Eroare AWS · API Gateway și SNS

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

Pe scurt

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 exemplu GET /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

Greșit
BASH
aws apigatewayv2 create-route --api-id $API --route-key '/produse' --target integrations/$INT
Corect
BASH
aws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' --target integrations/$INT

Cheia are nevoie de metodă și cale.

2Metoda cu litere mici

Greșit
BASH
--route-key 'get /produse'
Corect
BASH
--route-key 'GET /produse'

Metodele HTTP se scriu cu majuscule în cheia rutei.

3$default între ghilimele duble

Greșit
BASH
--route-key "$default"
Corect
BASH
--route-key '$default'

Între ghilimele duble, shell-ul înlocuiește $default cu o variabilă (goală).

Repară tu

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

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 -i după creare.
  • Ruta $default e 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

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