Object Storage API, REST совместимый с Amazon S3: GetBucketLogging
Возвращает настройки логирования действий с бакетом.
Подробнее о подготовке к работе с API и общем виде запроса в разделе Как пользоваться S3 API.
Запрос
GET /{bucket}?logging HTTP/2
Path-параметры
|
Параметр |
Описание |
|
|
Имя бакета |
Query-параметры
|
Параметр |
Описание |
|
|
Обязательный параметр для обозначения типа операции |
Заголовки
Используйте в запросе общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ содержит дополнительные данные в формате 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>
|
Элемент |
Описание |
|
|
Корневой элемент. |
|
|
Имя целевого бакета, в который сохраняются объекты с логами. Путь: |
|
|
Префикс ключа объекта с логами. Путь: |