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

文档中心

对象存储

日志分析

PutBucketRealTimeLog

功能描述

此接口用于开启日志分析功能。

请求消息样式

PUT /?realtimeLog HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Authorization: authorization string
Date: Fri, 18 Apr 2025 09:11:23 GMT

{
    "RealTimeLogConfiguration": {
        "Role": "TOSLogArchiveTLSRole",
        "AccessLogConfiguration": {
            "UseServiceTopic": true,
            "TTL": 7
        }
    }
}

请求参数和消息头

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

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

请求元素

名称	参数类型	是否必选	示例值	说明
RealTimeLogConfiguration	Container	是	-	配置实时日志。
Role	String	是	TOSLogArchiveTLSRole	角色名称，用于授予对象存储 TOS 向日志服务 TLS 创建 project、topic 等资源和写入日志的权限。您可以使用 TOS 默认角色 TOSLogArchiveTLSRole。父节点：RealTimeLogConfiguration
AccessLogConfiguration	Container	是	-	配置日志资源。父节点：RealTimeLogConfiguration
UseServiceTopic	Bool	是	true	使用 TOS 服务创建的 topic，仅支持取值为 `true`。父节点：AccessLogConfiguration
TTL	Integer	否	7	TLS 日志保留时长，单位为天。取值范围为 [0, 3650]，默认为 7 天。父节点：AccessLogConfiguration

响应消息头

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

响应元素

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

请求示例

PUT /?realtimeLog HTTP/1.1
Host: bucket-name.tos-cn-beijing.volces.com
Date: Fri, 18 Apr 2025 09:11:23 GMT
Authorization: authorization string
Content-Length: 280
{
    "RealTimeLogConfiguration": {
        "Role": "TOSLogArchiveTLSRole",
        "AccessLogConfiguration": {
            "UseServiceTopic": true,
            "TTL": 7
        }
    }
}

返回示例

HTTP/1.1 200 OK
x-tos-id-2: f91b0c03a01300c1-a444cd0        
x-tos-request-id: f91b0c03a01300c1-a444cd0            
Date: Fri, 18 Apr 2025 09:11:23 GMT
server: TosServer
Content-Length: 0

最近更新时间：2025.10.28 17:10:00

这个页面对您有帮助吗？

有用

无用

对象存储

功能描述 #

请求消息样式 #

请求参数和消息头 #

请求元素 #

响应消息头 #

响应元素 #

请求示例 #

返回示例 #

功能描述

请求消息样式

请求参数和消息头

请求元素

响应消息头

响应元素

请求示例

返回示例