文档首页> 虚拟私有云 VPC> API参考> API V3> 辅助弹性网卡> 批量创建辅助弹性网卡
更新时间：2024-05-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量创建辅助弹性网卡

功能介绍

批量创建辅助弹性网卡。

调试

您可以在API Explorer中调试该接口。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

dry_run

否

Boolean
  • 功能说明：是否只预检此次请求。
  • 取值范围：
    • true：发送检查请求，不会创建辅助弹性网卡。检查项包括是否填写了必需参数、请求格式、权限校验。如果检查不通过，则返回对应错误。如果检查通过，则返回响应码202。
    • false（默认值）：发送正常请求，并直接创建辅助弹性网卡。

sub_network_interface

是

BatchCreateSubNetworkInterfaceOption object

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

count

是

Integer
  • 功能说明：批量创建辅助弹性网卡的个数。
  • 最小值：1
  • 最大值：20
表3 BatchCreateSubNetworkInterfaceOption

参数

是否必选

参数类型

描述

virsubnet_id

是

String
  • 功能说明：虚拟子网ID，即子网ID，对应控制台子网界面的网络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
  • 约束：只有管理员有权限指定

响应参数

状态码为 201 时:

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

sub_network_interfaces

Array of SubNetworkInterface objects

批量创建辅助弹性网卡的响应体。
表5 SubNetworkInterface

参数

参数类型

描述

id

String
  • 功能说明：辅助弹性网卡的唯一标识。
  • 取值范围：带(-)的标准UUID。

virsubnet_id

String
  • 功能说明：虚拟子网ID，即子网ID，对应控制台子网界面的网络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_enabled

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

security_groups

Array of strings
  • 功能说明：安全组的ID列表，例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]。
  • 取值范围：默认值为系统默认安全组。

tags

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

project_id

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

created_at

String
  • 功能说明：辅助弹性网卡的创建时间。
  • 取值范围：UTC时间格式：yyyy-MM-ddTHH:mm:ssZ。

请求示例

批量创建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 时:

Created

{
  "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" ],
    "vpc_id" : null,
    "description" : "",
    "parent_id" : "8b6c46f1-c68d-4bba-a922-2d97da185af5",
    "vlan_id" : 41,
    "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" ],
    "vpc_id" : null,
    "description" : "",
    "parent_id" : "8b6c46f1-c68d-4bba-a922-2d97da185af5",
    "vlan_id" : 42,
    "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" ],
    "vpc_id" : null,
    "description" : "",
    "parent_id" : "8b6c46f1-c68d-4bba-a922-2d97da185af5",
    "vlan_id" : 43,
    "tags" : [ ]
  } ],
  "request_id" : "344544c1-d053-4ad3-b673-900a0e01db7e"
}

状态码

状态码

描述

201

Created

错误码

请参见错误码。

父主题： 辅助弹性网卡
分享：

    相关文档

    相关产品