Configures a whitelist of public IP addresses for a bastion host.

Usage notes

You can call this operation to configure a whitelist of public IP addresses for a bastion host. By default, a bastion host is accessible from all public IP addresses. If you want to allow the requests from specific public IP addresses, you can call this operation to add trusted IP addresses to the whitelist of the bastion host.

Limits

You can call this operation up to 30 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ConfigInstanceWhiteList

The operation that you want to perform.

Set the value to ConfigInstanceWhiteList.

InstanceId String Yes bastionhost-cn-78v1gh****

The ID of the bastion host for which you want to configure a whitelist of public IP addresses.

WhiteList.N RepeatList No 10.162.XX.XX

The public IP addresses that you want to add to the whitelist. You can add up to 30 IP addresses. If you want to add multiple IP addresses to the whitelist, separate the IP addresses with commas (,).

RegionId String No cn-hangzhou

The region ID of the bastion host.

Response parameters

Parameter Type Example Description
InstanceId String bastionhost-cn-78v1gh****

The ID of the bastion host for which a whitelist of public IP addresses is configured.

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

The ID of the request, which is used to locate and troubleshoot issues.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ConfigInstanceWhiteList
&InstanceId=bastionhost-cn-78v1gh****
&<Common request parameters>

Sample success responses

XML format 

<ConfigInstanceWhiteListResponse>
  <RequestId>47820E32-5968-45CF-982F-09CB80DC180B</RequestId>
  <InstanceId>bastionhost-cn-78v1gh****</InstanceId>
</ConfigInstanceWhiteListResponse>

JSON format 

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

Error codes

For a list of error codes, visit the API Error Center.