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

文档中心

立即注册

对象存储

日志存储

GetBucketLogging

功能描述

此接口用于获取日志存储的配置信息。

注意事项

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

请求消息样式

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

请求参数和消息头

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

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

请求元素

该请求不使用消息元素。

响应消息头

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

响应元素

名称	参数类型	示例值	说明
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`。

请求示例

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

响应示例

HTTP/1.1 200 OK
x-tos-id-2: 4fac130beeb50032-a444ed0
x-tos-request-id: 4fac130beeb50032-a444ed0
Date: Mon, 12 May 2025 07:18:51 GMT
server: TosServer
Content-Length: 0
{
    "LoggingEnabled": {
        "TargetBucket": "test",
        "TargetPrefix": "tos-accesslog",
        "Role": "ServiceRoleforTOSLogging"
    }
}

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

这个页面对您有帮助吗？

有用

无用