Tous les produits
Search
Centre de documentation

API Gateway:Codes d'erreur pour les instances API Gateway de type VPC

Dernière mise à jour :Aug 09, 2026

Répertorie les codes d'erreur que peuvent renvoyer les instances API Gateway de type Virtual Private Cloud (VPC).

Ces codes d'erreur s'appliquent aux serverless instances et aux dedicated instances de type VPC.

  • Si l'en-tête X-Ca-Error-Code d'une réponse n'est pas vide, le code d'erreur est généré par API Gateway. Chaque code d'erreur est une chaîne de six caractères. Le tableau suivant répertorie tous les codes d'erreur susceptibles d'être renvoyés par API Gateway. Pour obtenir des messages d'erreur détaillés, consultez l'en-tête X-Ca-Error-Message.

  • Si l'en-tête X-Ca-Error-Code est vide, le code d'état HTTP provient du service backend. API Gateway transmet les informations d'erreur provenant du service backend.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Message

Description

I400HD

400

Invalid Header ${HeaderName} ${Reason}

L'en-tête de la requête HTTP n'est pas valide.

I400MH

400

Header ${HeaderName} is Required

L'en-tête de la requête HTTP est manquant.

I400BD

400

Invalid Body: ${Reason}

Le corps de la requête HTTP n'est pas valide.

I400PA

400

Invalid Request Path ${Reason}

Le chemin de la requête HTTP n'est pas valide.

I405UM

405

Unsupported Method ${Reason}

La méthode de requête HTTP n'est pas prise en charge.

I400RU

400

Invalid Request Uri ${Reason}

L'URL de la requête HTTP n'est pas valide.

I403PT

403

Invalid protocol ${Protocol} unsupported

Le protocole n'est pas pris en charge selon la configuration de l'API. Vérifiez la configuration de l'API.

I413RL

413

Request body too Large

Le corps de la requête est trop volumineux. Pour plus d'informations, consultez la rubrique Limites.

I413UL

413

Request URL too Large

L'URL de la requête est trop longue. Pour plus d'informations, consultez la rubrique Limites.

I400CT

400

Invalid Content-Type: ${Reason}

La valeur Content-Type n'est pas valide.

I404DO

404

Invalid Domain ${DomainName}

Un nom de domaine inconnu est demandé. Utilisez un nom de domaine lié pour l'appel.

I410GG

410

Group's instance invalid

Une instance non valide est demandée. Il se peut que le groupe d'API n'appartienne pas à l'instance actuelle.

I400SG

400

Invalid Stage

Un environnement inconnu est demandé.

I404NF

404

API not found ${Reason}

L'API est introuvable dans l'environnement actuel en fonction des paramètres de chemin et de méthode de la requête. Pour plus d'informations, consultez la rubrique Que faire en cas d'erreur I404NF ?

X400PM

400

Invalid plugin meta ${PluginName} ${Reason}

Les métadonnées du plug-in ne sont pas valides.

X500ED

500

Expired api definition

Les métadonnées expirées des versions antérieures ne sont plus prises en charge par la nouvelle version d'API Gateway. Pour modifier les métadonnées d'une version antérieure, soumettez un ticket.

X500AM

500

Invalid Api Meta, try deploy again or contact us via ticket

Le format des métadonnées enregistrées n'est pas valide. Pour résoudre ce problème, soumettez un ticket.

X403DG

403

Bad Domain or Group: ${Reason}

Les données du groupe d'API ne sont pas valides.

B451DO

451

Unavailable Domain for Legal Reasons

Le nom de domaine ne respecte pas les exigences des lois ou réglementations pertinentes.

B451GO

451

Unavailable Group for Legal Reasons

Le groupe d'API ne respecte pas les exigences des lois ou réglementations pertinentes.

B403OD

403

Provider Account Overdue

Le fournisseur d'API a un paiement en retard. Si l'API a été achetée sur Alibaba Cloud Marketplace, contactez le fournisseur de services.

A401AC

401

Invalid AppCode ${Reason}

L'authentification AppCode est utilisée mais l'AppCode est introuvable. Vérifiez si l'application est autorisée et si l'AppCode est correct.

A400IK

400

Invalid AppKey

L'AppKey est introuvable lors de l'exécution d'une autorisation à l'aide d'une paire clé-secret.

