文档首页/ 云审计服务 CTS/ API参考（安卡拉区域）/ API/ 事件管理/ 查询事件列表

更新时间：2025-07-18 GMT+08:00

在线调试

CLI示例

查看PDF

查询事件列表

功能介绍

通过事件列表查询接口，可以查出系统记录的7天内资源操作记录。

调用方法

请参见如何调用API。

URI

GET /v3/{project_id}/traces

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，参见获取账号ID和项目ID章节。

表2 Query参数
参数	是否必选	参数类型	描述
trace_type	是	String	标识审计事件类型。目前支持管理类事件（system）和数据类事件（data）。默认值为"system"。
from	否	Long	标识查询事件列表的起始时间戳（timestamp，为标准UTC时间，毫秒级，13位数字，不包括传入时间）默认为上一小时的时间戳。查询条件from与to配套使用。
next	否	String	取值为响应中中marker的值，用于标识查询事件的起始时间（自此条事件的记录时间起，向更早时间查询）。可以与“from”、“to”结合使用。最终的查询条件取两组时间条件的交集。
to	否	Long	标识查询事件列表的结束时间戳（timestamp，为标准UTC时间，毫秒级，13位数字，不包括传入时间）默认为当前时间戳。查询条件to与from配套使用。
tracker_name	否	String	当"trace_type"字段值为"system"时，该字段值默认为"system"。当"trace_type"字段值为"data"时，该字段值可以传入数据类追踪器名称，达到筛选某个数据类追踪器下的数据事件目的。
service_type	否	String	标识查询事件列表对应的云服务类型。必须为已对接CTS的云服务的英文缩写，且服务类型一般为大写字母。当"trace_type"字段值为"system"时，该字段筛选有效"。已对接的云服务列表参见《云审计服务用户指南》“支持审计的服务及详细操作列表”章节。
user	否	String	标识特定用户名称，用以查询该用户下的所有事件。当"trace_type"字段值为"system"时，该字段筛选有效"。
resource_name	否	String	标示查询事件列表对应的的资源名称。当"trace_type"字段值为"system"时，该字段筛选有效"。说明：该字段可能包含大写字母。
resource_type	否	String	标示查询事件列表对应的资源类型。当"trace_type"字段值为"system"时，该字段筛选有效"。
resource_id	否	String	标示查询事件列表对应的云服务资源ID。当"trace_type"字段值为"system"时，该字段筛选有效"。
limit	否	Integer	标示查询事件列表中限定返回的事件条数。不传时默认10条，最大值200条。
trace_id	否	String	标示某一条事件的事件ID。当传入这个查询条件时，其他查询条件自动不生效。当"trace_type"字段值为"system"时，该字段筛选有效"。
trace_name	否	String	标示查询事件列表对应的事件名称。当"trace_type"字段值为"system"时，该字段筛选有效"。说明：该字段可能包含大写字母。
trace_rating	否	String	标示查询事件列表对应的事件等级目前有三种：正常(normal), 警告(warning),事故(incident)。当"trace_type"字段值为"system"时，该字段筛选有效"。
access_key_id	否	String	标示查询事件列表对应的访问密钥ID。包含临时访问凭证和永久访问密钥。
enterprise_project_id	否	String	标示查询事件列表对应的企业项目ID。

请求参数

无

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
traces	Array of Traces objects	本次查询事件列表返回事件数组。
meta_data	MetaData object	本次查询事件条数和标记位。

