Creating Supplementary Network Interfaces in Batches

project_id

Yes

String

Project ID.

For details about how to obtain a project ID, see Obtaining a Project ID.

dry_run

No

Boolean

• Whether to only send the check request.

• The value can be one of the following:

  • true: A check request will be sent and the supplementary network interface will not be created. Check items include mandatory parameters, request format, and constraints. If the check fails, the system returns an error. If the check succeeds, response code 202 will be returned.

  • false (default value): A request will be sent and a supplementary network interface will be created.

sub_network_interface

Yes

BatchCreateSubNetworkInterfaceOption object

Request body for creating a supplementary network interface.

count

Yes

Integer

Number of supplementary network interfaces to be created in batches.

Minimum: 1

Maximum: 10

virsubnet_id

Yes

String

• ID of the virtual subnet.

• The value must be in standard UUID format.

parent_id

Yes

String

• ID of the elastic network interface.

• The value must be in standard UUID format.

• The value must be an existing port ID.

security_groups

No

Array of strings

• Security group IDs, for example, "security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"].

• The default value is the default security group.

description

No

String

• Description about the supplementary network interface.

• The value can contain up to 255 characters and cannot contain angle brackets (< or >).

ipv6_enable

No

Boolean

• Whether to enable IPv6 for the supplementary network interface.

• The value can be true (enabled) or false (disabled).

• The default value is false.

project_id

No

String

• Project ID of the supplementary network interface.

• The value must be in standard UUID format.

• Only administrators have permissions to specify project IDs.

allowed_address_pairs

No

Array of AllowAddressPair objects

• IP address and MAC address pairs. For details, see the AllowAddressPair table.

• Note:

  • The IP address cannot be 0.0.0.0.

  • Configure a dedicated security group for the port if allowed_address_pairs has a CIDR block with a netmask length less than 24.

  • ip_address cannot be set to a CIDR block in a hardware SDN environment.

ip_address

No

String

• IP address.

  • You cannot set it to 0.0.0.0.

  • Configure a dedicated security group for the port if allowed_address_pairs has a CIDR block with a netmask length less than 24.

mac_address

No

String

• MAC address.

request_id

String

Request ID.

sub_network_interfaces

Array of SubNetworkInterface objects

Response body for creating supplementary network interfaces in batches.

id

String

• Supplementary network interface ID, which uniquely identifies the supplementary network interface.

• The value is in UUID format with hyphens (-).

virsubnet_id

String

• ID of the virtual subnet.

• The value must be in standard UUID format.

private_ip_address

String

• Private IPv4 address of the supplementary network interface.

• The value must be within the virtual subnet. If this parameter is left blank, an IP address will be randomly assigned.

ipv6_ip_address

String

• IPv6 address of the supplementary network interface.

mac_address

String

• MAC address of the supplementary network interface.

• The value is a valid MAC address assigned by the system randomly.

parent_device_id

String

• Device ID.

• The value must be in standard UUID format.

parent_id

String

• ID of the elastic network interface.

• The value must be in standard UUID format.

description

String

• Description about the supplementary network interface.

• The value can contain up to 255 characters and cannot contain angle brackets (< or >).

vpc_id

String

• VPC ID of the supplementary network interface.

• The value must be in standard UUID format.

vlan_id

Integer

• VLAN ID of the supplementary network interface.

• The value ranges from 1 to 4094.

• Each supplementary network interface has a unique VLAN ID.

security_groups

Array of strings

• Security group IDs, for example, "security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"].

• The default value is the default security group.

tags

Array of ResourceTag objects

• Tags of the supplementary network interface.

project_id

String

• Project ID of the supplementary network interface.

created_at

String

• Time when the supplementary network interface was created.

• The value is a UTC time in the format of yyyy-MM-ddTHH:mm:ssZ.

allowed_address_pairs

Array of AllowAddressPair objects

• IP address and MAC address pairs. For details, see the AllowAddressPair table.

• Note:

  • The IP address cannot be 0.0.0.0.

  • Configure a dedicated security group for the port if allowed_address_pairs has a CIDR block with a netmask length less than 24.

  • ip_address cannot be set to a CIDR block in a hardware SDN environment.

state

String

• Status of the supplementary network interface.

instance_id

String

• ID of the instance that is attached to the supplementary network interface, for example, the RDS instance ID.

instance_type

String

• Type of the instance that is attached to the supplementary network interface, for example, an RDS instance.

scope

String

• Public network egress information of the site where the supplementary network interface works.

security_enabled

Boolean

• Whether the security option is enabled for the supplementary network interface. If the option is not enabled, the security group does not take effect.

key

String

• Tag key

• Tag keys must be unique for each resource.

Minimum: 1

Maximum: 128

value

String

• Tag value.

Maximum: 255

ip_address

String

• IP address.

  • You cannot set it to 0.0.0.0.

  • Configure a dedicated security group for the port if allowed_address_pairs has a CIDR block with a netmask length less than 24.

mac_address

String

• MAC address.

201

Normal response to the POST operation. For more status codes, see Status Codes.