• 热门
  • 基础
  • 数据库
  • 安全
  • 大数据
  • 人工智能
  • 混合云
  • 开发与运维
  • 企业应用

应用服务

行业引擎

全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

获取历史事件记录

接口说明

查询本账号内操作日志的列表信息。金山云账号或被授权的子用户可以调用该接口。
注:普通页面展示用Page与PageSize参数,此方法有限制,Page与PageSize相乘如果大于10000条会返回错误。

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:ListOperateLogs。
Version String
公共参数,本接口取值:2019-04-01。
EventName String

事件名称,为操作的接口Action名称

示例值:ListUsers
EventRw String

事件类型:read(读操作),write(写操作);不传则查询所有类型操作

示例值:read
ServiceName String

服务名称

示例值:iam
UserName String

调用者的名称。

  • 如果是主账号,显示为root。
  • 如果为子用户未IAM子用户名称。
示例值:root
AccessKey String

支持使用AccessKeyID查询对应调用事件记录。

EventBeginDate String

事件开始日期,格式为YYYY-MM-DD

EventEndDate String

事件结束日期,格式为YYYY-MM-DD

ResourceType String

资源类型

示例值:User
ResourceName String

资源名称

示例值:name
Page String

页码,默认1

PageSize String

每页查询个数,默认10

SearchAfter String

上次请求返回的最后一条数据的游标

示例值:[1634642507000,"a7bcb04f-b8c5-4cf6-8885-4e3c2cf10033"]

返回参数

参数名称
类型
描述
Total Int

返回的总事件数量

Events Object[]

事件列表

ErrorMessage String

错误信息,例如:The request was rejected because the old password was incorrect

CreateTime String

事件的创建时间

ServiceName String

事件相关的云服务名称,例如iam

EventSource String

事件来源。例如 iam.inner.api.ksyun.com

ApiVersion String

API的版本号

RequestParameters Object

API请求的输入参数。

SourceIpAddress String

事件发起的源IP地址。

EventVersion String
EventType String

发生的事件类型。取值:
ApiCall:API调用事件。大多金山云控制台基于API开发,对应的操作行为也会记录为ApiCall。
ConsoleSignin:控制台登录事件。

EventId String

事件ID。操作审计为每个管控事件所产生的一个UUID。
例如55733e91-4e3b-4******b-053787278d2e

EventRw String

事件的读写类型。
read:读类型
write:写类型

EventName String

事件名称。
如果eventType取值为ApiCall,该字段为API的名称。
如果eventType取值不为ApiCall,该字段为简单的英文短句,表示事件含义。

UserIdentity Object

请求者的身份信息。

RoleName String

如果是角色访问,则记录为角色名称

AccountId String

金山云账号ID

UserName String

如果是金山云主账号,记录为root
如果是IAM子用户,记录为username
如果为IAM角色,则记录accouid:rolename

AccessKey String

如果请求者通过Openapi访问API,则记录该字段。如果请求者通过控制台登录,则该字段不显示。

ReferencedResources Object[]

事件影响的资源列表。

ErrorCode String

错误码

Region String

地域,例如cn-beijing-6

RequestId String

请求ID。例如ae7d9265-c82d-4f15-b98a-67ef278ff129

EventTime String

事件的发生时间。例如:2021-08-10 17:40:59

UserAgent String
ResourceType String

资源类型

ResourceName String

资源名称

RegionCn String

地域中文名称,例如华北1(北京)

SearchAfter Long

记录查询结果列表最后一条数据的游标

RequestId String

请求ID

请求示例

curl -X GET
'http://actiontrail.api.ksyun.com/?Action=ListOperateLogs&Version=2019-04-01&EventName=xxx&EventRw=xxx&ServiceName=xxx&UserName=xxx&AccessKey=xxx&EventBeginDate=xxx&EventEndDate=xxx&ResourceType=xxx&ResourceName=xxx&Page=xxx&PageSize=xxx&SearchAfter=xxx'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/json'
-H 'host: actiontrail.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'

返回示例

JSON格式

{
"Total":1,
"Events":[
{
"ErrorMessage":"",
"CreateTime":"2021-10-19 19:21:42",
"ServiceName":"iam",
"EventSource":"iam.inner.api.ksyun.com",
"ApiVersion":"2015-11-01",
"RequestParameters":{
"Version":"2015-11-01",
"NewRealName":"***",
"UserName":"***",
"Action":"UpdateUser",
"AccountId":"2000****52"
},
"SourceIpAddress":"10.64.22.2",
"EventVersion":"1",
"EventType":"ApiCall",
"EventId":"618b6df3-163e-4594-8677-72c4e380d489",
"EventRw":"write",
"EventName":"UpdateUser",
"UserIdentity":{
"RoleName":"",
"AccountId":"2000110852",
"UserType":"Account",
"UserName":"root",
"AccessKey":""
},
"ReferencedResources":{
"User":"***"
},
"ErrorCode":"",
"Region":"cn-beijing-6",
"RequestId":"ee43b2f4-bfb1-***b-8e97-33393bfda5af",
"EventTime":"2021-10-19 19:21:42",
"UserAgent":"GuzzleHttp/6.2.0 curl/7.19.7 PHP/5.5.30",
"ResourceType":"user",
"ResourceName":"***",
"RegionCn":"华北1(北京)"
}
],
"SearchAfter":"[1634640179000,"1f44a762-f4f6-437f-878a-b7ade456249c"]",
"RequestId":"6505cf9f-d6bc-4bfc-a6c9-3df4229e8406"
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
InvalidParameterValueAn invalid or out-of-range value was supplied for the input parameter.400参数格式/取值范围不对,具体参数名在错误消息中说明
纯净模式常规模式

纯净模式

点击可全屏预览文档内容

聆听反馈

鼠标选中内容,快速反馈问题

如果在文档使用中出现问题,可选中有问题的部分进行快速反馈,我们将跟进处理。
不再提示
好的,我知道了