此操作用来更新跟踪设置参数,包括跟踪日志数据保存的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
Host:oos-cn-cloudtrail.ctyunapi.cn
x-amz-content-sha256: UNSIGNED-PAYLOAD
Authorization: SignatureValue
X-Amz-Date: 20190422T092219Z
X-Amz-Target:cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.UpdateTrail
Content-Type:application/json
{"Name":"test_cloud_trail","S3KeyPrefix":"auditLog2"}
响应示例
HTTP/1.1 200 OK
x-amzn-RequestId:6a452ca08cad49b5
Content-Type:application/json;charset=UTF-8
Content-Length:278
Date:Mon, 22 Apr 2019 09:22:19 GMT
Server:CTYUN
{"Name":"test_cloud_trail","S3BucketName":"example-bucket","S3KeyPrefix":"auditLog2","TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/test_cloud_trail"}