Метод getBucketLogging

Статья создана

Запрос
Ответ

Возвращает настройки логирования действий с бакетом.

Запрос

GET /{bucket}?logging HTTP/1.1

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.