此操作用來查看賬戶中的管理事件。用戶可以查看近6個月內發生的管理事件。
支持查詢以下屬性:
- OOS訪問密鑰。
- 管理事件ID。
- 管理事件名稱。
- 管理事件來源。
- 是否只讀。
- 資源名稱。
- 資源類型。
- 子用戶名。
所有的屬性都是可選項,默認返回50個查詢結果,一次最多只能返回50個結果,如果想查看其他結果,可以通過設置MaxResults和NextToken來進行查看。
請求參數
名稱 描述 是否必須 StartTime 指定返回管理事件的起始時間。如果同時指定了起始時間和結束時間,則起始時間必須早于結束時間,否則將返回錯誤信息。
類型:時間戳
取值:unix時間戳(UTC),精確到毫秒。默認起始時間為距當前時間往前數的第184天。
如果起始時間晚于結束時間,會報錯。
如果起始時間是早于當前時間184天之前的時間,則返回數據的起始時間為距當前時間往前數的第184天。
否 EndTime 指定返回管理事件的結束時間。如果同時指定了起始時間和結束時間,則起始時間必須早于結束時間,否則將返回錯誤信息。
類型:時間戳
取值:unix時間戳(UTC),精確到毫秒。默認結束時間為目前時間。
如果StartTime和EndTime都為早于當前時間184天前的時間,則返回距當前時間往前數的第184天那天的數據。
否 LookupAttributes 指定管理事件的查詢屬性。
類型:數組
取值:Attributekey和AttributeValue成對出現。
否 AttributeKey 指定查詢管理事件的屬性Key。
注意如果指定AttributeKey,每次只能指定一個AttributeKey,且取值唯一。
類型:字符串
取值:
EventId。
EventName。
ReadOnly。
UserName。
ResourceType。
ResourceName。
EventSource。
AccessKeyId。
否 AttributeValue 指定AttributeKey對應的值。
類型:字符串
取值:根據AttributeKey確定。其中ResourceName根據前綴匹配查詢,區分大小寫;EventId、UserName、EventName、ResourceType、EventSource、AccessKeyId全字匹配查詢,并且區分大小寫。
否 MaxResults 設置響應中最多返回的條數。如果存在超出您指定的返回項,響應結果中會返回NextToken的值。
類型:整數類型
取值:1-50,默認值為50。
否 NextToken 分頁標識。還有需要返回的管理事件時,上條響應結果中會返回該參數。查看未顯示項時,請求參數中需要攜帶此參數。
類型:字符串
取值:與上條響應結果中的參數值一樣。
否
響應結果
| 名稱 | 描述 |
|---|---|
| Events | 根據查詢條件,返回的管理事件。 |
| NextToken | 分頁標識。如果沒有返回該值,則說明已經返回所有的查詢結果。 |
請求示例
查詢賬戶中的只讀事件。
POST?/?HTTP/1.1
Host:oos-cn-cloudtrail.ctyunapi.cn
x-amz-content-sha256:?UNSIGNED-PAYLOAD
Authorization: SignatureValue
X-Amz-Date:?20200102T071620Z
X-Amz-Target:cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.LookupEvents
Content-Type:application/json
?
{"LookupAttributes":[{"AttributeKey":"ReadOnly","AttributeValue":"true"}]}
響應示例
HTTP/1.1?200?OK
x-amz-request-id:c1a075bc84f4277
Content-Type:?application/json;?charset=utf-8
Content-Length:23994
Date:Thu,?02?Jan?2020?07:16:20?GMT
Server:CTYUN
?
{
????"Events":?[
????????{
????????????"CloudTrailEvent":?{
????????????????"eventId":?"7645426409000523408",
????????????????"resource":?"{\"Resources\":[{\"name\":\"testTrail1\",\"type\":\"CloudTrail?Trail\",\"arn\":\"arn:ctyun:cloudtrail::1rl1uq2mvq6ob:trail/testTrail1\"}]}",
????????????????"eventVersion":?"1.06",
????????????????"eventSource":?"oos-cn.daliqc.cn",
????????????????"requestParameters":?"{\"Name\":\"testTrail1\"}",
????????????????"userAgent":?"oos-cn.daliqc.cn",
????????????????"readOnly":?true,
????????????????"userIdentity":?{
????????????????????"accountId":?"1rl1uq2mvq6ob",
????????????????????"principalId":?"1rl1uq2mvq6ob",
????????????????????"type":?"Root",
????????????????????"arn":?"arn:ctyun:iam::1rl1uq2mvq6ob:root"
????????????????},
????????????????"eventType":?"ApiCall",
????????????????"serviceName":?"CloudTrail",
????????????????"sourceIp":?"127.0.0.1",
????????????????"requestId":?"8bb75b1394fa42cb",
????????????????"requestURL":?"//oos-cn-cloudtrail.ctyunapi.cn/",
????????????????"eventTime":?"2020-01-02T06:13:47Z",
????????????????"eventName":?"GetTrailStatus",
????????????????"requestRegion":?"cn",
????????????????"managementEvent":?true
????????????}
????????},
????????{
????????????"CloudTrailEvent":?{
????????????????"eventId":?"7645426419220464293",
????????????????"eventVersion":?"1.06",
????????????????"eventSource":?"oos-cn.daliqc.cn",
????????????????"requestParameters":?"{\"TrailNameList\":[\"testTrail1\"]}",
????????????????"userAgent":?"oos-cn.daliqc.cn",
????????????????"readOnly":?true,
????????????????userIdentity:
?????????????????{
???????????????????"accessKeyId":"d2756b7f524227e79a83",
???????????????????"accountId":"1fimr2raot5sp",
???????????????????"principalId":"e943d0ae1a3b461bb0a18fb8f2e55d44",
???????????????????"type":"IAMUser",
???????????????????"arn":"arn:ctyun:iam::1fimr2raot5sp:user/subUser",
???????????????????"userName":"subUser"
??????????????????},
????????????????"eventType":?"ApiCall",
????????????????"serviceName":?"CloudTrail",
????????????????"sourceIp":?"127.0.0.1",
????????????????"requestId":?"a8cde8aea5744b74",
????????????????"requestURL":?"//oos-cn-cloudtrail.ctyunapi.cn/",
????????????????"eventTime":?"2020-01-02T06:13:37Z",
????????????????"eventName":?"DescribeTrails",
????????????????"requestRegion":?"cn",
????????????????"managementEvent":?true
????????????}
????????}
????]
}