堡垒机实例开启公网访问后,可以将指定公网IP地址加入白名单,允许公网流量访问堡垒机实例。
接口说明
本接口用于为堡垒机实例配置公网 IP 地址白名单。一般情况下是默认放开所有公网 IP 访问堡垒机,在需要限制公网 IP 访问堡垒机时,使用本接口将指定公网 IP 地址加入白名单,对公网流量访问堡垒机实例进行限制。
本接口的单用户 QPS 限制为 30 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-bastionhost:ConfigInstanceWhiteList |
update |
*Instance
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
要配置公网 IP 地址白名单的堡垒机的实例 ID。 说明
可通过调用 DescribeInstances 接口获取堡垒机实例 ID。 |
bastionhost-cn-78v1gh**** |
| RegionId |
string |
否 |
堡垒机实例的地域 ID。 |
cn-hangzhou |
| WhiteList |
array |
否 |
需要配置的 IP 地址白名单。 |
10.162.XX.XX |
|
string |
否 |
需要配置的 IP 地址白名单。最多支持配置 50 个 IP 地址。如果要将多个 IP 地址加入白名单,多个 IP 之间使用半角逗号(,)隔开。 |
10.162.XX.XX,192.168.XX.XX |
|
| WhiteListPolicies |
array<object> |
否 |
||
|
object |
否 |
|||
| Entry |
string |
否 |
||
| Description |
string |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应数据。 |
||
| InstanceId |
string |
已配置公网 IP 地址白名单的堡垒机实例 ID。 |
bastionhost-cn-78v1gh**** |
| RequestId |
string |
本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。 |
47820E32-5968-45CF-982F-09CB80DC180B |
示例
正常返回示例
JSON格式
{
"InstanceId": "bastionhost-cn-78v1gh****",
"RequestId": "47820E32-5968-45CF-982F-09CB80DC180B"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。