As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Comportamento de repetição

O comportamento de repetição inclui configurações sobre como os SDKs tentam se recuperar de falhas resultantes de solicitações feitas para os Serviços da AWS.

Escolher entre os modos de repetição de tentativas standard e adaptive

Recomendamos que você use o modo de repetição de tentativas standard, a menos que tenha certeza de que seu uso é mais adequado para o modo adaptive.

Se você escolher o modo adaptive, sua aplicação deverá construir clientes projetados com base em cada recurso cuja utilização possa estar sendo controlada. Um recurso, nesse caso, tem um ajuste mais fino do que apenas levar em conta cada AWS service (Serviço da AWS). Os Serviços da AWS podem ter dimensões adicionais que usam para controlar a utilização das solicitações. Vamos usar o serviço Amazon DynamoDB como exemplo. O DynamoDB usa a Região da AWS mais a tabela que está sendo acessada para controlas a utilização das solicitações. Isso significa que uma tabela que o código está acessando pode sofrer mais controle de utilização que outras. Se o código tiver usado o mesmo cliente para acessar todas as tabelas e a utilização de solicitações para uma dessas tabelas for controlada, o modo adaptativo de repetição de tentativas reduzirá a taxa de solicitações de todas as tabelas. O código deve ser projetado para ter um único cliente por par de região e tabela. Se observar latência inesperada ao usar o modo adaptive, consulte o guia da documentação da AWS específico para o serviço que você está usando.

Detalhes da implementação do modo de repetição de tentativas

Os SDKs da AWS usam buckets de tokens para decidir se uma solicitação deve ser repetida e (no caso do modo de repetição adaptive) com que rapidez as solicitações devem ser enviadas. Dois buckets de tokens são usados pelo SDK: um bucket de tokens de repetição de tentativas e um bucket de tokens de taxa de solicitações.

A seguir está o pseudocódigo de alto nível para os modos de repetição de repetição standard e adaptive:

MakeSDKRequest() {
  attempts = 0
  loop {
    GetSendToken()
    response = SendHTTPRequest()
    RequestBookkeeping(response)
    if not Retryable(response)
      return response
    attempts += 1
    if attempts >= MAX_ATTEMPTS:
      return response
    if not HasRetryQuota(response)
      return response
    delay = ExponentialBackoff(attempts)
    sleep(delay)
  }
}

A seguir estão mais detalhes sobre os componentes usados no pseudocódigo:

GetSendToken:

Essa etapa é usada apenas no modo adaptive de repetição de tentativas. Essa etapa obtém um token do bucket de tokens de taxa de solicitações. Se um token não estiver disponível, aguardará até que um fique disponível. O SDK pode ter opções de configuração disponíveis para considerar que houve falha na solicitação em vez de esperar. Os tokens no bucket são recarregados a uma taxa determinada dinamicamente, com base no número de respostas de controle de utilização recebidas pelo cliente.

SendHTTPRequest:

Esta etapa envia a solicitação para a AWS. A maioria dos SDKs da AWS usa uma biblioteca HTTP que usa grupos de conexões para reutilizar uma conexão existente ao fazer uma solicitação HTTP. Geralmente, as conexões são reutilizadas se houver falha em uma solicitação devido a erros de controle de utilização, mas não se a falha da solicitação ocorrer devido a um erro transitório.

RequestBookkeeping:

Os tokens serão adicionados ao bucket de tokens se a solicitação for bem-sucedida. Somente para o modo adaptive de repetição de tentativas, a taxa de preenchimento do bucket de tokens de taxa de solicitações é atualizada com base no tipo de resposta recebida.

Retryable:

Essa etapa determina se uma resposta pode ser repetida com base no seguinte:

Erros transitórios (códigos de status HTTP 400, 408, 500, 502, 503 e 504) e erros de controle de utilização (códigos de status HTTP 400, 403, 429, 502, 503 e 509) podem potencialmente ser repetidos. O comportamento de repetição do SDK é determinado em combinação com códigos de erro ou outros dados do serviço.

MAX_ATTEMPTS:

O número padrão de máximo de tentativas é definido pela configuração retry_mode, a menos que seja substituído pela configuração max_attempts.

HasRetryQuota

Essa etapa obtém um token do bucket de tokens de repetição de tentativas. Se o bucket de tokens de repetição de tentativas estiver vazio, a solicitação não será repetida.

ExponentialBackoff

Para um erro que pode ser repetido, o atraso da nova tentativa é calculado usando o recuo exponencial truncado. Os SDKs usam recuo exponencial binário truncado com instabilidade. O algoritmo a seguir mostra como a quantidade de tempo de sono, em segundos, é definida para uma resposta à solicitação i:

seconds_to_sleep_i = min(b*r^i, MAX_BACKOFF)

No algoritmo anterior, os seguintes valores se aplicam:

b = random number within the range of: 0 <= b <= 1

r = 2

MAX_BACKOFF = 20 seconds para a maioria dos SDKs. Consulte o guia específico do SDK ou o código-fonte para confirmação.

Compatibilidade com SDKs e ferramentas da AWS

Os SDKs a seguir são compatíveis com os recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. As configurações de propriedade do sistema de JVM são compatíveis apenas como o AWS SDK para Java e o AWS SDK para Kotlin.