A403IS

403

Invalid Signature, Server StringToSign:${StringToSign}

La signature côté client ne correspond pas à la signature côté serveur. Pour plus d'informations, consultez la rubrique A403IS.

A403EP

403

App authorization expired

L'autorisation a expiré. Accordez à nouveau les autorisations.

A403PR

403

Plugin Authorization Needed

Une autorisation de plug-in est requise.

A400MA

400

Need authorization, X-Ca-Key or Authorization: APPCODE ... is required

Une autorisation en mode AppCode ou à l'aide d'une paire clé-secret est requise.

I400I5

400

Invalid Content-MD5 ${Reason}

La valeur Content-MD5 n'est pas valide.

I400NC

400

X-Ca-Nonce is required

L'en-tête X-Ca-Nonce n'est pas fourni après avoir sélectionné Force Nonce Check (Anti Replay by X-Ca-Nonce).

S403NU

403

Nonce Used

Une attaque par rejeu est détectée. L'en-tête X-Ca-Nonce de la requête a déjà été utilisé.

S403TE

403

X-Ca-Timestamp is expired

L'horodatage fourni dans l'en-tête X-Ca-Timestamp a expiré. L'horodatage est valide pendant 15 minutes.

I400MP

400

Parameter ${ParameterName} is required

Un ou plusieurs paramètres requis dans la configuration de l'API sont vides.

I400IP

400

Invalid parameter ${ParameterName} ${Reason}

La valeur d'un paramètre dans la configuration de l'API n'est pas valide.

I400JR

400

JWT required

Les paramètres liés au JSON Web Token (JWT) sont introuvables.

S403JI

403

Claim jti is required when preventJtiReplay:true

Aucune revendication jti valide n'est incluse dans la requête lorsque le paramètre preventJtiReplay est défini sur true dans un plug-in d'authentification JWT.

A403SV

403

Claim jti in JWT is used

La revendication jti incluse dans la requête a déjà été utilisée lorsque le paramètre preventJtiReplay est défini sur true dans un plug-in d'authentification JWT.

I400JD

400

JWT Deserialize Failed: ${Token}

Le JWT de la requête ne peut pas être résolu.

A403JT

403

Invalid JWT: ${Reason}

Le JWT de la requête n'est pas valide.

A403JK

403

No matching JWK, ${kid} not found

Aucun JWK ne correspond au kid configuré dans le JWT de la requête.

A403JE

403

JWT is expired at ${Date}

Le JWT de la requête a expiré.

I400JP

400

Invalid JWT plugin config: ${JWT}

Le plug-in d'authentification JWT est incorrectement configuré.

A403OL

403

OAuth2 Login failed: ${Reason}

A403OU

403

OAuth2 Get User Info failed: ${Reason}

A401OT

401

Invalid OAuth2 Access Token

A401OM

401

OAuth2 Access Token is required

T429ID

429

Throttled by INNER DOMAIN Flow Control, ${Domain} is a test domain, only 1000 requests per day

La limite d'appels d'API est dépassée. Si vous utilisez le nom de domaine de second niveau par défaut, la limite est de 1 000 appels par jour pour les régions situées en Chine continentale et de 100 appels par jour pour les régions situées hors de Chine continentale.

T429IN

429

Throttled by INSTANCE Flow Control

La limitation de débit est déclenchée pour l'instance actuelle. Mettez à niveau la spécification de l'instance.

T429GR

429

Throttled by GROUP Flow Control

La limitation de débit est déclenchée pour le groupe d'API actuel. Mettez à niveau la spécification de l'instance.

T429PA

429

Throttled by API Flow Control

La stratégie de limitation de débit par défaut au niveau de l'API, définie dans le plug-in de limitation, est déclenchée.

T429PR

429

Throttled by PLUGIN Flow Control

La stratégie de limitation de débit spéciale, définie dans le plug-in de limitation, est déclenchée.

T429SR

429

Throttled by SERVER Flow Control

T429MR

429

Too Many Requests, throttle by ${Description}

A403IP

403

Access denied by IP Control Policy

L'accès est refusé par le plug-in de contrôle d'accès basé sur l'adresse IP.

A403IN

403

Access from internet is disabled ${Reason}

