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
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.