创建辅助弹性网卡

project_id

是

String

参数解释：

辅助弹性网卡所属的项目ID。

取值范围：

不涉及。

dry_run

否

Boolean

参数解释：

是否只预检此次请求。

约束限制：

不涉及。

取值范围：

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

• false：发送正常请求，并直接创建辅助弹性网卡。

默认取值：

false

sub_network_interface

是

CreateSubNetworkInterfaceOption object

参数解释：

创建辅助弹性网卡的请求体。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

virsubnet_id

是

String

参数解释：

辅助弹性网卡所在的虚拟子网ID。

约束限制：

带“-”的标准UUID格式。

取值范围：

不涉及。

默认取值：

不涉及。

vlan_id

否

String

参数解释：

辅助弹性网卡的VLAN ID。

约束限制：

同一个宿主弹性网卡下，辅助弹性网卡的VLAN ID不能重复。

取值范围：

1-4094

默认取值：

不涉及。

parent_id

是

String

参数解释：

辅助弹性网卡所挂载的弹性网卡的ID。

约束限制：

必须是实际存在的弹性网卡ID。

取值范围：

不涉及。

默认取值：

不涉及。

description

否

String

参数解释：

辅助弹性网卡的描述信息。

约束限制：

0-255个字符，不能包含“<”和“>”。

取值范围：

不涉及。

默认取值：

不涉及。

ipv6_enable

否

Boolean

参数解释：

辅助弹性网卡是否开启IPv6能力。

约束限制：

不涉及。

取值范围：

• true：开启IPv6。

• false：关闭IPv6。

默认取值：

false

private_ip_address

否

String

参数解释：

辅助弹性网卡的私有IPv4地址。

约束限制：

必须在虚拟子网的网段内，请求时此参数不填则在虚拟子网网段内随机分配IP地址。

取值范围：

不涉及。

默认取值：

不涉及。

ipv6_ip_address

否

String

参数解释：

辅助弹性网卡的私有IPv6地址。

约束限制：

必须在虚拟子网的网段内，请求时此参数不填则在虚拟子网网段内随机分配IP地址。

取值范围：

不涉及。

默认取值：

不涉及。

security_groups

否

Array of strings

参数解释：

辅助弹性网卡关联的安全组的ID列表。例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]。

约束限制：

• 如果请求时不指定此参数，辅助弹性网卡创建后会自动关联默认安全组。

• 一个辅助弹性网卡默认最多支持100个安全组。

取值范围：

不涉及。

默认取值：

不涉及。

project_id

否

String

参数解释：

辅助弹性网卡所属的项目ID。

约束限制：

此参数只能指定为当前租户的租户ID，不指定时默认是当前租户的项目ID。

取值范围：

不涉及。

默认取值：

不涉及。

allowed_address_pairs

否

Array of AllowedAddressPair objects

参数解释：

辅助弹性网卡的IP/Mac对列表，详情请参见“AllowedAddressPair”对象表。

约束限制：

• 一个辅助弹性网卡默认最多支持10个allowed_address_pairs。

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

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

取值范围：

不涉及。

默认取值：

不涉及。

ip_address

否

String

参数解释：

IP地址。

约束限制：

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

取值范围：

单个IP地址：例如192.168.21.25。

IP网段：例如192.168.21.0/24。

默认取值：

不涉及。

mac_address

否

String

参数解释：

MAC地址。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

sub_network_interface

SubNetworkInterface object

参数解释：

创建辅助弹性网卡的响应体。

取值范围：

不涉及。

id

String

参数解释：

辅助弹性网卡的资源ID。辅助弹性网卡创建成功后，会生成一个辅助弹性网卡 ID，是辅助弹性网卡对应的唯一标识。

取值范围：

带“-”的标准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 ResponseTag objects

参数解释：

辅助弹性网卡的标签信息，包括标签键和标签值，可用来分类和标识资源。详情请参见Tag对象。

取值范围：

不涉及。

project_id

String

参数解释：

辅助弹性网卡所属的项目ID。

取值范围：

不涉及。

created_at

String

参数解释：

辅助弹性网卡的创建时间。

取值范围：

UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

allowed_address_pairs

Array of AllowedAddressPair objects

参数解释：

辅助弹性网卡的IP/Mac对列表，详情请参见“AllowedAddressPair”对象表。

取值范围：

不涉及。

state

String

参数解释：

辅助弹性网卡的状态。

取值范围：

• NORMAL：表示辅助弹性网卡已挂载在弹性网卡上。

• UNBOUND：表示辅助弹性网卡未挂载在弹性网卡上。

instance_id

String

参数解释：

辅助弹性网卡所属的云服务实例ID，例如RDS实例ID。

取值范围：

不涉及。

instance_type

String

参数解释：

辅助弹性网卡所属的云服务实例类型，例如“RDS”。

取值范围：

不涉及。

scope

String

参数解释：

辅助弹性网卡所在站点的公网出口信息。

取值范围：

• center：默认值，表示作用域为中心。

• 某个AZ ID：表示作用域为具体的AZ。

security_enabled

Boolean

参数解释：

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

取值范围：

不涉及。

key

String

参数解释：

标签键。

取值范围：

• 最大长度128个unicode字符， key不能为空。

• 同一资源的key不能重复。

• 可以包含的字符范围：

  • 英文字母

  • 数字

  • 特殊字符：下划线（_）、点（.）、冒号（:）、加号（+）、中划线（-）、等号（=）

value

String

参数解释：

标签值。

取值范围：

• 每个值最大长度255个unicode字符，value可以为空。

• 可以包含的字符范围：

  • 英文字母

  • 数字

  • 特殊字符：下划线（_）、冒号（:）、加号（+）、中划线（-）、等号（=）

ip_address

String

参数解释：

IP地址。

约束限制：

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

取值范围：

单个IP地址：例如192.168.21.25。

IP网段：例如192.168.21.0/24。

默认取值：

不涉及。

mac_address

String

参数解释：

MAC地址。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

201

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