Les API et les groupes d'API ne peuvent pas être appelés via Internet. Vous pouvez les appeler via un réseau privé. Pour plus d'informations, consultez la rubrique Appels d'API basés sur VPC.

A403VN

403

Access from invalid VPC is disabled

L'accès via le VPC spécifié est refusé.

A403AC

403

Access Control Forbidden by ${RuleName}

L'accès est refusé par le plug-in de contrôle d'accès.

A403CO

403

Cross origin resource forbidden ${Domain}

L'accès est refusé par le plug-in de partage de ressources cross-origin (CORS).

I404CO

404

Cross origin resource not found ${Method} - ${Path}

La définition de l'API est introuvable en fonction du chemin de requête et de la méthode de requête vérifiés au préalable par le plug-in CORS.

I404CH

404

Content not cached, with Cache-Control:only-if-cached

I404NR

404

${Resource} not found

I404SR

404

Stage route missing: ${Reason}

B403MO

403

Api Market Subscription overdue

Le fournisseur d'API a un paiement en retard. Contactez le fournisseur de services.

B403MQ

403

Api Market Subscription quota exhausted

Le quota d'API achetées sur Alibaba Cloud Marketplace est épuisé. Renouvelez le quota.

B403ME

403

Api Market Subscription expired

L'abonnement à l'API a expiré. Créez un autre abonnement.

B403MI

403

Api Market Subscription invalid

Le service API abonné n'est pas valide.

D504RE

504

Backend domain ${Domain} resolve failed

La résolution du nom de domaine backend a échoué. Vérifiez le nom de domaine backend.

D504IL

504

Backend domain ${Domain} resolve to illegal address ${Address}

Le résultat de la résolution pour le nom de domaine du service backend n'est pas valide.

D504CO

504

Backend service connect failed ${Reason}

API Gateway n'a pas pu accéder au service backend. Dans ce cas, vous devez vérifier les paramètres du groupe de sécurité et du pare-feu ou l'état du serveur backend. Pour plus d'informations, consultez la rubrique Dépannage des erreurs D504CO.

504

Backend service connect failed Connection lease request time out

La connexion au service backend échoue en raison d'un pool de connexions sec. Mettez à niveau la spécification de l'instance.

D504CS

504

Backend http ssl connect failed ${Reason}

La connexion au service backend via HTTPS échoue. Vérifiez si le protocole configuré pour le service backend correspond au port.

D504TO

504

Backend service request timeout

La requête adressée au service backend a expiré. Augmentez le délai d'attente du backend ou améliorez la capacité de traitement du service backend.

X504VE

504

Backend service vpc mapped failed

Le mappage VPC du service backend a échoué.

D503BB

503

Backend circuit breaker busy

L'API est protégée par son disjoncteur.

D503CB

503

Backend circuit breaker open, ${Reason}

Le disjoncteur est ouvert pour l'API. Vérifiez les performances du service backend.

I508LD

508

Loop Detected

Un appel en boucle est détecté.

I404DD

404

Device id ${DeviceId} not found

L'ID de l'appareil est introuvable lors de l'appel d'API via WebSocket.

A403FC

403

Function Compute AssumeRole failed ${RequestId}:${Reason}

Une erreur d'autorisation s'est produite lors de l'utilisation de Function Compute comme service backend.

D502FC

502

Function Compute response invalid: ${Reason}

La réponse du service backend n'est pas valide lors de l'utilisation de Function Compute comme service backend.

N502RE

502

Send Response IO Exception: ${Reason}

Une exception s'est produite lorsque le serveur envoie une réponse au client. Vérifiez si le client ferme la connexion à l'avance ou si une erreur réseau s'est produite.

X500ER

500

Service Internal Error

Une erreur s'est produite sur le serveur interne. Pour résoudre ce problème, soumettez un ticket pour contacter le support technique d'API Gateway.

X503BZ

503

Service Busy

Le service API Gateway est occupé. Réessayez ultérieurement.

X504TO

504

Service timeout

Une erreur de délai d'attente s'est produite dans API Gateway. Pour contacter le support technique, soumettez un ticket.

Des codes d'erreur spécifiques peuvent changer lors de la mise à jour du service ou de l'ajout de nouvelles fonctionnalités.