此操作用来查看账户中的管理事件。用户可以查看近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.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": "http://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.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": "http://oos-cn-cloudtrail.ctyunapi.cn/",
"eventTime": "2020-01-02T06:13:37Z",
"eventName": "DescribeTrails",
"requestRegion": "cn",
"managementEvent": true
}
}
]
}