You can call this operation to retrieve settings for the trail associated with the current region.

Request parameters

Name Type Required Example Description
Action String Yes DescribeTrails The operation that you want to perform. Set the value to DescribeTrails.
RegionId String Yes cn-hangzhou The ID of the region where the instance is located. For more information about the latest list of Alibaba Cloud regions, see DescribeRegions.
NameList String No abc%2cdef The list of trails to be retrieved, separated with commas (,).
IncludeShadowTrails String No true Indicates whether shadow trails are displayed. Valid values: true and false. Default value: false.

Response parameters

A JSON file of TrailList is returned. The following table describes related parameters.

Name Type Example Description
Name String default The name of the trail.
EventRW String Write Indicates whether the event is a read or a write event. Valid values: Read, Write, and All. Default value: Write.
OssBucketName String secloud The name of the specified OSS bucket.
OssBucketLocation String cn-hangzhou The region of the OSS bucket.
OssKeyPrefix String trail1 The prefix of the specified OSS bucket name.
RoleName String aliyunactiontraildefaultrole The role in ActionTrail.
SlsProjectArn String acs:log:cn-shanghai::project/*** The unique ARN of the Log Service project.
SlsWriteRoleArn String acs:ram::***:role/aliyunactiontraildefaultrole The unique ARN of the Log Service role.
RequestId String 145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0 The ID of the request.

Examples

Sample requests

http://actiontrail.cn-hangzhou.aliyuncs.com/?
Action=DescribeTrails
&RegionId=cn-hangzhou
&NameList=abc%2cdef
&<Common request parameters>

Sample responses

JSON format 
{
  "TrailList": [
    {
      "Name": "default",
      "OssBucketName": "secloud",
	  "OssBucketLocation": "cn-hangzhou",
      "OssKeyPrefix": "trail1",
      "RoleName": "aliyunactiontraildefaultrole",
      "SlsProjectArn":"acs:log:cn-shanghai::project/***",
      "SlsWriteRoleArn":"acs:ram::***:role/aliyunactiontraildefaultrole"
    }
  ]
}

Error codes

None.