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.
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
aws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' \
--target integrations/$INTRUTA=$(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/$INTActualizezi ruta existentă în loc să creezi alta cu aceeași cheie.
2Scriptul de configurare rulat a doua oară
aws apigatewayv2 create-route --api-id $API --route-key 'GET /produse' --target integrations/$INTN=$(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/$INTRuta se creează doar dacă lipsește.
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.
Reparația
Actualizează ruta existentă:
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)
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
EOF
bash ~/ruta.shDe ce merge
Cheia GET /produse exista deja, iar un API nu poate avea două rute cu aceeași cheie. update-route modifică ruta existentă și îi pune ca destinație integrarea cu funcția produse, deci API-ul răspunde, iar ruta rămâne una singură. Stage-ul $default are auto-deploy, deci schimbarea e live imediat.
Alte forme ale mesajului
An error occurred (ConflictException) when calling the CreateStage operation: Stage already exists
Cum o eviți pe viitor
- Dă
--targetchiar lacreate-route, ca ruta să fie completă din prima. - În scripturi, verifică ruta cu
get-routesînainte să o creezi. - După schimbare, testează cu
curlURL-ul API-ului. - Ține lista rutelor într-un fișier și compar-o cu
get-routesdupă 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
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. {"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. {"message":"Internal Server Error"} API Gateway n-a putut obține un răspuns valid de la funcția Lambda: de obicei îi lipsește permisiunea să apeleze funcția, funcția a aruncat o eroare sau a întors un răspuns în format greșit. Verifică întâi permisiunea (aws lambda get-policy), apoi logurile funcției. Î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.
