错误码
4.5 安全组
4.6.4 更新端口
"extra_dhcp_opts": [], "allowed_address_pairs": [], "binding:vnic_type": "normal"
} ] }
状态码
请参见A.3 状态码。
错误码
请参考A.4 错误码。
4.6.4 更新端口
功能介绍
更新端口
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1/{project_id}/ports/{port_id}
参数说明请参见表4-115。
表4-115 参数说明
名称 是否必选 说明
port_id 是 端口的唯一标识
project_id 是 项目ID，请参见A.5 获取
项目ID。
请求消息
● 请求参数
名称 是否必选 参数类型 说明
port 是 port object 端口对象，请参见表4-116。
表4-116 port 字段说明
security_groups 否 Array of
strings 扩展属性：安全组的UUID allowed_address_pairs 否 Array of
allow_a
– 如果allowed_address_pairs配 置地址池较大的CIDR（掩 码小于24位），建议为该 port配置一个单独的安全 组。
– 如果allowed_address_pairs为
“1.1.1.1/0”，表示关闭
extra_dhcp_opts 否 Array of extra_d hcp_op tobjects
DHCP的扩展Option(扩展属 性)，请参见表4-118。
表4-117 allow_address_pair 对象
名称 是否必
选
参数类型 说明
ip_address 是 String ● 功能说明：IP地址
● 约束：不支持0.0.0.0/0
● 如果allowed_address_pairs配置 地址池较大的CIDR（掩码小于24 位），建议为该port配置一个单 独的安全组。
● 如果allowed_address_pairs为
“1.1.1.1/0”，表示关闭源目地 址检查开关。
● 被绑定的云服务器网卡 allowed_address_pairs填
“1.1.1.1/0”。
● 如果填写allowed_address_pairs 参数，则ip_address是必选参 数。
mac_address 否 String MAC地址
表4-118 extra_dhcp_opt 对象
名称 是否必
选 参数类型 说明
opt_name 否 String DHCP选项名称，目前仅支持填写
“51”，表示DHCP租约时间。
opt_value 否 String DHCP选项的值。
当“opt_name”为“51”时，参数 格式为“Xh”，表示DHCP租约时间 为X小时。
“X”的取值范围为1~30000或
“-1”，“-1”表示DHCP租约时间 无限长。
● 请求样例
PUT https://{Endpoint}/v1/{project_id}/ports/7204e0da-40de-4207-a536-6f59b84f6f0e { "port": {
"name": "adc"
} }
响应消息
● 响应参数
表4-119 响应参数
名称 参数类型 说明
port port object 端口对象，请参见表4-120。
表4-120 port 字段说明
名称 参数类型 说明
id String 端口唯一标识
name String ● 功能说明：端口名称
● 取值：默认为空，最大长度不超过255 network_id String ● 功能说明：端口所属网络的ID
● 约束：必须是存在的网络ID 说明网络ID的获取方式：
● 方法1：登录虚拟私有云服务的控制台界 面，单击VPC下的子网，进入子网详情页 面，查找网络ID。
● 方法2：通过虚拟私有云服务的API接口查 询，具体操作可参考查询子网列表。
admin_state_up Boolean ● 功能说明：管理状态
● 约束：只支持true，默认为true mac_address String ● 功能说明：端口MAC地址
● 约束：由系统分配，不支持指定 fixed_ips Array of
fixed_ip objects
● 功能说明：端口IP。例如："fixed_ips":
[{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba",
"ip_address": "192.169.25.79"}]，请参 见表4-94
● 约束：一个端口只支持一个fixed_ip，
且不支持更新。
device_id String ● 功能说明：端口所属设备ID
● 约束：不支持设置和更新，由系统自动 维护
device_owner String ● 功能说明：设备所属（DHCP/Router/
lb/Nova）
● 约束：不支持设置和更新，由系统自动 维护
名称 参数类型 说明 tenant_id String 项目ID。
status String ● 功能说明：端口状态，Hana硬直通虚 拟机端口状态总为DOWN
● 取值范围：ACTIVE、BUILD、DOWN security_groups Array of
strings 安全组的UUID(扩展属性) allowed_addres
s_pairs Array of allow_address
tails object vif的详细信息，参见表4-97
binding:profile Object ● 功能说明：提供用户设置自定义信息 (扩展属性)
binding:vnic_ty
pe String ● 功能说明：绑定的vNIC类型
● 取值范围：normal或者direct
● normal: 软交换direct: SRIOV硬直通
（不支持）
dns_assignment Array of dns_assignme nt objects
● 功能说明：主网卡默认内网域名信息
● 约束：不支持设置和更新，由系统自动 维护
dns_name String ● 功能说明：主网卡默认内网DNS名称
● 约束：不支持设置和更新，由系统自动 维护
instance_id String ● 功能说明：端口所属实例ID，例如RDS 实例ID
● 约束：不支持设置和更新，由系统自动 维护
名称 参数类型 说明
instance_type String ● 功能说明：端口所属实例类型，例如
“RDS”
● 约束：不支持设置和更新，由系统自动 维护
port_security_e
nabled Boolean ● 功能说明：端口安全使能标记，如果不 使能则安全组和dhcp防欺骗不生效 zone_id String 端口所属的可用分区
表4-121 fixed_ip 对象
名称 参数类型 说明
subnet_id String 功能说明：所属子网ID
如果您使用管理控制台，此值即为子网详 情中的“网络ID”参数值。
约束：不支持更新 ip_address String 端口IP地址
表4-122 allow_address_pair 对象
名称 参数类型 说明
ip_address String ● 功能说明：IP地址
● 约束：不支持0.0.0.0/0
● 如果allowed_address_pairs配置地址池 较大的CIDR（掩码小于24位），建议 为该port配置一个单独的安全组。
● 如果allowed_address_pairs为
“1.1.1.1/0”，表示关闭源目地址检查 开关。
● 被绑定的云服务器网卡 allowed_address_pairs填
“1.1.1.1/0”。
mac_address String MAC地址
表4-123 extra_dhcp_opt 对象
名称 参数类型 说明
opt_name String DHCP选项名称，目前仅支持填写
“51”，表示DHCP租约时间。
opt_value String DHCP选项的值。
当“opt_name”为“51”时，参数格式 为“Xh”，表示DHCP租约时间为X小时。
“X”的取值范围为1~30000或“-1”，
“-1”表示DHCP租约时间无限长。
表4-124 binding:vif_details 对象
名称 参数类型 说明
primary_interfac
e Boolean 取值为true，表示是虚拟机的主网卡。
表4-125 dns_assignment 对象
名称 参数类型 说明
hostname String 端口hostname ip_address String 端口IP地址 fqdn String 端口内网fqdn
● 响应样例
{ "port": {
"id": "7204e0da-40de-4207-a536-6f59b84f6f0e", "name": "adc",
"mac_address": "fa:16:3e:d7:f2:6c",
"network_id": "b4152e98-e3af-4e49-bb7f-7766e2b5ec63", "tenant_id": "caa6cf4337ea47fb823b15709ebe8591", "device_id": "", "binding:vnic_type": "normal"
} }
状态码
请参见A.3 状态码。
错误码
请参考A.4 错误码。