CreateTrail
更新時間 2024-09-19 16:53:49
最近更新時間: 2024-09-19 16:53:49
分享文章
本節主要介紹CreateTrail。
此操作用來創建一個跟蹤,并將跟蹤日志保存到指定的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個字符。
否
響應結果
| 名稱 | 描述 |
|---|---|
| Name | 跟蹤的名稱。 |
| S3BucketName | OOS Bucket名稱。 |
| S3KeyPrefix | 跟蹤日志的名稱前綴。 |
| TrailARN | 跟蹤的ARN。 |
請求示例
創建名稱為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"}