Management event structure - ActionTrail - Alibaba Cloud Documentation Center

This topic describes the key fields in a management event. This topic also provides an example of a management event.

Key fields

Field	Description
acsRegion	The ID of the region where the management event is generated.
additionalEventData	The additional information about the management event.
apiVersion	If the value of eventType is ApiCall, the management event records an API operation call. In this case, the field indicates the version of the API operation.
eventCategory	The type of the event. Valid values: Management, which indicates a management event.
eventId	The ID of the management event.
eventName	The name of the management event. If the value of eventType is ApiCall, the value of this field is the name of the API operation that is called. If the value of eventType is not ApiCall, the value of this field indicates the operation that is recorded in the management event.
eventRW	The read/write type of the management event. Valid values: Write: indicates a write event. Read: indicates a read event.
eventSource	The source of the management event.
eventTime	The time when the management event is generated, in UTC.
eventType	The type of the operation that is recorded in the management event. Valid values: ApiCall: indicates that an API operation is called. ConsoleOperation: indicates that a management operation is performed in the console or on the buy page of a specific Alibaba Cloud service. ConsoleSignin: indicates a logon to the Alibaba Cloud Management Console. ConsoleSignout: indicates a logoff from the Alibaba Cloud Management Console. AliyunServiceEvent: indicates that Alibaba Cloud performs a management operation on the resources that you own. For example, Alibaba Cloud releases an expired subscription instance.
eventVersion	The format version of the management event. The current version is 1.
errorCode	The error code that is returned when an error occurred during the processing of the API request.
errorMessage	The error message that is returned when an error occurred during the processing of the API request.
requestId	The request ID.
requestParameters	The parameters specified in the API request.
requestParameterJson	The parameters specified in the API request, in the JSON format. This field serves the same purpose as the requestParameters field.
resourceName	The name of the event-associated resource. The name is the unique identifier of the resource. Note The names of resources of the same type are separated by commas (,). The names of resources of different types are separated by semicolons (;).
resourceType	The type of the event-associated resource. Note Multiple resource types are separated by semicolons (;).
responseElements	The response that is returned for the API request.
referencedResources	The resources that are involved in the management event.
serviceName	The name of the Alibaba Cloud service for which the management event is generated.
sourceIpAddress	The IP address from which the management event is generated. Valid values: The address of the client that initiates the request. IPv4 addresses and IPv6 addresses are supported. If the request is initiated by an Alibaba Cloud service, the value is recorded as the cloud service identifier. Example: ecs.aliyuncs.com. If the source IP address belongs to CIDR blocks of a virtual private cloud (VPC) or an internal CIDR block of Alibaba Cloud and you cannot distinguish whether the source IP address is from your VPC, the value is recorded as Internal.
userAgent	The agent that sends the API request.
isGlobal	Indicates whether the event is a global event. Valid values: true false
eventAttributes	The attribute of the event. For more information, see Fields included in eventAttributes.
userIdentity	The identity information about the requester. For more information, see Fields included in userIdentity.

Table 1. Fields included in eventAttributes

Field	Description
SensitiveAction	Indicates whether the operation that is recorded in the event is a sensitive operation. Valid values: true.

Table 2. Fields included in userIdentity

Field	Description
type	The type of the identity. Valid values: root-account: indicates an Alibaba Cloud account. ram-user: indicates a Resource Access Management (RAM) user. assumed-role: indicates a RAM role. system: indicates an Alibaba Cloud service. cloudsso-user: indicates a CloudSSO user. saml-user: indicates an enterprise-specific identity based on Security Assertion Markup Language (SAML). alibaba-cloud-account: indicates the identity that is authorized to perform a cross-account operation. oidc-user: indicates an enterprise-specific identity based on OIDC.
principalId	The ID of the requester. You can use this field together with the type field to confirm the identity of the requester. If the value of the type field is root-account, the value of this field is the ID of the Alibaba Cloud account. If the value of the type field is ram-user, the value of this field is the ID of the RAM user. If the value of the type field is assumed-role, the value of this field is in the `RoleID:RoleSessionName` format. If the value of the type field is cloudsso-user, the value of this field is the ID of the CloudSSO user. If the value of the type field is alibaba-cloud-account, the value of this field is one of the following IDs: If the requester uses an Alibaba Cloud account to perform an operation on resources within another Alibaba Cloud account, the value of this field is the ID of the first Alibaba Cloud account. If the requester uses a RAM user to perform an operation on resources within another Alibaba Cloud account, the value of this field is the ID of the RAM user. If the requester assumes a RAM role to perform an operation on resources within another Alibaba Cloud account, the value of this field is in the `RoleID:RoleSessionName` format. If the value of the type field is saml-user, oidc-user, or system, the principalId field is not recorded.
accountId	The ID of the Alibaba Cloud account of the requester.
accessKeyId	The AccessKey ID that is used by the requester. If the requester sends an API request by using an SDK, this field is recorded. If the requester performs an operation in the Alibaba Cloud Management Console, this field is not recorded. If the requester sends an API request by using a Security Token Service (STS) token, this field is set to the temporary AccessKey ID.
userName	The name of the requester. If the value of the type field is ram-user, the value of this field is the name of the RAM user. If the value of the type field is assumed-role, the value of this field is in the `RoleName:RoleSessionName` format. If the value of the type field is root-account, the value of this field is root. If the value of the type field is cloudsso-user, the value of this field is the name of the CloudSSO user. If the value of the type field is saml-user, the value of this field is the username of an enterprise-specific identity based on SAML. If the value of the type field is alibaba-cloud-account or system, the userName field is not recorded. If the value of the type field is oidc-user, the value of this field is the username of an enterprise-specific identity based on OpenID Connect (OIDC).
sessionContext	The session context that is recorded when the requester sends an API request by using an STS token or performs an operation in the Alibaba Cloud Management Console. The session context includes creationDate and mfaAuthenticated. `creationDate: the time when the STS token is created.` `mfaAuthenticated: indicates whether multi-factor authentication (MFA) is enabled for logons to the Alibaba Cloud Management Console.`

Example

{
  "eventId": "92b33345-0cef-47be-821f-fb9914d3****",
  "eventAttributes": {
    "SensitiveAction": "true"
  },
  "eventVersion": 1,
  "sourceIpAddress": "ecs.aliyuncs.com",
  "userAgent": "ecs.aliyuncs.com",
  "eventRW": "Write",
  "eventType": "ApiCall",
  "referencedResources": {
    "ACS::ECS::Instance": [
      "i-8vb0smn1lf6g77md****"
    ],
    "ACS::ECS::Disk": [
      "d-8vbf8rpv2nn0l1zm****"
    ]
  },
  "userIdentity": {
    "type": "system",
    "userName": "ecs.aliyuncs.com"
  },
  "serviceName": "Ecs",
  "requestId": "32B7EB75-62EE-511E-9449-E19EBF67C2ED",
  "eventTime": "2022-10-22T21:52:00Z",
  "isGlobal": false,
  "acsRegion": "cn-hangzhou",
  "eventName": "DeleteDisk"
}