Como evitar erros de “ThrottlingException” ou “Taxa excedida” ao usar o AWS Systems Manager Parameter Store?

Descrição breve

As chamadas de API do Parameter Store não podem exceder a taxa máxima de solicitações de API permitida por conta e por região da AWS. Isso 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ê receberá um erro de “Taxa excedida”, e outras chamadas de API serão limitadas. Você pode ver um erro semelhante a um dos seguintes:

• Ocorreu um erro (ThrottlingException) ao chamar a operação GetParameters (atingiu o máximo de tentativas): 4): Taxa excedida
• Ocorreu um erro (ThrottlingException) ao chamar a operação GetParameter (atingiu o máximo de tentativas): 4): Taxa excedida
• Ocorreu um erro (ThrottlingException) ao chamar a operação GetParametersByPath (atingiu o máximo de tentativas): 4): Taxa excedida
• Ocorreu um erro (ThrottlingException) ao chamar a operação DescribeParameters (atingiu o máximo de tentativas): 2): Taxa excedida

As solicitações do Parameter Store são limitadas para cada conta da Amazon Web Services (AWS) por região para ajudar na performance do serviço. Para mais informações sobre as cotas máximas de throughtput de APIs do Parameter Store, consulte Endpoints e cotas do AWS Systems Manager.

Resolução

Solução de problemas

Para evitar ou atenuar os erros “ThrottlingException” ou “Taxa excedida”, tente as seguintes etapas de solução de problemas:

• Reduza a frequência das chamadas de API.
• Escalone 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 and GetParametersByPath oferecem suporte à recuperação de 10 parâmetros com uma chamada de API.
• Implemente novas tentativas de erro e recuo exponencial ao fazer chamadas de API.
• Aumente a throughtput do Parameter Store.
  Importante: o aumento da throughtput gera cobrança na sua conta da AWS. Para mais informações, consulte os preços do AWS Systems Manager.
  Observação: você pode aumentar a throughput usando o console do AWS Systems Manager, a AWS CLI ou o AWS Tools for Windows PowerShell. Se você receber erros ao executar comandos da AWS CLI, certifique-se de estar utilizando a versão mais recente da AWS CLI.

Solicitar o aumento da cota de serviço

Se você já tentou todas as etapas de solução de problemas anteriores, mas ainda recebe erros de “Taxa excedida”, pode solicitar um aumento na cota de serviço.

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

Para solicitar um aumento da cota de serviço para o Parameter Store, siga estas etapas:

1. Abra o AWS Support Center e escolha Criar caso.
2. Escolha Looking for service limit increases? (Procurando aumentos no limite de serviço?)
3. Em Limit Type (Tipo de limite), escolha EC2 Systems Manager.
4. Em Region (Região), escolha sua região da AWS em Requests (Solicitações).
5. Em Resource Type (Tipo de recurso), escolha Parameter Store (Armazenamento de Parâmetros).
6. Escolha o Limite que você deseja aumentar e insira o novo valor limite.
7. Na caixa de texto Use case description (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.
8. Escolha suas opções de contato preferidas e depois escolha Submit (Enviar).

Informações relacionadas

Recuo exponencial e tremulação

Solução de problemas do repositório