UpdateTrail
更新时间 2026-05-25 17:48:00
最近更新时间: 2026-05-25 17:48:00
本节主要介绍UpdateTrail。
此操作用来更新跟踪设置参数,包括跟踪日志数据保存的OOS Bucket、跟踪日志前缀等。
说明
更新跟踪时,无需暂停跟踪。
如果S3BucketName和S3KeyPrefix都未指定,该操作不起作用,但是不报错,返回200 OK。
请求参数
名称 描述 是否必须 Name 跟踪的名称。
类型:字符串
取值:3~128个字符:
可以包含ASCII字母(a-z,A-Z),数字(0-9),句点(.),下划线(_)或短划线(-)。
必须以字母或数字开头,以字母或数字结尾。
不能是IP地址格式(例如:192.168.5.4)。
不能包含相邻句点(.)、下划线(_)、短划线(-)任意组合。如不能包含类似点点(..),点下划线(._)的组合。
是 S3BucketName OOS Bucket名称。 否 S3KeyPrefix 指定跟踪日志的名称前缀。
类型:字符串
取值:0~200个字符。
否
响应结果
| 名称 | 描述 |
|---|---|
| Name | 跟踪的名称。 |
| S3BucketName | OOS Bucket名称。 |
| S3KeyPrefix | 跟踪日志的名称前缀。 |
| TrailARN | 跟踪的ARN。 |
请求示例
更新名为test_cloud_trail的跟踪信息,将跟踪日志前缀更新为 auditLog2 。
POST / HTTP/1.1
Authorization: signatureValue
x-amz-date: 20260514T095155Z
x-amz-content-sha256: UNSIGNED-PAYLOAD
X-Amz-Target: cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.UpdateTrail
Content-Type: application/json
Content-Length: 41
Host: oos-cn-cloudtrail.ctyunapi.cn
{
"Name": "test_cloud_trail",
"S3KeyPrefix": "auditLog2"
}
响应示例
HTTP/1.1 200 OK
x-amz-RequestId: 9d064a6e98b14f9e
Content-Type: application/json;charset=UTF-8
Content-Length: 157
Date: Thu, 14 May 2026 09:51:55 GMT
Server: CTYUN
{
"S3KeyPrefix": "auditLog2",
"S3BucketName": "example-bucket",
"Name": "test_cloud_trail",
"TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/test_cloud_trail"
}