更新辅助弹性网卡

project_id

是

String

项目ID。

获取方式请参见获取项目ID。

sub_network_interface_id

是

String

辅助弹性网卡的唯一标识。

dry_run

否

Boolean

• 功能说明：是否只预检此次请求。

• 取值范围：

  • true：发送检查请求，不会更新辅助弹性网卡。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回响应码202。

  • false（默认值）：发送正常请求，并直接更新辅助弹性网卡。

sub_network_interface

是

UpdateSubNetworkInterfaceOption object

更新辅助弹性网卡请求体。

description

否

String

• 功能说明：辅助弹性网卡的描述信息。

• 取值范围：0-255个字符，不能包含“<”和“>”。

security_groups

否

Array of strings

• 功能说明：安全组的ID列表，例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]。

allowed_address_pairs

否

Array of AllowAddressPair objects

• 扩展属性：IP/Mac对列表，allow_address_pair参见“allow_address_pair对象”表。

• 使用说明：

  • IP地址不允许为 “0.0.0.0”。

  • 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。

  • 硬件SDN环境不支持ip_address属性配置为CIDR格式。

ip_address

否

String

• 功能说明：

  • IP地址不支持0.0.0.0。

  • 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。

mac_address

否

String

• 功能说明：MAC地址。

request_id

String

请求ID。

sub_network_interface

SubNetworkInterface object

更新辅助弹性网卡的响应体。

id

String

• 功能说明：辅助弹性网卡的唯一标识。

• 取值范围：带(-)的标准UUID。

virsubnet_id

String

• 功能说明：虚拟子网ID。

• 取值范围：标准UUID。

private_ip_address

String

• 功能说明：辅助弹性网卡的私有IPv4地址。

• 取值范围：必须在虚拟子网的网段内，不填则随机在虚拟子网网段内随机分配。

ipv6_ip_address

String

• 功能说明：辅助弹性网卡的IPv6地址。

mac_address

String

• 功能说明：辅助弹性网卡的mac地址。

• 取值范围：合法的mac地址，系统随机分配。

parent_device_id

String

• 功能说明：设备ID。

• 取值范围：标准UUID。

parent_id

String

• 功能说明：宿主网络接口的ID。

• 取值范围：标准UUID。

description

String

• 功能说明：辅助弹性网卡的描述信息。

• 取值范围：0-255个字符，不能包含“<”和“>”。

vpc_id

String

• 功能说明：辅助弹性网卡所属的VPC_ID。

• 取值范围：标准UUID。

vlan_id

Integer

• 功能说明：辅助弹性网卡的VLAN ID。

• 取值范围：1-4094。

• 约束：同一个宿主网络接口下唯一。

security_groups

Array of strings

• 功能说明：安全组的ID列表，例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]。

• 取值范围：默认值为系统默认安全组。

tags

Array of ResourceTag objects

• 功能说明：辅助弹性网卡的标签列表。

project_id

String

• 功能说明：辅助弹性网卡所属项目ID。

created_at

String

• 功能说明：辅助弹性网卡的创建时间。

• 取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

allowed_address_pairs

Array of AllowAddressPair objects

• 扩展属性：IP/Mac对列表，allow_address_pair参见“allow_address_pair对象”表。

• 使用说明：

  • IP地址不允许为 “0.0.0.0”。

  • 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。

  • 硬件SDN环境不支持ip_address属性配置为CIDR格式。

state

String

• 功能说明：辅助弹性网卡当前状态。

instance_id

String

• 功能说明：辅助弹性网卡所属实例ID，例如RDS实例ID。

instance_type

String

• 功能说明：辅助弹性网卡所属实例类型，例如“RDS”。

scope

String

• 功能说明：辅助弹性网卡所在站点的公网出口信息。

security_enabled

Boolean

• 功能说明：辅助弹性网卡安全使能标记，如果不使能则安全组不生效。

key

String

• 功能说明：标签键。

• 约束：同一资源的key值不能重复。

最小长度：1

最大长度：128

value

String

• 功能说明：标签值。

最大长度：255

ip_address

String

• 功能说明：

  • IP地址不支持0.0.0.0。

  • 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。

mac_address

String

• 功能说明：MAC地址。

200

PUT操作正常返回，更多状态码请参见状态码。