Todos os produtos
Search
Central de documentação

Alibaba Cloud SDK:Configure o tempo limite

Última atualização: Jun 28, 2026

As configurações de tempo limite determinam quanto tempo o Alibaba Cloud SDK for Python V2.0 aguarda antes de cancelar uma tentativa de conexão ou uma operação de leitura. Defina tempos limite longos o suficiente para concluir sua carga de trabalho, mas curtos o bastante para identificar falhas rapidamente.

Configuração de tempo limite

Nota

As configurações de tempo limite seguem esta ordem de prioridade, da maior para a menor: RuntimeOptions > Config > valores padrão.

O SDK fornece dois parâmetros de tempo limite, ambos especificados em milissegundos (ms):

Parâmetro

Tipo

Padrão

Descrição

connect_timeout

int

5.000 ms

Tempo máximo de espera ao estabelecer uma conexão.

read_timeout

int

10.000 ms

Tempo máximo de espera por uma resposta após a conexão.

Os valores padrão atendem à maioria dos casos de uso. Substitua-os apenas quando houver um motivo específico, como ao chamar um endpoint com latência consistentemente alta ou quando for necessária uma detecção de falhas mais rápida em aplicações sensíveis à latência.

  • Use os padrões. Se você não definir nenhum tempo limite, o SDK usará um tempo limite de conexão de 5.000 ms e um tempo limite de leitura de 10.000 ms.

  • Substitua por solicitação usando RuntimeOptions. Essa configuração se aplica somente à solicitação individual que utiliza a instância de RuntimeOptions.

    from alibabacloud_tea_util.models import RuntimeOptions
    
    # Applies only to requests that use this RuntimeOptions instance.
    runtimeOptions = RuntimeOptions(
        read_timeout=10000,  # Read timeout in milliseconds (ms)
        connect_timeout=5000  # Connection timeout in milliseconds (ms)
    )
  • Substitua globalmente usando a classe Config. Essa definição vale para todos os clientes inicializados com esta instância de Config.

    from alibabacloud_tea_openapi.models import Config
    
    # Applies to all clients initialized with this Config instance.
    config = Config(
        read_timeout=10000,  # Read timeout in milliseconds (ms)
        connect_timeout=5000  # Connection timeout in milliseconds (ms)
    )