Comment résoudre les erreurs « Code d’erreur 400 » que je reçois lorsque j'utilise CloudFormation pour ElastiCache ?

Brève description

Lorsque vous lancez une demande d’API AWS directement ou à l’aide d’une pile CloudFormation, AWS effectue des contrôles de syntaxe initiaux. Ces contrôles permettent de vérifier si la demande est complète et présente tous les paramètres obligatoires. Si un contrôle échoue, un message d'erreur s’affiche.

Les erreurs 400 Code d’erreur et les raisons pour lesquelles elles se produisent lorsque vous envoyez une demande d'API pour ElastiCache sont présentées ci-dessous :

• Vous recevez une erreur Limitation lorsque la demande est refusée en raison d'une limitation de la demande d’API.
• Vous recevez une erreur InsufficientCacheClusterCapacity lorsqu'AWS ne dispose pas d’une capacité suffisante pour traiter votre demande.
• Vous recevez une erreur SubnetInUse car le sous-réseau que vous essayez de supprimer est associé à des instances.
• Vous recevez une erreur InvalidParameterValue lorsque vous utilisez une valeur de paramètre qui n'est pas valide, qui n'est pas prise en charge ou que vous ne pouvez pas utiliser dans votre demande.
• Vous recevez une erreur InvalidParameterCombination lorsque votre requête contient une combinaison de paramètres incorrecte ou qu'un paramètre est manquant.

Pour résoudre les erreurs 400 Code d’erreur, identifiez l'erreur d'API d'invocation ElastiCache spécifique que vous avez reçue, puis prenez les mesures appropriées.

Remarque : Pour une liste des erreurs possibles et leur description, consultez la section Erreurs courantes.

Résolution

Limitation

Le message d’erreur suivant s’affiche :

