POST /api/subnets
Create a subnet

Examples

POST /api/subnets
{
  "subnet": {
    "name": "QA2",
    "network_type": "IPv4",
    "network": "10.35.2.27",
    "mask": "255.255.255.0",
    "domain_ids": [
      1,
      2
    ]
  }
}
422
{
  "error": {
    "message": "Couldn't find all Domains with 'id': (1, 2) (found 0 results, but was looking for 2). Couldn't find Domains with ids 1, 2."
  }
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
subnet
required

Validations:

  • Must be a Hash
subnet[name]
required

Subnet name

Validations:

  • Must be a String
subnet[description]
optional , nil allowed

Subnet description

Validations:

  • Must be a String
subnet[network_type]
optional , nil allowed

Type or protocol, IPv4 or IPv6, defaults to IPv4

Validations:

  • Must be one of: IPv4, IPv6.
subnet[network]
required

Subnet network

Validations:

  • Must be a String
subnet[cidr]
optional , nil allowed

Network prefix in CIDR notation

Validations:

  • Must be a String
subnet[mask]
optional , nil allowed

Netmask for this subnet

Validations:

  • Must be a String
subnet[gateway]
optional , nil allowed

Subnet gateway

Validations:

  • Must be a String
subnet[dns_primary]
optional , nil allowed

Primary DNS for this subnet

Validations:

  • Must be a String
subnet[dns_secondary]
optional , nil allowed

Secondary DNS for this subnet

Validations:

  • Must be a String
subnet[ipam]
optional , nil allowed

IP Address auto suggestion mode for this subnet.

Validations:

  • Must be one of: DHCP, Internal DB, Random DB, EUI-64, External IPAM, None.
subnet[externalipam_group]
optional , nil allowed

External IPAM group - only relevant when IPAM is set to external

Validations:

  • Must be a String
subnet[from]
optional , nil allowed

Starting IP Address for IP auto suggestion

Validations:

  • Must be a String
subnet[to]
optional , nil allowed

Ending IP Address for IP auto suggestion

Validations:

  • Must be a String
subnet[vlanid]
optional , nil allowed

VLAN ID for this subnet

Validations:

  • Must be a String
subnet[mtu]
optional , nil allowed

MTU for this subnet

Validations:

  • Must be a Integer
subnet[domain_ids]
optional , nil allowed

Domains in which this subnet is part

Validations:

  • Must be an array of any type
subnet[dhcp_id]
optional , nil allowed

DHCP Proxy ID to use within this subnet

Validations:

  • Must be a number.
subnet[tftp_id]
optional , nil allowed

TFTP Proxy ID to use within this subnet

Validations:

  • Must be a number.
subnet[httpboot_id]
optional , nil allowed

HTTPBoot Proxy ID to use within this subnet

Validations:

  • Must be a number.
subnet[externalipam_id]
optional , nil allowed

External IPAM Proxy ID to use within this subnet

Validations:

  • Must be a number.
subnet[dns_id]
optional , nil allowed

DNS Proxy ID to use within this subnet

Validations:

  • Must be a number.
subnet[template_id]
optional , nil allowed

Template HTTP(S) Proxy ID to use within this subnet

Validations:

  • Must be a number.
subnet[bmc_id]
optional , nil allowed

BMC Proxy ID to use within this subnet

Validations:

  • Must be a number.
subnet[boot_mode]
optional , nil allowed

Default boot mode for interfaces assigned to this subnet.

Validations:

  • Must be one of: Static, DHCP.
subnet[subnet_parameters_attributes]
optional , nil allowed

Array of parameters (name, value)

Validations:

  • Must be an array of any type
subnet[location_ids]
optional , nil allowed

REPLACE locations with given ids

Validations:

  • Must be an array of any type
subnet[organization_ids]
optional , nil allowed

REPLACE organizations with given ids.

Validations:

  • Must be an array of any type