ActionTrail:Call API operations over a VPC

Prerequisites

• An ECS instance in a VPC. API requests are sent from this instance.

• Version 4.5.3 or later of the core library of the Java SDK, if you use the Java SDK method.

Limits

You can manage resources only in the same region as the ActionTrail VPC endpoint that you call. Cross-region operations are not supported.

Method 1 (recommended): Call an API operation by using the Java SDK

The Java SDK method applies to Java applications. The following code calls the ActionTrail DescribeRegions operation over a VPC:

DefaultProfile profile = DefaultProfile.getProfile("<RegionId>", "<AccessKeyId>", "<AccessKeySecret>");
IAcsClient client = new DefaultAcsClient(profile);
// A global configuration. For ActionTrail, the product name is Actiontrail.
DefaultProfile.addEndpoint("<RegionId>", "Actiontrail", "<Endpoint>");
// Call the DescribeRegions operation.
DescribeRegionsRequest regionsRequest = new DescribeRegionsRequest();
// A configuration that takes effect only for the current request.
// Set the network. Valid values of the productNetwork parameter: vpc and public.
// vpc: calls the API operation over a VPC. public: calls the API operation over the Internet. This is the default value.
regionsRequest.productNetwork = "vpc";
DescribeRegionsResponse regionsResponse = client.getAcsResponse(regionsRequest);

Configure the endpoint at either of the following levels:

• Global configuration — DefaultProfile.addEndpoint sets the endpoint globally. For ActionTrail, set the product name to Actiontrail. Replace <Endpoint> with the VPC endpoint of the region whose resources you want to manage. For the endpoint of each region, see VPC endpoints.

• Per-request configuration — productNetwork takes effect only for the current request. Valid values: vpc and public. Set the value to vpc to call the operation over a VPC. The default value, public, calls the operation over the Internet. To set the endpoint for the current request instead, call setSysEndpoint.

Method 2: Call an API operation by using Alibaba Cloud CLI

Run the following command to call the DescribeRegions operation over a VPC. The command uses the VPC endpoint of the China (Hangzhou) region:

aliyun actiontrail DescribeRegions --endpoint actiontrail-vpc.cn-hangzhou.aliyuncs.com

The --endpoint option specifies the endpoint that the request is sent to. Replace actiontrail-vpc.cn-hangzhou.aliyuncs.com with the VPC endpoint of the region whose resources you want to manage. For the endpoint of each region, see VPC endpoints.

VPC endpoints

The VPC endpoints of ActionTrail use the format actiontrail-vpc.<region-id>.aliyuncs.com. The following table lists the VPC endpoint of each region.