此操作用来创建一个跟踪，并将跟踪日志保存到指定的OOS Bucket。

                    
注意
                    
一个账户最多创建10个跟踪。
使用CreateTrail创建跟踪后，跟踪默认是关闭状态，需要调用StartLogging开启跟踪。
                    
                  
                  

请求参数

名称
描述
是否必须
Name
指定跟踪的名称。
类型：字符串
取值：3~128个字符：
可以包含ASCII字母（a-z，A-Z），数字（0-9），句点（.），下划线（_）或短划线（-）。
必须以字母或数字开头，以字母或数字结尾。不能是IP地址格式（例如：192.168.5.4）。
不能包含相邻句点（.）、下划线（_）、短划线（-）任意组合。如不能包含类似点点（..）,点下划线（._）的组合。
是
S3BucketName
指定OOS Bucket名称。
是
S3KeyPrefix
指定跟踪日志的名称前缀。
指定日志前缀的存储路径为：BucketName/<日志的名称前缀>/OOSLogs/<账号ID>/CloudTrail/<年>/<月>/<日>/<日志数据文件>。
未指定日志前缀的存储路径为：BucketName/OOSLogs/<账号ID>/CloudTrail/<年>/<月>/<日>/<日志数据文件>。
类型：字符串
取值：0~200个字符。
否

响应结果

请求示例

创建名称为test_cloud_trail的跟踪，生成的跟踪日志保存在名为example-bucket的Bucket中，日志前缀为 auditlog 。

POST / HTTP/1.1
Host:oos-cn-cloudtrail.ctyunapi.cn
x-amz-content-sha256: UNSIGNED-PAYLOAD
Authorization: SignatureValue
X-Amz-Date: 20190418T100110Z
X-Amz-Target:cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.CreateTrail
Content-Type:application/json
 
{"Name":"test_cloud_trail","S3BucketName":"example-bucket","S3KeyPrefix":"auditlog"}

响应参数

HTTP/1.1 200 OK
x-amz-request-id:ea219738be1a4688
Content-Type:application/json;charset=UTF-8
Content-Length:254
Date:Thu, 18 Apr 2019   10:01:10 GMT
Server:CTYUN
 
{"Name":"test_cloud_trail","S3BucketName":"example-bucket","TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/test_cloud_trail","S3KeyPrefix":"auditlog"}