文档简介:
CreateTrail
此操作用来创建一个跟踪,并将跟踪日志保存到指定的OOS Bucket。
注意:
-
一个账户最多创建10个跟踪。
-
使用CreateTrail创建跟踪后,跟踪默认是关闭状态,需要调用StartLogging开启跟踪。
-
请求参数
名称 |
描述 |
是否必填 |
Name |
指定跟踪的名称。 类型:字符串。 取值:3~128位字符串。
|
是 |
S3BucketName |
指定OOS Bucket名称。 |
是 |
S3KeyPrefix |
指定跟踪日志的名称前缀。
类型:字符串。 取值:0-200个字符。 |
否 |
-
响应结果
名称 |
描述 |
Name |
跟踪的名称。 |
S3BucketName |
OOS Bucket名称。 |
S3KeyPrefix |
跟踪日志的名称前缀。 |
TrailARN |
跟踪的ARN。 |
-
请求示例
创建名称为test_cloud_trail的跟踪,生成的跟踪日志保存在名为test_bucket的Bucket中,日志前缀为auditlog。
POST / HTTP/1.1 Host:oos-cn-cloudtrail.ctyunapi.cn Authorization:signatureValue X-Amz-Date:date X-Amz-Target:cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.CreateTrail Content-Type:application/json
{"Name":"test_cloud_trail","S3BucketName":"test_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":"test_bucket","TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/test_cloud_trail","S3KeyPrefix":"auditlog"} |