All Products
Search
Document Center

Bastionhost:ConfigInstanceWhiteList

Last Updated:Mar 31, 2026

After enabling public network access for a Bastionhost instance, you can add IP addresses to a whitelist to control access.

Operation description

This operation configures a public IP address whitelist for a Bastionhost instance. By default, instances accept traffic from all public IP addresses. To restrict access, add IP addresses to the whitelist. This ensures only traffic from whitelisted IP addresses can reach the instance.

Each user is limited to 30 queries per second (QPS) for this operation. The system throttles API calls that exceed this limit. This may affect your services, so plan your calls accordingly.

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

InstanceId

string

Yes

The ID of the Bastionhost instance to configure.

Note

To obtain the instance ID, call the DescribeInstances operation.

bastionhost-cn-78v1gh****

RegionId

string

No

The region ID of the Bastionhost instance.

cn-hangzhou

WhiteList

array

No

The list of IP addresses to add to the whitelist.

10.162.XX.XX

string

No

The IP addresses to add to the whitelist. You can specify up to 50 IP addresses, separated by a comma.

10.162.XX.XX,192.168.XX.XX

WhiteListPolicies

array<object>

No

The policies for the public IP address whitelist.

object

No

Entry

string

No

The IP addresses to add to the whitelist. You can specify up to 50 IP addresses, separated by a comma.

10.162.XX.XX,192.168.XX.XX

Description

string

No

The description of this whitelist rule.

Response elements

Element

Type

Description

Example

object

The response data.

InstanceId

string

The ID of the Bastionhost instance whose whitelist was configured.

bastionhost-cn-78v1gh****

RequestId

string

A unique request ID generated by Alibaba Cloud. Use this ID to troubleshoot issues.

47820E32-5968-45CF-982F-09CB80DC180B

Examples

Success response

JSON format

{
  "InstanceId": "bastionhost-cn-78v1gh****",
  "RequestId": "47820E32-5968-45CF-982F-09CB80DC180B"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.