表4 Traces
参数	参数类型	描述
resource_id	String	标识事件对应的云服务资源ID。
trace_name	String	标识查询事件列表对应的事件名称。由0-9,a-z,A-Z,'-','.','_',组成，长度为1～64个字符，且以首字符必须为字母。
trace_rating	String	标识事件等级，目前有三种：正常（normal），警告（warning），事故（incident）。
trace_type	String	标识事件发生源头类型，管理类事件主要包括API调用（ApiCall），Console页面调用（ConsoleAction）和系统间调用（SystemAction）。数据类事件主要包括ObsSDK，ObsAPI。
request	String	标识事件对应接口请求内容，即资源操作请求体。
response	String	记录用户请求的响应，标识事件对应接口响应内容，即资源操作结果返回体。
code	String	记录用户请求的响应，标识事件对应接口返回的HTTP状态码。
api_version	String	标识事件对应的云服务接口版本。
message	String	标识其他云服务为此条事件添加的备注信息。
record_time	Long	标识云审计服务记录本次事件的时间戳。
trace_id	String	标识事件的ID，由系统生成的UUID。
time	Long	标识事件产生的时间戳。
user	UserInfo object	标识触发事件的用户信息。
service_type	String	标识查询事件列表对应的云服务类型。必须为已对接CTS的云服务的英文缩写，且服务类型一般为大写字母。
resource_type	String	查询事件列表对应的资源类型。
source_ip	String	标识触发事件的租户IP。
resource_name	String	标识事件对应的资源名称。
request_id	String	记录本次请求的request id
location_info	String	记录本次请求出错后，问题定位所需要的辅助信息。
endpoint	String	云资源的详情页面
resource_url	String	云资源的详情页面的访问链接（不含endpoint）
enterprise_project_id	String	标识资源所在的企业项目ID。
resource_account_id	String	标识资源所在的账号ID。仅在跨租户操作资源时有值。
read_only	Boolean	标识用户请求是不是只读。
operation_id	String	记录事件对应的操作ID。

表5 UserInfo
参数	参数类型	描述
id	String	用户ID，参见《云审计服务API参考》“获取账号ID和项目ID”章节。
name	String	用户名称。
user_name	String	用户名称。
domain	BaseUser object	标识触发事件的用户domain信息。
account_id	String	账号ID，参见《云审计服务API参考》“获取账号ID和项目ID”章节。
access_key_id	String	访问密钥ID。
principal_urn	String	操作用户身份的 URN。如果是 IAM 用户身份，格式如iam::<account-id>:user:<user-name> 如果是 IAM 委托会话身份，格式如sts::sts::<account-id>:assumed-agency:<agency-name>/<agency-session-name> 如果是 IAM 联邦身份，格式如sts::<account-id>:external-user:<idp_id>/<user-session-name>
principal_id	String	操作用户身份Id。如果是 IAM 用户身份，格式为<user-id> 如果是 IAM 委托会话身份，格式为<agency-id>:<agency-session-name> 如果是 IAM 联邦身份，格式为<idp_id>:<user-session-name>
principal_is_root_user	String	是否是根用户。值为“true”时，表示操作者是根用户。值为“false”时，表示操作者是委托会话身份、联邦身份或非根用户的 IAM 用户。
type	String	操作者身份类型。
invoked_by	Array of strings	发出请求的服务的名称。控制台操作时为["service.console" ]
session_context	SessionContext object	临时安全凭据属性。

表6 BaseUser
参数	参数类型	描述
id	String	账号ID，参见《云审计服务API参考》“获取账号ID和项目ID”章节。
name	String	账号名称。

表7 SessionContext
参数	参数类型	描述
attributes	Attributes object	临时安全凭据的属性。

表8 Attributes
参数	参数类型	描述
created_at	String	颁发临时安全凭证时的时间（timestamp，为标准UTC时间，毫秒级，13位数字）。
mfa_authenticated	String	是否已经通过MFA身份认证。

表9 MetaData
参数	参数类型	描述
count	Integer	标识本次查询事件列表返回的事件记录的总条数。
marker	String	标识本次查询事件列表返回的最后一个事件ID。可以使用这个参数返回值作为分页请求参数next的值，如果marker返回为null，则表示当前请求条件下查询事件列表已经全部返回没有下一页。

状态码：400

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	错误码标识，CTS.XXX。
error_msg	String	错误描述。

状态码：401

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	错误码标识，CTS.XXX。
error_msg	String	错误描述。

状态码：403

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	错误码标识，CTS.XXX。
error_msg	String	错误描述。

状态码：404

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	错误码标识，CTS.XXX。
error_msg	String	错误描述。

状态码：500

**表14** 响应Body参数
参数	参数类型	描述
error_code	String	错误码标识，CTS.XXX。
error_msg	String	错误描述。

