API standard and pre-built SDKs in multi-language
The OpenAPI specification of this product (Actiontrail/2020-07-06) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.
Custom signature
If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).
Before you begin
An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. To call APIs securely, create a Resource Access Management (RAM) user with API access only, configure its AccessKey pairs, and implement the principle of least privilege (PoLP) through RAM policies. Use the Alibaba Cloud account only when its permissions are explicitly required for specific scenarios.
Trail
|
API |
Title |
Description |
| CreateTrail | CreateTrail | Creates a trail to deliver events to a destination for long-term storage and analysis, such as an Object Storage Service (OSS) bucket, a Simple Log Service (SLS) Logstore, or a MaxCompute project. |
| StartLogging | StartLogging | Enables a trail to start delivering ActionTrail events to Object Storage Service (OSS), Simple Log Service (SLS), or MaxCompute. |
| StopLogging | StopLogging | Disables a trail to stop delivering ActionTrail events to Object Storage Service (OSS), Simple Log Service (SLS), or MaxCompute. |
Event
|
API |
Title |
Description |
| LookupEvents | LookupEvents | Queries detailed historical events. |
Historical event delivery tasks
|
API |
Title |
Description |
| CreateDeliveryHistoryJob | CreateDeliveryHistoryJob | Creates a data backfill task. |
| ListDeliveryHistoryJobs | ListDeliveryHistoryJobs | Queries a list of data backfill tasks. |
Data event selector
|
API |
Title |
Description |
| ListDataEventSelectors | ListDataEventSelectors | Queries all data event selectors. |
| GetDataEventSelector | GetDataEventSelector | Queries the details about the data event selector for a specified trail. |
| PutDataEventSelector | PutDataEventSelector | Creates or configures a data event selector. A trail must exist before you create a data event selector. If a trail does not exist, you can call the CreateTrail operation to create one. |
| DeleteDataEventSelector | DeleteDataEventSelector | Deletes the data event selector for a specified trail. |
Other
|
API |
Title |
Description |
| UpdateAdvancedQueryTemplate | UpdateAdvancedQueryTemplate | Updates an advanced query template. |
| GetGlobalEventsStorageRegion | GetGlobalEventsStorageRegion | Queries the region where global events are stored. |
| CreateAdvancedQueryTemplate | CreateAdvancedQueryTemplate | Creates an advanced query template. |
| DeleteAdvancedQueryTemplate | DeleteAdvancedQueryTemplate | Deletes an advanced query template. |
| DescribeAdvancedQueryTemplate | DescribeAdvancedQueryTemplate | Queries advanced query templates. |
| DescribeUserAlertCount | DescribeUserAlertCount | Queries the number of daily alerts within a specific time range. |
| DescribeUserLogCount | DescribeUserLogCount | Queries the number of daily logs within a specific time range. |
| GetAdvancedQueryTemplate | GetAdvancedQueryTemplate | Queries the details about an advanced query template. |
| DeleteAdvancedQueryHistory | DeleteAdvancedQueryHistory | Deletes an advanced query record. |
| CreateAdvancedQueryHistory | CreateAdvancedQueryHistory | Creates an advanced query record. It lets you save custom conditional statements for reuse. |
| DescribeAdvancedQueryHistory | DescribeAdvancedQueryHistory | Queries all advanced query records. |
| DescribeResourceLifeCycleEvents | DescribeResourceLifeCycleEvents | Queries the lifecycle events of a specified resource. |
| DescribeScenes | DescribeScenes | Queries all advanced query scenarios. |
| DescribeSearchTemplates | DescribeSearchTemplates | Queries advanced query templates for a specified scenario. |
| ListDataEventServices | ListDataEventServices | Queries the services that support data events and the names of these events. |
| GetGovernanceMetrics | GetGovernanceMetrics | Queries the governance metrics of ActionTrail. |
Others
|
API |
Title |
Description |
| DeleteDeliveryHistoryJob | DeleteDeliveryHistoryJob | Deletes a data backfill task. |
| DeleteTrail | DeleteTrail | Deletes a trail. |
| DescribeRegions | DescribeRegions | Queries the Alibaba Cloud regions that are supported by ActionTrail. |
| DescribeTrails | DescribeTrails | Queries created trails. |
| DisableInsight | DisableInsight | Disables a specific type of insight event. |
| EnableInsight | EnableInsight | Enables the Insights feature. |
| GetAccessKeyLastUsedEvents | GetAccessKeyLastUsedEvents | Queries the information about the most recent events that are generated when a specified AccessKey pair is called to access Alibaba Cloud services. |
| GetAccessKeyLastUsedInfo | GetAccessKeyLastUsedInfo | Queries the information about the most recent call of a specified AccessKey pair. |
| GetAccessKeyLastUsedIps | GetAccessKeyLastUsedIps | Queries the information about the IP addresses that are most recently used when an AccessKey pair is called to access Alibaba Cloud services. |
| GetAccessKeyLastUsedProducts | GetAccessKeyLastUsedProducts | Queries the information about the Alibaba Cloud services that are most recently accessed by using a specified AccessKey pair. |
| GetAccessKeyLastUsedResources | GetAccessKeyLastUsedResources | Queries the information about the resources that are most recently accessed by using a specified AccessKey pair. |
| GetDeliveryHistoryJob | GetDeliveryHistoryJob | Queries the details of a data backfill task. |
| GetInsightSelectors | GetInsightSelectors | Retrieves the Insight event types to deliver for a trail. |
| GetInsightTypes | GetInsightTypes | Lists all enabled insight types. |
| GetInsightsEventsCount | GetInsightsEventsCount | Retrieves the number of Insights events for the current account. |
| GetTrailStatus | GetTrailStatus | Queries the status of a trail. |
| PutInsightSelectors | PutInsightSelectors | Specifies the types of Insight events to deliver for a trail. |
| UpdateGlobalEventsStorageRegion | UpdateGlobalEventsStorageRegion | Specifies the region where you want to store global events. |
| UpdateTrail | UpdateTrail | Updates the configurations of a trail. |