All Products
Search
Document Center

ActionTrail:PutInsightSelectors

Last Updated:Jan 26, 2026

Specifies the types of Insights events to deliver for a trail.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

TrailName

string

Yes

The name of the trail.

trail-name

InsightSelectors

string

No

The types of Insights events that the trail should deliver.

[{"insightType":"AkInsight"},{"insightType":"IpInsight"}]

Response elements

Element

Type

Description

Example

object

InsightSelectors

array

An array of Insights event types.

string

An Insights event type.

{"insightType":"AkInsight"}

RequestId

string

The request ID.

7EC26DF0-35AC-5F37-82B3-F5545D0A****

TrailArn

string

The Alibaba Cloud Resource Name (ARN) of the trail.

acs:actiontrail:cn-shanghai:159498693826****:trail/trail-name

Examples

Success response

JSON format

{
  "InsightSelectors": [
    "{\"insightType\":\"AkInsight\"}"
  ],
  "RequestId": "7EC26DF0-35AC-5F37-82B3-F5545D0A****",
  "TrailArn": "acs:actiontrail:cn-shanghai:159498693826****:trail/trail-name"
}

Error codes

HTTP status code

Error code

Error message

Description

404

InsightSelectorDoesNotExistException

The special Selector is not existed.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.