Como evito erros “ThrottlingException” que mostram “Rate exceeded” quando uso o Parameter Store?

Breve descrição

As chamadas de API do Parameter Store não podem exceder a taxa máxima de solicitações de API permitida para cada conta da AWS e cada região da AWS. A taxa máxima permitida inclui chamadas de API da AWS Command Line Interface (AWS CLI) e do Console de Gerenciamento da AWS.

Se as solicitações de API excederem a taxa máxima, você poderá ver uma mensagem de erro semelhante a uma das seguintes:

• “An error occurred (ThrottlingException) when calling the GetParameters operation (reached max retries: 4): Rate exceeded”
• “An error occurred (ThrottlingException) when calling the GetParameter operation (reached max retries: 4): Rate exceeded”
• “An error occurred (ThrottlingException) when calling the GetParametersByPath operation (reached max retries: 4): Rate exceeded”
• “An error occurred (ThrottlingException) when calling the DescribeParameters operation (reached max retries: 2): Rate exceeded”

Para ajudar no desempenho do serviço, o Parameter Store limita as solicitações para cada conta e região. Para mais informações sobre as cotas máximas de throughput da API do Parameter Store, consulte Service Quotas do Parameter Store.

Resolução

Observação: se você receber erros ao executar comandos da AWS CLI, consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Resolução de problemas

Para evitar mensagens de erro “ThrottlingException” que incluem “Rate exceeded”, execute as seguintes ações:

• Reduza a frequência das chamadas de API.
• Configure os intervalos das chamadas de API para que elas não sejam executadas todas ao mesmo tempo.
• Use APIs que retornem mais de um valor. Por exemplo, GetParameters e GetParametersByPath podem recuperar 10 parâmetros com uma chamada de API.
• Implemente novas tentativas de erro e recuo exponencial ao fazer chamadas de API. Para obter instruções, consulte Comportamento de repetição.
• Se você usa o AWS Lambda para chamar APIs no Parameter Store, armazene seus parâmetros em cache.
• Aumente a throughput do Parameter Store.
  Importante: ao aumentar o throughput, você sofrerá em uma cobrança em sua conta. Para obter mais informações, consulte Preços do AWS Systems Manager.

Solicitar um aumento da cota de serviço

Se você tentou os métodos de solução de problemas anteriores, mas ainda recebe erros de “Rate exceeded”, pode solicitar um aumento na cota de serviço.

Observação: antes de você enviar uma solicitação, identifique a chamada de API e a taxa de chamadas.

Para solicitar um aumento da cota de serviço para o Parameter Store, conclua as seguintes etapas:

1. Abra o Console Center do AWS Support Center e escolha Criar caso.
2. Escolha Procurando aumentos no limite de serviço?.
3. Em Tipo de limite, escolha EC2 Systems Manager.
4. Em Região, escolha sua região em Solicitações.
5. Em Tipo de recurso, escolha Parameter Store.
6. Em Cota, selecione um item e descreva o motivo do aumento da cota de API na caixa de texto Descrição do caso de uso.
   Observação: não há nenhum item aplicável para o máximo de transações por segundo de chamadas de API.
7. Insira o novo valor da cota.
8. Na caixa de texto Descrição do caso de uso, inclua o período relacionado ao problema de controle de utilização e o motivo da solicitação de aumento da cota.
9. Escolha suas opções de contato preferidas e depois escolha Enviar.

Informações relacionadas

Recuo exponencial e tremulação

Solução de problemas do repositório