Метод getBucketLogging
Статья создана
Обновлена 15 ноября 2024 г.
Возвращает настройки логирования действий с бакетом.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
GET /{bucket}?logging HTTP/2
Path-параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
Query-параметры
| Параметр | Описание |
|---|---|
logging |
Обязательный параметр для обозначения типа операции. |
Заголовки
Используйте в запросе общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ содержит дополнительные данные в формате XML, схема которого описана ниже.
Схема данных
Ответ, если логирование действий с бакетом не настроено:
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<!--<LoggingEnabled><TargetBucket>bucket-logs</TargetBucket><TargetPrefix>add/this/prefix/to/my/log/files/access_log-</TargetPrefix></LoggingEnabled>-->
</BucketLoggingStatus>
Ответ, если логирование действий с бакетом настроено:
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LoggingEnabled>
<TargetBucket>bucket-logs</TargetBucket>
<TargetPrefix>logs/</TargetPrefix>
</LoggingEnabled>
</BucketLoggingStatus>
| Элемент | Описание |
|---|---|
BucketLoggingStatus |
Корневой элемент. |
TargetBucket |
Имя целевого бакета, в который сохраняются объекты с логами. Путь: /BucketLoggingStatus/LoggingEnabled/TargetBucket.Тип: String. |
TargetPrefix |
Префикс ключа объекта с логами. Путь: /BucketLoggingStatus/LoggingEnabled/TargetPrefix.Тип: String. |