# Alibaba Cloud ActionTrail API

> Alibaba Cloud ActionTrail API on Apizie: 49 endpoints (Creates an advanced event query history record. You can save custom query conditional statements for reuse…, Creates an advanced query template, Creates a data backfill task, Creates a trail to deliver events to a destination for long-term storage and analysis, such as an Object…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-actiontrail`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/actiontrail
- Page: https://zieapi.vercel.app/api/cloud/aliyun-actiontrail
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-actiontrail/openapi.json

Alibaba Cloud OpenAPI for ActionTrail (actiontrail, version 2020-07-06). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates an advanced event query history record. You can save custom query conditional statements for reuse…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/create-advanced-query-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| QuerySql | string | no | The query conditional statement. You can edit the query statement based on the https://help.aliyun.com/document_detail/2557373.html |
| SimpleQuery | string | yes | Specifies whether to enable the simple query mode |
| DryRun | string | no | Specifies whether to perform only a dry run. If this parameter is set to true, the system only checks the access link required for… |

### Creates an advanced query template
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/create-advanced-query-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TemplateName | string | no | The name of the template, which can contain a maximum of 64 characters. Uniqueness is not required |
| TemplateSql | string | yes | The query statement of the template |
| SimpleQuery | string | yes | Specifies whether to enable the simple query mode |

### Creates a data backfill task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/create-delivery-history-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TrailName | string | yes | The name of the trail |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. The value is generated by the client and must be globally unique.… |

### Creates a trail to deliver events to a destination for long-term storage and analysis, such as an Object…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/create-trail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| Name | string | yes | The name of the trail. Length: 6 to 36 characters. Characters: Lowercase letters, digits, hyphens (-), and underscores (_). Must start… |
| OssBucketName | string | no | The name of the OSS bucket to which ActionTrail delivers events. Length: 3 to 63 characters. Characters: Lowercase letters, digits, and… |
| OssKeyPrefix | string | no | The prefix for the names of log files that ActionTrail delivers to your OSS bucket. Length: 6 to 32 characters. Characters: Letters,… |
| OssWriteRoleArn | string | no | The Alibaba Cloud Resource Name (ARN) of the RAM role that ActionTrail assumes to deliver events to the OSS bucket. If you do not specify… |
| SlsProjectArn | string | no | The ARN of the SLS project to which ActionTrail delivers events. You must specify a destination for the trail by providing at least one of… |
| SlsWriteRoleArn | string | no | The ARN of the RAM role that ActionTrail assumes to deliver events to the SLS project. If this parameter is not specified, ActionTrail… |
| EventRW | string | no | Specifies the read/write type of events that the trail delivers. Valid values: Write: Write events. Read: Read events. All (default): All… |
| TrailRegion | string | no | The region in which the trail is created. By default, a trail is created in all regions and this parameter is set to `All`. To create a… |
| IsOrganizationTrail | string | no | Specifies whether the trail is a multi-account trail. Valid values: true false (default) To create a trail for an organization, set this… |
| MaxComputeProjectArn | string | no | The ARN of the MaxCompute project to which ActionTrail delivers events. You must specify a destination for the trail by providing at least… |
| MaxComputeWriteRoleArn | string | no | The ARN of the RAM role that ActionTrail assumes to deliver events to the MaxCompute project. If this parameter is not specified,… |

### Deletes an advanced query record
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/delete-advanced-query-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| QueryId | string | yes | The ID of the advanced query record |

### Deletes an advanced query template
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/delete-advanced-query-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TemplateId | string | no | The ID of the template |

### Deletes the data event selector for a specified trail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/delete-data-event-selector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TrailName | string | yes | The name of the trail |

### Deletes a data backfill task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/delete-delivery-history-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| JobId | integer | yes | The ID of the historical event delivery task to be deleted. You can call the https://help.aliyun.com/document_detail/188101.html operation… |

### Deletes a trail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/delete-trail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| Name | string | yes | The name of the trail that you want to delete. The name must be 6 to 36 characters in length. The name must start with a lowercase letter… |

### Queries all advanced query records
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-advanced-query-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |

### Queries advanced query templates
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-advanced-query-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TemplateName | string | no | The name of the template. This operation performs a case-insensitive, fuzzy match. If you do not specify a name, all templates are… |
| PageNumber | integer | no | The page number. The value starts from 1. Default value: 1 |
| PageSize | integer | no | The maximum number of results to return. Default value: 20 |

### Queries the Alibaba Cloud regions that are supported by ActionTrail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| AcceptLanguage | string | no | The language of the region names. Valid values: zh-CN: Chinese. en-US (default): English |

### Queries the lifecycle events of a specified resource
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-resource-life-cycle-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| ServiceName | string | no | The name of the Alibaba Cloud service |
| ResourceType | string | no | The resource type |

### Queries all advanced query scenarios
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-scenes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| SearchCode | string | no | The search keyword. This operation performs a case-insensitive, fuzzy match |

### Queries the advanced query system templates for a specified scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-search-templates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| SceneId | string | yes | The scenario ID |
| PageNumber | integer | no | The page number. Default value: 1 |
| PageSize | integer | no | The maximum number of results to return. Default value: 20 |

### Retrieves delivery monitoring metrics
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-trail-delivery-metric-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| MetricName | string | yes | The monitoring metrics name. Valid values: delivery_sls_success_count: the number of logs successfully delivered to Simple Log Service… |
| TrailName | string | yes | The trail name |
| StartTime | string | yes | The start time. Format: 2026-02-25T00:35:00Z |
| EndTime | string | yes | The end time. The format is the same as StartTime |
| Period | integer | yes | The statistical period of the monitoring data. The minimum value is 60. Multiples of 60 are supported. Recommended values: 60, 900, and… |

### Queries the list of created trails
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-trails` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| IncludeShadowTrails | string | no | Specifies whether to display shadow trails. Valid values: false (default): Shadow trails are not displayed. true: Shadow trails are… |
| NameList | string | no | The list of trail names to query. Separate multiple names with commas (,) |
| IncludeOrganizationTrail | string | no | Specifies whether to query multi-account trails. Valid values: true: Queries multi-account trails. false (default): Queries single-account… |

### Queries the number of daily alerts within a specific time range
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-user-alert-count` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| StartDate | string | no | The start time. Format: yyyy-MM-dd |
| EndDate | string | no | The end time. Format: yyyy-MM-dd |

### Queries the number of daily logs within a specific time range
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-user-log-count` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| StartDate | string | no | The start time. Format: yyyy-MM-dd |
| EndDate | string | no | The end time. Format: yyyy-MM-dd |

### Queries the number of enabled trails, including organization trails
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/describe-user-trail-count` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |

### Disables a specific type of Insights event
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/disable-insight` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| InsightType | string | no | The type of the Insights event. Valid values: IpInsight: IP request events. ApiCallRateInsight: High-risk API call events.… |

### Enables the Insights feature
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/enable-insight` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| InsightType | string | no | The type of the Insights event. Valid values: IpInsight: IP address request events. ApiCallRateInsight: Unusual API call events.… |

### Queries the most recent events associated with a specified AccessKey pair, including the event name, source,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-access-key-last-used-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| AccessKey | string | yes | The AccessKey ID |
| ServiceName | string | yes | The Alibaba Cloud service. For more information about the Alibaba Cloud services supported by ActionTrail, see… |
| NextToken | string | no | The token that determines the start point of the query. The request parameters must be the same as those of the last request |
| PageSize | string | no | The number of entries to return on each page. Valid values: 0 to 100. Default value: 20 |

### Queries the most recent usage record of a specified AccessKey pair
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-access-key-last-used-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| AccessKey | string | yes | The AccessKey ID |

### Queries the IP addresses most recently used by a specified AccessKey pair
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-access-key-last-used-ips` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| AccessKey | string | yes | The AccessKey ID |
| ServiceName | string | yes | The Alibaba Cloud service. For more information about the Alibaba Cloud services supported by ActionTrail, see… |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. You must specify the token that is obtained from… |
| PageSize | string | no | The number of entries per page. Valid values: 0 to 100. Default value: 20 |

### Queries the Alibaba Cloud services most recently accessed by a specified AccessKey pair
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-access-key-last-used-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| AccessKey | string | yes | The AccessKey ID |

### Queries the resources most recently used by a specified AccessKey pair
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-access-key-last-used-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| AccessKey | string | yes | The AccessKey ID |
| ServiceName | string | yes | The Alibaba Cloud service. For more information about the Alibaba Cloud services supported by ActionTrail, see… |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. The request parameters must be the same as those… |
| PageSize | string | no | The number of entries per page. Valid values: 0 to 100. Default value: 20 |

### Retrieves information about a single advanced template
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-advanced-query-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TemplateId | string | yes | The template ID |

### Retrieves the details of data event selectors for a specified trail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-data-event-selector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TrailName | string | yes | The trail name |

### Queries the details of a historical event delivery task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-delivery-history-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| JobId | integer | yes | The task ID |

### Queries the region where global events are stored
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-global-events-storage-region` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |

### Queries the governance metrics of ActionTrail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-governance-metrics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |

### Queries the Insights event types to deliver for a trail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-insight-selectors` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TrailName | string | yes | The name of the trail |

### Queries all enabled types of Insights events
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-insight-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |

### Queries the number of Insights events for the current account
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-insights-events-count` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| Date | string | no | The date to query. The format is `yyyy-MM-dd` |
| EndTime | string | no | The end of the time range to query. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in… |
| StartTime | string | no | The beginning of the time range to query. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be… |

### Queries the status of a trail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/get-trail-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| Name | string | yes | The name of the trail. The name must be 6 to 36 characters in length, must start with a lowercase letter, and can contain lowercase… |
| IsOrganizationTrail | string | no | Specifies whether to query the status of a multi-account trail. Valid values: true: queries the status of a multi-account trail. false… |

### Lists all data event selectors
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/list-data-event-selectors` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token. Used to request the next page of results. Leave this parameter empty for the first request. For subsequent requests,… |
| MaxResults | integer | no | The maximum number of results to return. Valid values: 1 to 100. Default value: 20 |

### Queries the services that support data events and the names of these events
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/list-data-event-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the… |
| MaxResults | integer | no | The maximum number of results to return. Valid values: 1 to 100. Default value: 20 |

### Queries the list of historical event delivery tasks
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/list-delivery-history-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| PageSize | integer | no | The number of entries per page in a paged query. Valid values: 1 to 100. Default value: 20 |
| PageNumber | integer | no | The page number of the task list. Minimum value: 1. Default value: 1 |

### Retrieves detailed historical management events
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/lookup-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The token that is used to request the next page of results. The request parameters must be the same as those in the previous request |
| MaxResults | string | no | The maximum number of results to return. Valid values: 1 to 50 |
| StartTime | string | no | The start time of the time range to query. The time follows the ISO 8601 standard and is in UTC. Format: `YYYY-MM-DDThh:mm:ssZ`. StartTime… |
| EndTime | string | no | The end time of the time range to query. The time follows the ISO 8601 standard and is in UTC. Format: `YYYY-MM-DDThh:mm:ssZ`. StartTime… |
| Direction | string | no | The order in which events are retrieved. Valid values: FORWARD: chronological order. BACKWARD (default): reverse chronological order |
| LookupAttribute | string | no | The query conditions. You can specify only one or two query conditions at a time. For more information, see… |

### Queries Insights events
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/lookup-insight-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the… |
| MaxResults | string | no | The maximum number of entries to return. Valid values: 1 to 50. Default value: 20 |
| StartTime | string | no | The beginning of the time range to query. The default value is seven days before the current time. Specify the time in the ISO 8601… |
| EndTime | string | no | The end of the time range to query. The default value is the current time. Specify the time in the ISO 8601 standard in the… |
| LookupAttribute | string | no | An array of fliter conditions. You can specify one or two query conditions. For more information, see… |

### Creates or configures a data event selector. A trail must exist before you create a data event selector. If…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/put-data-event-selector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TrailName | string | yes | The name of the trail |
| EventSelectors | string | yes | The configuration of the data event selector. This parameter is a JSON array that can contain a maximum of 20 elements. Each element in… |
| IsTrailAllRegion | string | no | Specifies whether the trail tracks data events in all regions. Default value: `false` |
| TrailRegionIds | string | no | The regions where the trail tracks data events. Separate multiple region IDs with a comma (`,`) |

### Specifies the types of Insights events to deliver for a trail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/put-insight-selectors` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TrailName | string | yes | The name of the trail |
| InsightSelectors | string | no | The types of Insights events that the trail should deliver |

### Enables a trail to start delivering ActionTrail events to Object Storage Service (OSS), Simple Log Service…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/start-logging` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| Name | string | yes | The name of the trail that you want to enable. The name must be 6 to 36 characters in length. It must start with a lowercase letter and… |

### Disables a trail to stop delivering ActionTrail events to Object Storage Service (OSS), Simple Log Service…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/stop-logging` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| Name | string | yes | The name of the trail that you want to disable. The name must be 6 to 36 characters in length. It must start with a lowercase letter and… |

### Updates an advanced query template
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/update-advanced-query-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| TemplateId | string | yes | The template ID |
| TemplateName | string | no | The name of the template. The maximum length is 64 characters |
| TemplateSql | string | no | The query statement of the template |
| SimpleQuery | string | yes | Specifies whether to enable the simple query mode |

### Specifies the region where you want to store global events
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/update-global-events-storage-region` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| StorageRegion | string | yes | The region where you want to store global events. Valid values: ap-southeast-1 : the Singapore region cn-hangzhou : the China (Hangzhou)… |

### Updates the configurations of a trail
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/update-trail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |
| Name | string | yes | The name of the trail whose configurations you want to update. The name must be 6 to 36 characters in length and can contain lowercase… |
| OssBucketName | string | no | The name of the Object Storage Service (OSS) bucket to which you want to deliver events. The name must be 3 to 63 characters in length.… |
| OssKeyPrefix | string | no | The prefix of the files that are stored in the OSS bucket. The prefix must be 6 to 32 characters in length. The prefix must start with a… |
| OssWriteRoleArn | string | no | The Alibaba Cloud Resource Name (ARN) of the RAM role that is assumed by ActionTrail to deliver events to the OSS bucket. If you do not… |
| SlsProjectArn | string | no | The ARN of the Log Service project to which you want to deliver events |
| SlsWriteRoleArn | string | no | The ARN of the RAM role that is assumed by ActionTrail to deliver events to the Log Service project. If you do not specify this parameter,… |
| EventRW | string | no | The read/write type of the events to be delivered. Valid values: Write: write events. It is the default value. Read: read events. All:… |
| TrailRegion | string | no | The region of the trail. The default value is All, which indicates that the trail delivers events from all regions. You can also specify… |
| MaxComputeProjectArn | string | no | The ARN of the MaxCompute project to which you want to deliver events. The name of the MaxCompute project must be prefixed with actiontrail_ |
| MaxComputeWriteRoleArn | string | no | The ARN of the role that is assumed by ActionTrail to deliver events to the destination Simple Log Service project. If you do not specify… |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://actiontrail.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/create-advanced-query-history" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud ActionTrail API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-actiontrail/create-advanced-query-history with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud ActionTrail API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud ActionTrail itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud ActionTrail API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-actiontrail.

### What is the status of the Alibaba Cloud ActionTrail API?
Needs your own provider key (bring your own key)