Como soluciono um erro "Código de status: 400; Código de error" ao usar 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. A seguir estão os motivos comuns pelos quais o erro 400 ocorre quando você envia uma solicitação de API para o Amazon ElastiCache:

• Sua solicitação foi negada devido ao controle de utilização de solicitações de API.
• A AWS não tem capacidade disponível suficiente para concluir sua solicitação.
• O nó de cache não é compatível com a região ou zona de disponibilidade especificada na solicitação.
• Você usou uma combinação de parâmetros inválida.
• Você usou um valor inválido ou fora do intervalo no parâmetro de entrada.
• A API não tem um parâmetro ou ação obrigatórios.
• Você está tentando remover um recurso atualmente usado por outro recurso do ElastiCache ou serviço da AWS.

Resolução

Identifique o erro específico da API Invoke do ElastiCache que foi recebido. Depois, siga as etapas de solução de problemas listadas para o erro.

Observação: para obter uma lista de possíveis erros e suas descrições, consulte Erros comuns na Referência da API Invoke do ElastiCache.

Código de erro: Controle de utilização

Erro: "Taxa excedida (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: Controle de utilização; ID da solicitação: ###)"

Esse erro significa que sua solicitação foi negada devido ao controle de utilização de solicitações de API. Esses limites de chamadas de API no nível da conta não são específicos a nenhum serviço.

Observação: não é possível aumentar ou modificar os limites de uma chamada específica. A AWS garante que as chamadas de API não excedam a taxa máxima permitida de solicitações de API. Isso inclui chamadas de API provenientes de uma aplicação, uma chamada para uma interface de linha de comando ou para o Console de Gerenciamento da AWS.

Evite esse erro aplicando os seguintes métodos:

• Repita sua chamada com recuo exponencial e instabilidade.
• Distribua suas chamadas de API uniformemente ao longo do tempo, em vez de fazer várias chamadas de API em um curto espaço de tempo.

Código de erro: InsufficientCacheClusterCapacity

Erro: "cache.### (VPC) não tem suporte atualmente na zona de disponibilidade ###. Repita o lançamento sem zona de disponibilidade ou destino: ###. (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: InsufficientCacheClusterCapacity; ID da solicitação: ###)".

Esse erro indica que, no momento, a AWS não tem capacidade sob demanda disponível suficiente para concluir sua solicitação. Para obter mais informações, consulte Error Messages: InsufficidentCacheClusterCapacity.

Se você receber esse erro, faça o seguinte:

1. Aguarde alguns minutos e envie sua solicitação novamente. A capacidade muda com frequência.
2. Use outro tipo de nó de cache e envie sua solicitação novamente.
3. Use outra sub-rede e zona de disponibilidade e, depois, envie sua solicitação novamente.

Código de erro: SubnetInUse

Erro: "A sub-rede ID subnet-### está em uso (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: SubnetInUse; ID da solicitação: ###)".

Esse erro ocorre se você tentar remover uma sub-rede de um grupo de sub-redes do Elasticache que atualmente tem instâncias associadas a ela. Você deve remover todos os recursos relacionados da sub-rede e, depois, enviar a solicitação novamente. Para obter mais informações, consulte DeleteCacheSubnetGroup.

Código de erro: InvalidParameterValue

Esse erro indica que um valor de parâmetro não é válido, é incompatível ou não pode ser usado na solicitação. Verifique cada parâmetro da chamada de solicitação. Por exemplo, se você usou um valor de parâmetro incompatível, poderá ver uma das seguintes mensagens de erro:

• "AuthToken inválido fornecido. (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: InvalidParameterValue"; ID da solicitação: ###)".
  Esse erro indica que a configuração do auth-token não atende às restrições ao usar AUTH com o ElastiCache para Redis. Para obter mais informações, consulte Autenticação de usuários com o comando Redis AUTH.
• "A janela de sobrepor e a janela de manutenção não devem se sobrepor. (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: InvalidParameterValue; ID da solicitação: ###)".
  As janelas de snapshot e as janelas de manutenção não podem ser configuradas ao mesmo tempo. Ajuste a janela de operação para outro período para evitar esse erro.
• "O número de réplicas por grupo de nós deve estar entre 0 e 5. (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: InvalidParameterValue; ID da solicitação: ###)".
  O Redis do ElastiCache suporta uma réplica primária e de 0 a 5 réplicas por fragmento. Se você adicionar mais de 5 nós de réplica, receberá esse erro. Para obter mais informações, consulte Noções básicas sobre a replicação do Redis.

Código de erro: InvalidParameterCombination

Esse erro indica que a chamada de solicitação contém uma combinação incorreta de parâmetros ou um parâmetro ausente. Se isso ocorrer, você poderá ver uma das seguintes mensagens de erro:

• "Não é possível encontrar a versão 5.0.0 do redis (Service: AmazonElastiCache; Código de status: 400; Código de erro: InvalidParameterCombination; ID da solicitação: ###)".
  Esse erro indica que a versão do Redis indicada na sua chamada de solicitação não é compatível. Para obter mais informações, consulte Versões compatíveis do ElastiCache para Redis e Versões compatíveis do ElastiCache para Memcached.
• "Não é possível restaurar o redis da versão 6.0.5 para a 5.0.6. (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: InvalidParameterCombination; ID da solicitação: ###)".
  O ElastiCache para Redis não é compatível com versões de downgrade do mecanismo Redis ao usar um backup para criar um novo cluster do Redis. O ElastiCache para Redis também não é compatível com o downgrade do mecanismo Redis em um cluster do Redis em execução. Ao criar um novo cluster do Redis usando um backup, a versão do mecanismo Redis deve ser maior ou igual à versão atual do mecanismo.
• "Ao usar o failover automático, deve haver pelo menos dois clusters de cache no grupo de replicação. (Serviço: AmazonElastiCache; Código de status: 400; Código de erro: InvalidParameterCombination; ID da solicitação: ###)".
  É possível ativar 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 para Redis com Multi-AZ.

Informações relacionadas

Quotas para o ElastiCache

Mensagens de erro do Amazon ElastiCache

Solução de problemas - Amazon ElastiCache para Redis

Solucionar erros da AWS CLI