批量创建辅助弹性网卡

功能介绍

批量创建辅助弹性网卡。

URI

POST /v3/{project_id}/vpc/sub-network-interfaces/batch-create

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方式请参见获取项目ID。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
dry_run	否	Boolean	功能说明：是否只预检此次请求。取值范围： true：发送检查请求，不会创建辅助弹性网卡。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回响应码202。 false（默认值）：发送正常请求，并直接创建辅助弹性网卡。
sub_network_interface	是	BatchCreateSubNetworkInterfaceOption object	创建辅助弹性网卡的请求体。
count	是	Integer	批量创建辅助弹性网卡的个数。最小值：1 最大值：10

表3 BatchCreateSubNetworkInterfaceOption
参数	是否必选	参数类型	描述
virsubnet_id	是	String	功能说明：虚拟子网ID。取值范围：标准UUID。
parent_id	是	String	功能说明：宿主网络接口的ID。取值范围：标注UUID。约束：必须是实际存在的端口ID。
security_groups	否	Array of strings	功能说明：安全组的ID列表，例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]。取值范围：默认值为系统默认安全组。
description	否	String	功能说明：辅助弹性网卡的描述信息。取值范围：0-255个字符，不能包含“<”和“>”。
ipv6_enable	否	Boolean	功能说明：辅助弹性网卡是否启用ipv6地址。取值范围：true（开启)，false（关闭）。默认值：false。
project_id	否	String	功能说明：辅助弹性网卡所属的项目ID。取值范围：标准UUID。约束：只有管理员有权限指定。
allowed_address_pairs	否	Array of AllowAddressPair objects	扩展属性：IP/Mac对列表，allow_address_pair参见“allow_address_pair对象”表。使用说明：如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。硬件SDN环境不支持ip_address属性配置为CIDR格式。

表4 AllowAddressPair
参数	是否必选	参数类型	描述
ip_address	否	String	功能说明：如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。
mac_address	否	String	功能说明：MAC地址。

响应参数

状态码：201

表5 响应Body参数
参数	参数类型	描述
request_id	String	请求ID。
sub_network_interfaces	Array of SubNetworkInterface objects	批量创建辅助弹性网卡的响应体。

表6 SubNetworkInterface
参数	参数类型	描述
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对象”表。使用说明：如果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	功能说明：辅助弹性网卡安全使能标记，如果不使能则安全组不生效。

表7 ResourceTag
参数	参数类型	描述
key	String	功能说明：标签键。约束：同一资源的key值不能重复。最小长度：1 最大长度：128
value	String	功能说明：标签值。最大长度：255

表8 AllowAddressPair
参数	参数类型	描述
ip_address	String	功能说明：如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。
mac_address	String	功能说明：MAC地址。

请求示例

批量创建3个辅助弹性网卡，虚拟子网id为115b5a84-31dc-4b1e-8de9-bf5a75d2c566，宿主网络接口id为8b6c46f1-c68d-4bba-a922-2d97da185af5，关联安全组6727c950-9f01-47a2-a7aa-7d3686c4c95b。

POST https://{Endpoint}/v3/8c6fb137a48a428aaf9a0229dca4edb3/vpc/sub-network-interfaces/batch-create

{
  "sub_network_interface" : {
    "virsubnet_id" : "115b5a84-31dc-4b1e-8de9-bf5a75d2c566",
    "security_groups" : [ "6727c950-9f01-47a2-a7aa-7d3686c4c95b" ],
    "parent_id" : "8b6c46f1-c68d-4bba-a922-2d97da185af5"
  },
  "count" : 3
}

响应示例

状态码：201

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

{
  "sub_network_interfaces" : [ {
    "id" : "d1f8094c-bb3d-43c5-b625-52dd43eab451",
    "project_id" : "8c6fb137a48a428aaf9a0229dca4edb3",
    "virsubnet_id" : "115b5a84-31dc-4b1e-8de9-bf5a75d2c566",
    "private_ip_address" : "192.168.6.245",
    "ipv6_ip_address" : "2001:db8:a583:5d:11e8:b908:4fe6:9802",
    "mac_address" : "fa:16:3e:97:1f:f5",
    "parent_device_id" : "11185aa2-4e08-4d9e-87ed-84817280eaa7",
    "security_groups" : [ "6727c950-9f01-47a2-a7aa-7d3686c4c95b" ],
    "allowed_address_pairs" : [ ],
    "description" : "",
    "parent_id" : "8b6c46f1-c68d-4bba-a922-2d97da185af5",
    "vlan_id" : 41,
    "instance_type" : "",
    "instance_id" : "",
    "tags" : [ ]
  }, {
    "id" : "0dce57ab-00de-443b-a7fe-e8ff68bd95bc",
    "project_id" : "8c6fb137a48a428aaf9a0229dca4edb3",
    "virsubnet_id" : "115b5a84-31dc-4b1e-8de9-bf5a75d2c566",
    "private_ip_address" : "192.168.6.75",
    "ipv6_ip_address" : "2001:db8:a583:5d:6c22:8ea2:c061:a802",
    "mac_address" : "fa:16:3e:5a:61:84",
    "parent_device_id" : "11185aa2-4e08-4d9e-87ed-84817280eaa7",
    "security_groups" : [ "6727c950-9f01-47a2-a7aa-7d3686c4c95b" ],
    "allowed_address_pairs" : [ ],
    "description" : "",
    "parent_id" : "8b6c46f1-c68d-4bba-a922-2d97da185af5",
    "vlan_id" : 42,
    "instance_type" : "",
    "instance_id" : "",
    "tags" : [ ]
  }, {
    "id" : "1eca03ee-c0f1-4434-9c4c-87fe4426718c",
    "project_id" : "8c6fb137a48a428aaf9a0229dca4edb3",
    "virsubnet_id" : "115b5a84-31dc-4b1e-8de9-bf5a75d2c566",
    "private_ip_address" : "192.168.6.194",
    "ipv6_ip_address" : "2001:db8:a583:5d:2b45:a3ae:17db:ec02",
    "mac_address" : "fa:16:3e:b8:ec:6d",
    "parent_device_id" : "11185aa2-4e08-4d9e-87ed-84817280eaa7",
    "security_groups" : [ "6727c950-9f01-47a2-a7aa-7d3686c4c95b" ],
    "allowed_address_pairs" : [ ],
    "description" : "",
    "parent_id" : "8b6c46f1-c68d-4bba-a922-2d97da185af5",
    "vlan_id" : 43,
    "instance_type" : "",
    "instance_id" : "",
    "tags" : [ ]
  } ],
  "request_id" : "344544c1-d053-4ad3-b673-900a0e01db7e"
}

状态码

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

错误码

请参见错误码。

父主题： 辅助弹性网卡

上一篇：创建辅助弹性网卡

下一篇：查询租户下辅助弹性网卡列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试