...
Eroare AWS · API Gateway și SNS

An error occurred (ConflictException) when calling the CreateRoute operation: Route with key GET /produse already exists for this API

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Într-un API HTTP, o rută e identificată de route key: metoda plus calea (GET /produse). Două rute cu aceeași cheie nu pot exista, deci create-route cu o cheie existentă dă ConflictException.

Apare des în două situații:

  • ai creat ruta fără --target (sau cu integrarea greșită) și încerci s-o „repari” creând-o din nou;
  • scriptul de configurare rulează a doua oară.

Repararea se face pe ruta existentă: aws apigatewayv2 get-routes --api-id $API îți dă RouteId, iar update-route --route-id ... --target integrations/$INT schimbă destinația, păstrând ruta. O rută fără target răspunde cu {"message":"Not Found"} sau cu eroare, pentru că API Gateway nu are unde să trimită cererea. Cu stage-ul $default și --auto-deploy, schimbarea intră în vigoare imediat.

De ce apare: cauzele frecvente

1Ruta există, dar fără integrare

Greșit
BASH
aws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' \
  --target integrations/$INT
Corect
BASH
RUTA=$(aws apigatewayv2 get-routes --api-id $API \
  --query "Items[?RouteKey=='GET /produse'].RouteId" --output text)
aws apigatewayv2 update-route --api-id $API --route-id $RUTA --target integrations/$INT

Actualizezi ruta existentă în loc să creezi alta cu aceeași cheie.

2Scriptul de configurare rulat a doua oară

Greșit
BASH
aws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' --target integrations/$INT
Corect
BASH
N=$(aws apigatewayv2 get-routes --api-id $API --query "length(Items[?RouteKey=='GET /produse'])")
[ "$N" = "0" ] && aws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' --target integrations/$INT

Ruta se creează doar dacă lipsește.

Repară tu

Repară eroarea, direct în pagină

Ruta GET /produse din magazin-api a fost creată fără integrare, așa că API-ul nu răspunde. Scriptul ~/ruta.sh încearcă s-o creeze din nou, cu integrarea spre funcția produse, și dă ConflictException. Repară scriptul ca să actualizeze ruta existentă și rulează-l.

Indiciu

Ia RouteId cu get-routes --query "Items[?RouteKey=='GET /produse'].RouteId" și rulează update-route --route-id $RUTA --target integrations/$INT.

Alte forme ale mesajului

  • An error occurred (ConflictException) when calling the CreateStage operation: Stage already exists

Cum o eviți pe viitor

  • Dă --target chiar la create-route, ca ruta să fie completă din prima.
  • În scripturi, verifică ruta cu get-routes înainte să o creezi.
  • După schimbare, testează cu curl URL-ul API-ului.
  • Ține lista rutelor într-un fișier și compar-o cu get-routes după fiecare schimbare.

Întrebări frecvente

GET /produse și POST /produse se ciocnesc?

Nu. Metoda face parte din cheie, deci sunt rute diferite. Conflictul apare doar pentru aceeași metodă și aceeași cale.

Trebuie să redeploiez API-ul după update-route?

Nu, dacă stage-ul are --auto-deploy (stage-ul $default creat de obicei așa). Altfel, creezi un deployment nou cu create-deployment.

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.