状态码：503

**表15** 响应Body参数
参数	参数类型	描述
error_code	String	错误码标识，CTS.XXX。
error_msg	String	错误描述。

请求示例

查询管理类事件请求样例。

GET https://{endpoint}/v3/{project_id}/traces?limit=11&to=1479095278000&from=1478490478000&trace_name=createTracker&resource_type=tracker&service_type=CTS&trace_type=system

查询数据类事件请求样例。

GET https://{endpoint}/v3/{project_id}/traces?limit=11&to=1479095278000&from=1478490478000&trace_type=data

响应示例

状态码：200

请求正常。

{
  "traces" : [ {
    "request" : "",
    "code" : "204",
    "source_ip" : "192.168.0.92",
    "trace_type" : "ConsoleAction",
    "read_only" : false,
    "operation_id" : "DeletePublicip",
    "trace_id" : "9650eb5a-f57c-11ef-8503-ef3069828c92",
    "trace_name" : "deleteEip",
    "resource_type" : "publicip",
    "trace_rating" : "normal",
    "api_version" : "v3",
    "message" : "",
    "service_type" : "EIP",
    "response" : "",
    "resource_id" : "3224b58b-fca5-4902-a2a3-05757f29da22",
    "resource_account_id" : "230657***34fcd9",
    "time" : 1740710091805,
    "resource_name" : "-",
    "request_id" : "4eb208ad0b84115d2825c1f1b4482ff1",
    "user" : {
      "access_key_id" : "HSTAM5***37Z39R",
      "invoked_by" : [ "service.console" ],
      "account_id" : "230657***34fcd9",
      "user_name" : "test",
      "domain" : {
        "name" : "paas_cts_z00418070_01",
        "id" : "230657***34fcd9"
      },
      "name" : "test",
      "session_context" : {
        "attributes" : {
          "created_at" : "1740710036558",
          "mfa_authenticated" : "false"
        }
      },
      "principal_is_root_user" : "false",
      "id" : "969ba3***28d3d0",
      "principal_urn" : "iam::230657***34fcd9:user:test",
      "type" : "User",
      "principal_id" : "969ba3***28d3d0"
    },
    "record_time" : 1740710091805
  }, {
    "request" : "tag_types=predefine&domainId=230657***34fcd9",
    "trace_id" : "7f64160a-f57c-11ef-8503-ef3069828c92",
    "code" : "200",
    "trace_name" : "getResourceTags",
    "resource_type" : "tags",
    "trace_rating" : "normal",
    "api_version" : "1.0",
    "source_ip" : "10.63.127.2",
    "trace_type" : "ConsoleAction",
    "service_type" : "TMS",
    "read_only" : true,
    "operation_id" : "GetResourceTags",
    "resource_account_id" : "230657***34fcd9",
    "time" : 1740710053352,
    "user" : {
      "access_key_id" : "HSTAM5***37Z39R",
      "invoked_by" : [ "service.console" ],
      "account_id" : "230657***34fcd9",
      "user_name" : "test",
      "domain" : {
        "name" : "paas_cts_z00418070_01",
        "id" : "230657***34fcd9"
      },
      "name" : "test",
      "session_context" : {
        "attributes" : {
          "created_at" : "1740710036558",
          "mfa_authenticated" : "false"
        }
      },
      "principal_is_root_user" : "false",
      "id" : "969ba3***28d3d0",
      "principal_urn" : "iam::230657***34fcd9:user:test",
      "type" : "User",
      "principal_id" : "969ba3***28d3d0"
    },
    "record_time" : 1740710053352
  } ],
  "meta_data" : {
    "count" : 2
  }
}

状态码

状态码	描述
200	请求正常。
400	查询参数异常，请求未完成。
401	请求鉴权校验失败，访问被拒绝。
403	请求权限校验失败，访问被禁止。
404	查询事件不存在，请求未完成。
500	服务内部异常，请求未完成。
503	被请求的服务无效。建议直接修改该请求，不要重试该请求。

错误码

请参见错误码。

父主题： 事件管理

上一篇：事件管理

下一篇：追踪器管理

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消