事件结构

云审计服务用于标示每个操作事件关键字段的详细信息，具体如表1所示。

为方便用户，部分字段在管理控制台呈现时进行了格式优化。
本章节将基于CTS管理控制台进行介绍和描述。

表1 事件的关键字段
字段名称	是否必选	类型	描述
time	是	Long	标识事件产生的时间戳。以当地标准时间进行展示，例如：1660927593570。在接口中，该字段以时间戳格式进行传输和存储。该字段为当地时间1970年01月01日00时00分00秒至现在的总毫秒数。
user	是	UserInfo object	标识触发事件的用户信息。
request	否	Structure	标识事件对应接口请求内容，即资源操作请求体。
response	否	Structure	记录用户请求的响应，标识事件对应接口响应内容，即资源操作结果返回体。
service_type	是	String	标识查询事件列表对应的云服务类型。必须为已对接CTS的云服务的英文缩写，且服务类型一般为大写字母。
resource_type	是	String	查询事件列表对应的资源类型。
resource_account_id	否	String	标识资源所在的账号ID。仅在跨租户操作资源时有值。例如：租户A操作租户B下面的资源，此处为账号B的account_id。说明：在跨租户场景下，如果用户涉及到租户A操作租户B的某个资源的时候，CTS会复制一份审计日志，在租户A和租户B的云审计服务中均可查看该条操作记录。
resource_name	否	String	标识事件对应的资源名称。
resource_id	否	String	标识事件对应的云服务资源ID。
source_ip	是	String	标识触发事件的租户IP。若为系统内调用，则为空。
trace_name	是	String	标识查询事件列表对应的事件名称。
trace_rating	是	String	标识事件等级，分为normal（正常）、warning（警告）和incident（事故）。 normal：代表本次操作成功。 warning：代表本次操作失败。 incident：代表本次操作引起了比失败更严重的后果，比如会造成节点故障或用户业务故障等情况。
trace_type	是	String	标识事件发生源头类型，管理类事件主要包括API调用（ApiCall），Console页面调用（ConsoleAction）和系统间调用（SystemAction）。数据类事件主要包括ObsSDK，ObsAPI。
api_version	否	String	标识事件对应的云服务接口版本。
message	否	Structure	标识其他云服务为此条事件添加的备注信息。
record_time	是	Number	标识云审计服务记录本次事件的时间戳。
trace_id	是	String	标识事件的ID，由系统生成的UUID。
code	否	String	记录用户请求的响应，标识事件对应接口返回的HTTP状态码。
request_id	否	String	记录本次请求的request id。
location_info	否	String	记录本次请求出错后，问题定位所需要的辅助信息。
endpoint	否	String	该操作涉及云资源的详情页面的endpoint。
resource_url	否	String	该操作涉及云资源的详情页面的访问链接（不含endpoint）。
enterprise_project_id	是	String	标识资源所在的企业项目ID。
user_agent	否	String	请求客户端代理标识。
content_length	否	Number	请求消息体的长度。
total_time	否	Number	请求的响应时间。

表2 UserInfo
字段名称	是否必选	类型	描述
type	是	String	操作者的身份类型。
principal_id	是	String	操作用户的身份Id。如果是 IAM 用户身份，格式为 <user-id> 如果是 IAM 委托会话身份，格式为 <agency-id>:<agency-session-name> 如果是 IAM 联邦身份，格式为 <idp_id>:<user-session-name>
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>
account_id	是	String	账号ID。账号ID是指：在控制台右上角用户名的下拉选项中，选择“我的凭证”，在我的凭证页面中的“账号ID”。
access_key_id	是	String	访问密钥ID。
id	是	String	用户ID。用户ID是指：在控制台右上角用户名的下拉选项中，选择“我的凭证”，在我的凭证页面中的“IAM用户ID”。
name	是	String	用户名称。用户名称是指：在控制台右上角用户名的下拉选项中，选择“我的凭证”，在我的凭证页面中获取“IAM用户名”。
domain	是	BaseUser object	标识触发事件的用户domain信息。
user_name	是	String	用户名称。说明：user_name与name字段的含义一致。
principal_is_root_user	是	String	是否是根用户。值为“true”时，表示操作者是根用户。值为“false”时，表示操作者是委托会话身份、联邦身份或非根用户的IAM用户。
invoked_by	是	Array of strings	发出请求的服务的名称。控制台操作时为["service.console" ]
session_context	否	SessionContext object	临时安全凭据属性。

表3 BaseUser
字段名称	是否必选	类型	描述
id	是	String	账号ID。账号ID是指：在控制台右上角用户名的下拉选项中，选择“我的凭证”，在我的凭证页面中的“账号ID”。
name	是	String	账号名称。账号名称是指：在控制台右上角用户名的下拉选项中，选择“我的凭证”，在我的凭证页面中的“账号名”。