Метод putBucketLogging
Статья создана
Обновлена 6 сентября 2024 г.
Включает и выключает механизм логирования действий с бакетом.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}?logging HTTP/2
Path-параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
Query-параметры
| Параметр | Описание |
|---|---|
logging |
Обязательный параметр для обозначения типа операции. |
Схема данных
Чтобы включить механизм логирования действий с бакетом:
<?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 |
Имя целевого бакета, в который сохраняются объекты с логами. Тип: String. |
TargetPrefix |
Префикс ключа объекта с логами. Тип: String. |
Чтобы выключить механизм логирования действий с бакетом:
<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01" />
Заголовки
Используйте в запросе только общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ не содержит дополнительных данных.