---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/reference/configuration/aws_client_config.md?version=main
  - https://ydb.tech/docs/ru/reference/configuration/aws_client_config.md?version=main
sourcePath: ru/core/reference/configuration/aws_client_config.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# aws_client_config

Секция `aws_client_config` задает значения по умолчанию для клиента AWS SDK, который YDB использует при обращении к S3 и к другим объектным хранилищам с совместимым API. В ней задаются таймауты, параметры TLS и логирование для всех таких исходящих подключений процесса узла кластера; при необходимости их переопределяет конфигурация конкретного хранилища.

## Синтаксис

```yaml
aws_client_config:
  log_config:
    log_level: 0
    filename_prefix: ""
  verify_ssl: true
  request_timeout_ms: 0
  http_request_timeout_ms: 0
  connection_timeout_ms: 10000
  enable_tcp_keep_alive: true
  tcp_keep_alive_interval_ms: 30000
  max_connections_count: 32
  executor_threads_count: 32
  ca_path: "/etc/ssl/certs"
```

## Параметры

| Параметр | Значение по умолчанию | Описание |
| --- | --- | --- |
| `log_config.log_level` | `0` (Off) | Числовое значение уровня детализации логов AWS SDK. Имена уровней и числовые значения см. в разделе [«Уровни логов»](#aws-sdk-log-levels). |
| `log_config.filename_prefix` | — | Префикс для файлов логов AWS SDK. При задании файлы создаются как `<prefix>YYYY-MM-DD-HH.log`; иначе вывод идёт в stdout. |
| `verify_ssl` | `true` | Проверять TLS-сертификаты при подключении к endpoint AWS (и совместимые API). Отключать стоит только в тестовых средах. |
| `request_timeout_ms` | `0` (выкл.) | Таймаут на уровне AWS SDK для запроса целиком (включая DNS, установление соединения, TLS и передачу данных). Значение задается в миллисекундах. `0` — без ограничения со стороны SDK. |
| `http_request_timeout_ms` | `0` (выкл.) | Таймаут на уровне HTTP-клиента (Curl), в миллисекундах. `0` — без таймаута. |
| `connection_timeout_ms` | `10000` | Таймаут установления TCP-соединения в миллисекундах. |
| `enable_tcp_keep_alive` | `true` | Включить TCP keep-alive на клиентских сокетах. |
| `tcp_keep_alive_interval_ms` | `30000` (дефолт AWS SDK) | Интервал между keep-alive пакетами в миллисекундах. Если параметр не задан в конфигурации YDB, используется дефолт AWS SDK — 30000 мс. В Curl значение округляется до секунд; должен быть не меньше 15000. |
| `max_connections_count` | `32` | Максимум одновременных TCP‑соединений, которые может открыть HTTP-клиент в составе AWS SDK. |
| `executor_threads_count` | `32` | Размер пула потоков, выделяемого для каждого уникального S3 endpoint. Задает параллелизм асинхронных запросов к этому endpoint. |
| `ca_path` | `"/etc/ssl/certs"` | Путь к каталогу с корневыми сертификатами для проверки TLS при исходящих подключениях. |
| `ca_file` | — | Путь к файлу с набором корневых сертификатов. Используется, если хранилище доверенных сертификатов расположено нестандартно. |

### Уровни логов {#aws-sdk-log-levels}

| Уровень | Значение | Описание |
| --- | --- | --- |
| `Off` | `0` | Отключить логирование AWS SDK. |
| `Fatal` | `1` | Только фатальные ошибки. |
| `Error` | `2` | Некритические ошибки. |
| `Warn` | `3` | Предупреждения, требующие внимания. |
| `Info` | `4` | Общая информационная сводка. |
| `Debug` | `5` | Отладочная информация. |
| `Trace` | `6` | Максимально подробная диагностика. |

## См. также

- [log_config](https://ydb.tech/docs/ru/reference/configuration/log_config.md?version=main) — логирование серверного процесса YDB; вложенный в `aws_client_config` блок `log_config` относится только к AWS SDK и с ним не связан.
- [Выгрузка и загрузка данных](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/index.md?version=main) — импорт и экспорт через S3 из CLI; доступ к хранилищу задается там, а не в `aws_client_config`.

## Связанные сценарии («S3 в YDB»)

Другие задачи с объектным хранилищем; настройки из этих материалов могут переопределять настройки, заданные в секции `aws_client_config`.

- [CREATE EXTERNAL DATA SOURCE](https://ydb.tech/docs/ru/yql/reference/syntax/create-external-data-source.md?version=main) — внешний источник данных с протоколом S3 в YQL.
- [Развёртывание YDB с функцией Federated Query](https://ydb.tech/docs/ru/devops/deployment-options/manual/federated-queries/index.md?version=main) — федеративные запросы и внешние источники.
- [Импорт и экспорт данных в колоночные таблицы](https://ydb.tech/docs/ru/recipes/import-export-column-tables.md?version=main) — импорт и экспорт колоночных таблиц через объектное хранилище.