PutBucketLogging--对象存储-火山引擎

文档中心

立即注册

对象存储

日志存储

PutBucketLogging

功能描述

此接口用于开启或关闭日志存储功能。

注意事项

当前仅华北2（北京）和华东2（上海）支持日志存储功能。

请求消息样式

PUT /?logging HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Authorization: authorization string
Date: Fri, 30 Jul 2021 06:45:39 GMT
{
  "LoggingEnabled": {
    "TargetBucket": "test",
    "TargetPrefix": "prefix",
    "Role": "ServiceRoleforTOSLogging"
  }
}

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
logging	Query	String	是	/-	代表 PutBucketLogging 请求的特殊标识。

请求元素

说明

如果调用 PutBucketLogging 接口关闭日志存储功能，则只需要将请求元素配置为 {} 。

名称	参数类型	是否必选	示例值	说明
LoggingEnabled	Container	否	/-	开启日志存储功能的配置规则。
TargetBucket	String	否	test	存储日志文件的目标存储桶。
TargetPrefix	String	否	tos-accesslog	日志文件在目标存储桶的存储路径。例如设置 `TargetPrefix` 为 `tos-accesslog`，则日志文件会存储在 `tos-accesslog/SourceBucket/YYYY-MM-DD-HH-MM-SS` 路径下，文件名为系统自动生成的字符串。关于文件命名规则，请参见存储规则。
Role	String	否	ServiceRoleforTOSLogging	角色名称，用于授予对象存储读取源存储桶所有文件和向目标存储桶写入文件的权限。该角色必须具有 TOS 的读写权限及服务访问权限，您也可以使用 TOS 默认角色 `ServiceRoleforTOSLogging`。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例 1

调用 PutBucketLogging 接口开启日志存储功能。

PUT /?logging HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Authorization: authorization string
Date: Fri, 30 Jul 2021 06:45:39 GMT
{
  "LoggingEnabled": {
    "TargetBucket": "test",
    "TargetPrefix": "prefix",
    "Role": "ServiceRoleforTOSLogging"
  }
}

响应示例 1

HTTP/1.1 200 OK
x-tos-id-2: 4fac130beeb50032-a444ed0
x-tos-request-id: 4fac130beeb50032-a444ed0
Date: Mon, 12 May 2025 07:02:38 GMT
server: TosServer
Content-Length: 0

请求示例 2

调用 PutBucketLogging 接口关闭日志存储功能。

PUT /?logging HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Authorization: authorization string
Date: Fri, 30 Jul 2021 06:45:39 GMT
{}

响应示例 2

HTTP/1.1 200 OK
x-tos-id-2: 4fac130beeb50032-a444ed0
x-tos-request-id: 4fac130beeb50032-a444ed0
Date: Mon, 12 May 2025 06:54:12 GMT
server: TosServer
Content-Length: 0

最近更新时间：2025.06.04 16:24:09

这个页面对您有帮助吗？

有用

无用