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á.

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 a SDKs tentativa de se recuperar de falhas resultantes de solicitações feitas a. Serviços da AWS

Escolher entre os standard modos e adaptive tentar novamente

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

Se você optar por usar o adaptive modo, seu aplicativo deverá criar clientes projetados com base em cada recurso que possa ser limitado. Um recurso, nesse caso, é mais refinado do que apenas pensar em cada um. AWS service (Serviço da AWS) Serviços da AWS podem ter dimensões adicionais que eles usam para acelerar as solicitações. Vamos usar o serviço Amazon DynamoDB como exemplo. O DynamoDB Região da AWS usa mais a tabela que está sendo acessada para acelerar as solicitações. Isso significa que uma tabela que seu código está acessando pode ser mais limitada do que outras. Se seu código usou o mesmo cliente para acessar todas as tabelas e as solicitações para uma dessas tabelas forem limitadas, o modo de repetição adaptável reduzirá a taxa de solicitação de todas as tabelas. Seu código deve ser projetado para ter um cliente por Region-and-table par. Se você tiver uma latência inesperada ao usar o adaptive modo, consulte o guia de AWS documentação específico do serviço que você está usando.

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

Eles AWS SDKs usam repositórios de tokens para decidir se uma solicitação deve ser repetida e (no caso do modo de adaptive repetição) com que rapidez as solicitações devem ser enviadas. Dois repositórios de tokens são usados pelo SDK: um repositório de tokens de nova tentativa e um repositório de tokens de taxa de solicitação.

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 somente no modo de adaptive repetição. Essa etapa adquire um token do repositório de tokens da taxa de solicitação. Se um token não estiver disponível, ele aguardará até que um fique disponível. Seu SDK pode ter opções de configuração disponíveis para falhar 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 limitação recebidas pelo cliente.

SendHTTPRequest:

Essa etapa envia a solicitação para AWS o. A maioria AWS SDKs 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 uma solicitação falhar devido a erros de limitação, mas não se uma solicitação falhar devido a um erro transitório.

RequestBookkeeping:

Os tokens são adicionados ao token bucket se a solicitação for bem-sucedida. Somente para o modo de adaptive repetição, a taxa de preenchimento do bucket de tokens da taxa de solicitação é 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 tentativas máximas é definido pela retry_mode configuração, a menos que seja substituído pela max_attempts configuração.

HasRetryQuota

Essa etapa adquire um token do repositório de tokens de repetição. Se o repositório de tokens de nova tentativa 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. O SDKs uso de 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 secondspara a maioria SDKs. Consulte o guia específico do SDK ou o código-fonte para confirmação.

Support by AWS SDKs and tools

Os itens a seguir SDKs oferecem suporte aos recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. Todas as configurações de propriedade do sistema JVM são suportadas pelo AWS SDK for Java e pelo AWS SDK para Kotlin único.