文档简介:
LookupEvents
此操作用来查看账户中的管理事件。用户可以查看过去180天内发生的管理事件。
支持查询以下属性:
l OOS访问密钥;
l 管理事件ID;
l 管理事件名称;
l 管理事件来源;
l 是否只读;
l 资源名称;
l 资源类型;
l 子用户名。
所有的属性都是可选项,默认返回50个查询结果,一次最多只能返回50个结果,如果想查看其他结果,可以通过设置MaxResults和NextToken来进行查看。
l 请求参数
名称 |
描述 |
是否必填 |
StartTime |
指定返回管理事件的起始时间。如果同时指定了起始时间和结束时间,则起始时间必须早于结束时间,否则将返回错误信息。 类型:时间戳。 取值:unix时间戳(UTC),精确到毫秒。默认起始时间为距当前时间往前数的第180天。 l 如果起始时间晚于结束时间,会报错。 l 如果起始时间是早于当前时间180天之前的时间,则返回数据的起始时间为距当前时间往前数的第180天。 |
否 |
EndTime |
指定返回管理事件的结束时间。如果同时指定了起始时间和结束时间,则起始时间必须早于结束时间,否则将返回错误信息。 类型:时间戳。 取值:unix时间戳(UTC),精确到毫秒。默认结束时间为目前时间。 如果StartTime和EndTime都为早于当前时间180天前的时间,则返回距当前时间往前数的第180天那天的数据。 |
否 |
LookupAttributes |
指定管理事件的查询属性。 类型:字符串。 取值:Attributekey和AttributeValue成对出现。 |
否 |
AttributeKey |
指定查询管理事件的属性Key。 注意:如果指定AttributeKey,每次只能指定一个AttributeKey,且取值唯一。 类型:字符串。 取值: l EventId l EventName l ReadOnly l UserName l ResourceType l ResourceName l EventSource l AccessKeyId |
否 |
AttributeValue |
指定AttributeKey对应的值。 类型:字符串。 取值:根据AttributeKey确定。其中ResourceName根据前缀匹配查询,区分大小写;EventId、UserName、EventName、ResourceType、EventSource、AccessKeyId全字匹配查询,并且区分大小写。 |
否 |
MaxResults |
设置响应中最多返回的条数。如果存在超出您指定的返回项,响应结果中会返回NextToken的值。 类型:整数类型。 取值:1-50,默认值为50。 |
否 |
NextToken |
分页标识。还有需要返回的管理事件时,上条响应结果中会返回该参数。查看未显示项时,请求参数中需要携带此参数。 类型:字符串。 取值:与上条响应结果中的参数值一样。 |
否 |
l 响应结果
名称 |
描述 |
Events |
根据查询条件,返回的管理事件。 |
NextToken |
分页标识。如果没有返回该值,则说明已经返回所有的查询结果。 |
l 请求示例
查询账户中的只读事件。
Host:oos-cn-cloudtrail.ctyunapi.cn Authorization:signatureValue X-Amz-Date:date X-Amz-Target:cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.LookupEvents Content-Type:application/json
{"LookupAttributes":[{"AttributeKey":"ReadOnly","AttributeValue":"true"}]} |
l 返回示例
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.ctyun.cn", "requestParameters": "{\"Name\":\"testTrail1\"}", "userAgent": "oos-cn.ctyun.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": "/", "eventTime": "2020-01-02T06:13:47Z", "eventName": "GetTrailStatus", "requestRegion": "cn", "managementEvent": true } }, { "CloudTrailEvent": { "eventId": "7645426419220464293", "eventVersion": "1.06", "eventSource": "oos-cn.ctyun.cn", "requestParameters": "{\"TrailNameList\":[\"testTrail1\"]}", "userAgent": "oos-cn.ctyun.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": "/", "eventTime": "2020-01-02T06:13:37Z", "eventName": "DescribeTrails", "requestRegion": "cn", "managementEvent": true } } ] } |