Como soluciono os erros “400 Error Code” que recebo quando uso o CloudFormation para ElastiCache?

Breve descrição

Quando você inicia uma solicitação de API da AWS diretamente ou usando uma pilha do CloudFormation, a AWS realiza verificações iniciais de sintaxe. Essas verificações confirmam se a solicitação foi concluída e tem todos os parâmetros obrigatórios. Se uma verificação falhar, você receberá um erro.

A seguir estão os erros 400 Error Code e os motivos pelos quais eles ocorrem quando você envia uma solicitação de API para o ElastiCache:

• Você recebe um erro de Controle de utilização quando a solicitação é negada devido ao controle de utilização de solicitações da API.
• Você recebe um erro InsufficientCacheClusterCapacity quando a AWS não tem capacidade disponível suficiente para concluir sua solicitação.
• Você recebe um erro SubnetInUse porque a sub-rede que você está tentando remover tem instâncias associadas.
• Você recebe um InvalidParameterValue quando usa um valor de parâmetro que não é válido, não é compatível ou não pode ser usado em sua solicitação.
• Você recebe uma InvalidParameterCombination quando sua solicitação tem uma combinação incorreta de parâmetros ou um parâmetro ausente.

Para resolver os erros 400 Error Code, identifique o erro específico da API de invocação do ElastiCache que você recebeu e, em seguida, tome as medidas apropriadas.

Observação: para obter uma lista de possíveis erros e suas descrições, consulte Erros comuns.

Resolução

Controle de utilização

Se você receber a seguinte mensagem de erro:

“Rate exceeded (Service: AmazonElastiCache; Status Code: 400; Error Code: Throttling; Request ID: ###)”

As cotas de chamadas de API no nível da conta da AWS não são específicas do serviço. Não é possível aumentar ou modificar cotas para uma chamada de API específica. As chamadas de API não podem exceder a taxa máxima permitida de solicitações de API, mesmo para chamadas de uma aplicação, interface de linha de comandos (CLI) ou do Console de Gerenciamento da AWS.

Para resolver esse erro, execute as seguintes ações:

• Use o recuo exponencial e instabilidade para tentar novamente sua chamada.
• Distribua suas chamadas de API uniformemente ao longo do tempo e não faça várias chamadas de API em um curto período de tempo.

InsufficientCacheClusterCapacity

Se você receber a seguinte mensagem de erro:

“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: ###)”

Para resolver esse erro, execute as seguintes ações:

• Como a capacidade muda com frequência, aguarde alguns minutos e reenvie sua solicitação.
• Use outro tipo de nó de cache e envie sua solicitação novamente.
• Use outra sub-rede e zona de disponibilidade e, depois, envie sua solicitação novamente.

Para obter mais informações, consulte Mensagens de erro: InsufficientCacheClusterCapacity.

SubnetInUse

Se você receber a seguinte mensagem de erro:

“The subnet ID subnet-### is in use (Service: AmazonElastiCache; Status Code: 400; Error Code: SubnetInUse; Request ID: ###)”

Para resolver esse erro, remova todos os recursos associados da sub-rede e reenvie sua solicitação. Para obter mais informações, consulte Exemplo.

InvalidParameterValue

Verifique cada parâmetro da chamada de solicitação. Se o valor do parâmetro não for válido, não for suportado ou não puder ser usado em sua solicitação, você receberá uma das seguintes mensagens de erro.

“Invalid AuthToken provided. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue”; Request ID: ###)”

Para resolver o erro anterior, certifique-se de que sua configuração de auth-token atenda às restrições ao usar AUTH com o ElastiCache for Redis. Para obter mais informações, consulte Autenticação com o comando Valkey e Redis OSS AUTH.

“The snapshot window and maintenance window must not overlap. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###)”

Para resolver o erro anterior, separe suas janelas de snapshot e janelas de manutenção em diferentes períodos de tempo. Não é possível configurar janelas de snapshot e janelas de manutenção ao mesmo tempo.

“The number of replicas per node group must be within 0 and 5. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###)”

Para resolver o erro anterior, adicione apenas até 5 nós de réplica. O ElastiCache for Redis oferece suporte a um nó primário e de zero a cinco nós de réplica por fragmento. Para obter mais informações, consulte Compreendendo a replicação do Valkey e do Redis OSS.

InvalidParameterCombination

Se a chamada de solicitação tiver uma combinação incorreta de parâmetros ou um parâmetro ausente, você poderá receber uma das seguintes mensagens de erro.

“Cannot find version 5.0.0 for redis (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)”

Esse erro mostra que a versão do Redis em sua chamada de solicitação não é suportada. Para obter mais informações, consulte Versões suportadas do Redis OSS e Versões suportadas do Memcached.

“Cannot restore redis from 6.0.5 to 5.0.6. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)”

Para resolver o erro anterior, certifique-se de que a versão do mecanismo Redis seja mais nova ou igual à versão atual do mecanismo. O ElastiCache para Redis não oferece suporte para versões de downgrade do mecanismo Redis ao usar um backup para criar um novo cluster do Redis. Além disso, o ElastiCache for Redis não faz o downgrade do mecanismo Redis de um cluster Redis em execução. Para obter mais informações, consulte Comparando caches autoprojetados pelo Valkey, Memcached e 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: ###)”

Para resolver o erro anterior, ative a opção de failover automático em um cluster do Redis que tenha ao menos uma réplica de leitura disponível. Verifique se seu grupo de replicação do Redis tem mais de um nó de réplica e envie a solicitação novamente. Para obter mais informações, consulte Minimizar o tempo de inatividade no ElastiCache usando o Multi-AZ com Valkey e Redis OSS.

Informações relacionadas

Quotas para o ElastiCache

Problemas persistentes de conexão

Instalação ou atualização para a versão mais recente do AWS CLI