Queries created trails.
Operation description
This topic shows you how to query the information about the single-account trails within an Alibaba Cloud account. In this example, the information about a trail named test-4
is returned.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
IncludeShadowTrails | boolean | No | Specifies whether to return the information about shadow trails. Valid values:
| false |
NameList | string | No | The names of the trails whose information you want to query. Separate multiple trail names with commas (,). | abc,def |
IncludeOrganizationTrail | boolean | No | Specifies whether to query the information about multi-account trails. Valid values:
| false |
For more information about common request parameters, see Common parameters.
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "ED8BC689-69DA-42AC-855E-3B06C1271194",
"TrailList": [
{
"TrailRegion": "All",
"Status": "Enable",
"UpdateTime": "2021-04-06T02:16:24Z",
"HomeRegion": "cn-hangzhou",
"CreateTime": "2021-03-01T06:27:28Z",
"OssKeyPrefix": "trail1",
"EventRW": "All",
"StartLoggingTime": "2021-04-06T02:08:38Z",
"OssWriteRoleArn": "acs:ram::***:role/aliyunserviceroleforactiontrail",
"SlsProjectArn": "acs:log:cn-qingdao:159498693826****:project/zhengze-audit-log",
"IsOrganizationTrail": false,
"SlsWriteRoleArn": "acs:ram::159498693826****:role/aliyunserviceroleforactiontrail",
"StopLoggingTime": "2021-04-06T02:09:04Z",
"Name": "test-4",
"OssBucketName": "secloud",
"Region": "cn-hangzhou",
"OrganizationId": "rd-EV****",
"OssBucketLocation": "oss-cn-hangzhou",
"TrailArn": "acs:actiontrail:cn-hangzhou:159498693826****:trail/test-delivery-other"
}
]
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidTrailNameException | The specified Trail name is invalid. | The specified Trail name is not valid. |
400 | InvalidQueryParameter | The specified query parameter is invalid. | The specified query parameter is not valid. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-01-09 | The Error code has changed. The response structure of the API has changed | View Change Details |
2021-08-18 | The Error code has changed. The response structure of the API has changed | View Change Details |