更新终端节点
功能介绍
更新或删除允许访问终端节点的白名单。
调用方法
请参见如何调用API。
URI
PUT /v1/{project_id}/vpc-endpoints/{vpc_endpoint_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参见获取项目ID。 最小长度:1 最大长度:64 |
vpc_endpoint_id |
是 |
String |
终端节点的ID。 最小长度:1 最大长度:64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Content-Type |
否 |
String |
发送的实体的MIME类型。推荐用户默认使用application/json, 如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。 缺省值:application/json |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
whitelist |
否 |
Array of strings |
更新或删除用于控制访问终端节点的白名单。此参数可以添加IPv4或CIDR:
最小长度:0 最大长度:32 |
enable_whitelist |
否 |
Boolean |
是否开启网络ACL隔离。
|
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
终端节点的ID,唯一标识。 最小长度:1 最大长度:64 |
service_type |
String |
终端节点连接的终端节点服务类型。
|
status |
String |
终端节点的连接状态。
|
ip |
String |
访问所连接的终端节点服务的IP。 仅当同时满足如下条件时,返回该参数:
最小长度:1 最大长度:64 |
active_status |
Array of strings |
账号状态。
|
endpoint_service_name |
String |
终端节点服务的名称。 |
marker_id |
Integer |
终端节点的报文标识。 |
endpoint_service_id |
String |
终端节点服务的ID。 最小长度:1 最大长度:64 |
enable_dns |
Boolean |
是否创建域名。
|
dns_names |
Array of strings |
访问所连接的终端节点服务的域名。 当“enable_dns”为true时,该参数可见。 最小长度:0 最大长度:32 |
subnet_id |
String |
vpc_id对应VPC下已创建的网络(network)的ID,UUID格式。 最小长度:1 最大长度:64 |
vpc_id |
String |
终端节点所在的VPC的ID。 最小长度:1 最大长度:64 |
created_at |
String |
终端节点的创建时间。 采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ |
updated_at |
String |
终端节点的更新时间。 采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ |
project_id |
String |
项目ID,获取方法请参见获取项目ID。 最小长度:1 最大长度:64 |
tags |
Array of TagList objects |
标签列表,没有标签默认为空数组。 |
whitelist |
Array of strings |
控制访问终端节点的白名单。 若未创建,则返回空列表。 创建连接Interface类型终端节点服务的终端节点时,显示此参数。 最小长度:0 最大长度:32 |
enable_whitelist |
Boolean |
是否开启网络ACL隔离。
|
policy_statement |
Array of PolicyStatement objects |
Gateway类型终端节点策略信息,仅限OBS、SFS的终端节点服务的enable_policy值为true时支持该参数。 数组长度:0 - 10 |
policy_document |
Object |
终端节点策略信息,仅当终端节点服务的enable_policy值为true时支持该参数,默认值为完全访问权限。(OBS、SFS的终端节点服务暂不支持该参数) 数组长度:0 - 20480 |
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
键。 key不能为空,长度1~128个字符(中文也可以输入128个字符)。 可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格,以及以下字符: _ . : = + - @。 _sys_开头属于系统标签,租户不能输入。 key两头不能有空格字符。 最小长度:1 最大长度:128 |
value |
String |
值。 长度0~255个字符(中文也可以输入255个字符)。 可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格,以及以下字符: _ . : / = + - @。 资源标签值可以为空字符串。 最大长度:255 |
请求示例
更新终端节点,设置白名单信息为192.168.1.1、192.168.1.2,开启网络ACL隔离。
PUT https://{endpoint}/v1/{project_id}/vpc-endpoints/4189d3c2-8882-4871-a3c2- d380272eed83 { "whitelist": [ "192.168.1.1", "192.168.1.2" ], "enable_whitelist":true, }
响应示例
状态码: 200
服务器已成功处理了请求
{ "id" : "4189d3c2-8882-4871-a3c2-d380272eed83", "service_type" : "interface", "status" : "accepted", "ip" : "10.32.xx.xx", "marker_id" : 322312312312, "vpc_id" : "4189d3c2-8882-4871-a3c2-d380272eed83", "enable_dns" : true, "endpoint_service_name" : "test123", "endpoint_service_id" : "test123", "project_id" : "6e9dfd51d1124e8d8498dce894923a0d", "whitelist" : [ "192.168.1.1", "192.168.1.2" ], "enable_whitelist" : true, "created_at" : "2022-04-14T09:35:47Z", "updated_at" : "2022-04-14T09:36:47Z", "tags" : [ { "key" : "test1", "value" : "test1" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
服务器已成功处理了请求 |
错误码
请参见错误码。