POST /networks/{id}/actions/add_subnet

Adds a new subnet to the Network.

If the subnet ip_range is not provided, the first available /24 IP range will be used.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

Servers

Path parameters

Name Type Required Description
id Integer Yes

ID of the Network.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
type String Yes

Type of subnet.

  • cloud - Used to connect cloud Servers and Load Balancers.
  • server - Same as the cloud type. Deprecated, use the cloud type instead.
  • vswitch - Used to connect cloud Servers and Load Balancers with dedicated Servers.

Possible values:

  • "cloud"
  • "server"
  • "vswitch"
network_zone String Yes

Name of the Network Zone.

The Location contains the network_zone it belongs to.

vswitch_id Integer No

ID of the robot vSwitch.

Must be supplied if the subnet is of type vswitch.

ip_range String No

IP range of the subnet.

Uses CIDR notation.

Must be a subnet of the parent Networks ip_range.

Must not overlap with any other subnets or with any destinations in routes.

Minimum network size is /30. We highly recommend that you pick a larger subnet with a /24 netmask.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.