更新时间:2024-10-11 GMT+08:00

批量创建辅助弹性网卡

功能介绍

批量创建辅助弹性网卡。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。

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对象”表。

  • 使用说明:

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

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

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

表4 AllowAddressPair

参数

是否必选

参数类型

描述

ip_address

String

  • 功能说明:

    • IP地址不支持0.0.0.0。

    • 如果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对象”表。

  • 使用说明:

    • 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

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

表7 ResourceTag

参数

参数类型

描述

key

String

  • 功能说明:标签键。

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

最小长度:1

最大长度:128

value

String

  • 功能说明:标签值。

最大长度:255

表8 AllowAddressPair

参数

参数类型

描述

ip_address

String

  • 功能说明:

    • IP地址不支持0.0.0.0。

    • 如果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操作正常返回,更多状态码请参见状态码

错误码

请参见错误码