All Products
Search
Document Center

Bastionhost:ConfigInstanceWhiteList

Last Updated:Apr 18, 2024

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

Operation description

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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdstringYes

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

bastionhost-cn-78v1gh****
RegionIdstringNo

The region ID of the bastion host.

cn-hangzhou
WhiteListarrayNo

The public IP addresses that you want to add to the whitelist.

stringNo

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

10.162.XX.XX

Response parameters

ParameterTypeDescriptionExample
object
InstanceIdstring

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

bastionhost-cn-78v1gh****
RequestIdstring

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

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

Examples

Sample success responses

JSONformat

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

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-03-21The internal configuration of the API is changed, but the call is not affectedsee changesets
Change itemChange content
The internal configuration of the API is changed, but the call is not affected.