« Rate exceeded (Service: AmazonElastiCache; Status Code: 400; Error Code: Throttling; Request ID: ###) » (Dépassement du taux (Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : Limitation ; ID de la requête : ###)

Les quotas d'appels d'API au niveau du compte AWS ne sont pas spécifiques au service. Vous ne pouvez ni augmenter ni modifier les quotas pour un appel d'API spécifique. Les appels d'API ne peuvent pas dépasser le taux de demandes d'API maximum autorisé, même pour les appels provenant d'une application, d'une interface de ligne de commande (CLI) ou de la console de gestion AWS.

Pour résoudre cette erreur, effectuez les actions suivantes :

• Utilisez le backoff exponentiel avec gigue pour effectuer une nouvelle tentative d’appel.
• Répartissez vos appels d'API de manière uniforme dans le temps et ne passez pas d’appels d'API dans un court laps de temps.

InsufficientCacheClusterCapacity

Le message d’erreur suivant s’affiche :

« Cache.### (VPC) is not currently supported in the availability zone ###. Retry the launch with no availability zone or target: ###. (Service: AmazonElastiCache; Status Code: 400; Error Code: InsufficientCacheClusterCapacity; Request ID: ###) » (Le cache.### (VPC) n’est pas actuellement pris en charge dans la zone de disponibilité ###. Réessayez le lancement sans zone de disponibilité ou cible : ###. (Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : InsufficientCacheClusterCapacity ; ID de demande : ###)

Pour résoudre cette erreur, effectuez les actions suivantes :

• Comme la capacité change fréquemment, attendez quelques minutes, puis soumettez à nouveau votre demande.
• Utilisez un autre type de nœud de cache, puis soumettez à nouveau votre demande.
• Utilisez un autre sous-réseau et une autre zone de disponibilité, puis soumettez à nouveau votre demande.

Pour en savoir plus, consultez la section Messages d’erreur : InsufficientCacheClusterCapacity.

SubnetInUse

Le message d’erreur suivant s’affiche :

« The subnet ID subnet-### is in use (Service: AmazonElastiCache; Status Code: 400; Error Code: SubnetInUse; Request ID: ###) » (L’ID de sous-réseau subnet-### est actuellement utilisé (Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : SubnetInUse ; ID de demande : ###)

Pour résoudre cette erreur, supprimez toutes les ressources associées du sous-réseau, puis soumettez à nouveau votre demande. Pour en savoir plus, consultez la section Exemples.

InvalidParameterValue

Vérifiez chaque paramètre de votre appel de demande. Si la valeur du paramètre n'est pas valide, n'est pas prise en charge ou ne peut pas être utilisée dans votre requête, l'un des messages d'erreur suivants s'affiche.

« Invalid AuthToken provided. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###) » (Jeton d’authentification non valide fourni. (Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : InvalidParameterValue" ; ID de demande : ###)

Pour résoudre l'erreur précédente, assurez-vous que votre paramètre auth-token répond aux contraintes lorsque vous utilisez AUTH avec ElastiCache for Redis. Pour plus d'informations, consultez la section Authentification à l'aide de la commande Valkey et Redis OSS AUTH.

« The snapshot window and maintenance window must not overlap. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###) » (La fenêtre de l’instantané et la fenêtre de maintenance ne doivent pas se chevaucher. Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : InvalidParameterValue ; ID de demande : ###)

Pour résoudre l'erreur précédente, séparez vos fenêtres d’instantané et vos fenêtres de maintenance en différentes périodes. Il n’est pas possible de configurer les fenêtres d’instantané et les fenêtres de maintenance en même temps.

« The number of replicas per node group must be within 0 and 5. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###) » (Le nombre de réplicas par groupe de nœuds doit être compris entre 0 et 5. Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : InvalidParameterValue ; ID de demande : ###)

Pour résoudre l'erreur précédente, ajoutez uniquement jusqu'à 5 nœuds de réplication. ElastiCache for Redis prend en charge un nœud primaire et de zéro à cinq nœuds de réplication par partition. Pour plus d'informations, consultez la section Comprendre la réplication Valkey et Redis OSS.

InvalidParameterCombination

Si la combinaison de paramètres de l'appel de demande est incorrecte ou si un paramètre est manquant, l'un des messages d'erreur suivants peut s'afficher.

« Cannot find version 5.0.0 for redis (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID:) » (Version 5.0.0 pour redis introuvable (Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : InvalidParameterCombination ; ID de demande : ###)

Cette erreur indique que la version de Redis figurant dans votre appel de demande n'est pas prise en charge. Pour plus d'informations, consultez les sections Versions de Redis OSS prises en charge et Versions de Memcached prises en charge.

« Cannot restore redis from 6.0.5 to 5.0.6. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID:) » (Impossible de restaurer redis de la version 6.0.5 à la version 5.0.6. (Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : InvalidParameterCombination ; ID de demande : ###)

Pour résoudre l'erreur précédente, assurez-vous que la version de votre moteur Redis est plus récente ou égale à la version actuelle du moteur. ElastiCache for Redis ne prend pas en charge les versions rétrogradées du moteur Redis lorsque vous utilisez une sauvegarde pour créer un nouveau cluster Redis. De plus, ElastiCache for Redis ne rétrograde pas le moteur Redis d'un cluster Redis en cours d'exécution. Pour plus d'informations, consultez la section Comparaison des caches auto-conçus par Valkey, Memcached et Redis OSS.

« When using automatic failover, there must be at least 2 cache clusters in the replication group. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID:) » (Lors de l’utilisation du basculement automatique, le groupe de réplication doit inclure au moins 2 clusters de cache. (Service : AmazonElastiCache ; Code d’état : 400 ; Code d’erreur : InvalidParameterCombination ; ID de demande : ###)

Pour résoudre l’erreur précédente, vous pouvez activer l’option de basculement automatique dans un cluster Redis qui contient au moins un réplica en lecture disponible. Vérifiez que votre groupe de réplication Redis inclut plusieurs nœuds de réplication, puis soumettez à nouveau votre requête. Pour plus d'informations, consultez la section Minimiser la durée d’indisponibilité dans ElastiCache à l'aide de Multi-AZ avec Valkey et Redis OSS.

Informations connexes

Quotas pour ElastiCache

Problèmes de connexion persistants

Installation ou mise à jour de la dernière version de l'AWS CLI