VPC Subnets

Configure VPC subnets and attach instances to them

create-subnet

Create a Subnet

POST /vpc/{vpc-id}/subnet

Path parameters

Name	In	Description
`vpc-id`	`path`	Must be a valid UUID.

Request body

Content-Type: application/json

Property	Type	Required	Description
`address-space`	string	yes	Whether the subnet is private or public Allowed values: `private`.
`addressfamily`	string	yes	Whether the subnet supports IPv4 and/or IPv6 Allowed values: `inet4`.
`name`	string	yes	Subnet name, up to 255 characters. Must be unique between the subnet of the parent VPC Min length: `1`. Max length: `255`.
`description`	string	no	Max length: `4096`.
`ipv4-block`	string	no	Subnet ipv4 CIDR. Must not overlap with other CIDRs of this VPC
`labels`	object	no

Example

{
  "address-space": "private",
  "addressfamily": "inet4",
  "description": "string",
  "ipv4-block": "string",
  "labels": {},
  "name": "string"
}

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`id`	string	Operation ID Must be a valid UUID.
`message`	string	Operation message
`reason`	string	Operation failure reason Allowed values: `incorrect`, `unknown`, `unavailable`, `forbidden`, `busy`, `fault`, `partial`, `not-found`, `interrupted`, `unsupported`, `conflict`.
`reference`	Reference	Related resource reference
`state`	string	Operation status Allowed values: `failure`, `pending`, `success`, `timeout`.

Example output

{
  "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
  "message": "string",
  "reason": "incorrect",
  "reference": {
    "command": "string",
    "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
    "link": "string"
  },
  "state": "failure"
}

SDK reference for create-subnet: golang | Python | Java

CLI: exo api create-subnet

get-subnet

Retrieve Subnet details

GET /vpc/{vpc-id}/subnet/{id}

Path parameters

Name	In	Description
`vpc-id`	`path`	Must be a valid UUID.
`id`	`path`	Must be a valid UUID.

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`address-space`	string	Whether the subnet is private or public Allowed values: `private`.
`addressfamily`	string	Whether the subnet support IPv4 and/or IPv6 Allowed values: `inet4`, `dual`.
`created-at`	string	ISO 8601 date-time.
`description`	string	Max length: `4096`.
`id`	string	Must be a valid UUID.
`instances`	array of Instances	Instances attached to the subnet
`ipv4-block`	string	Subnet ipv4 CIDR
`labels`	object
`name`	string	Min length: `1`. Max length: `255`.

Example output

{
  "address-space": "private",
  "addressfamily": "inet4",
  "created-at": "2026-01-01T00:00:00Z",
  "description": "string",
  "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
  "instances": [
    {
      "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
      "ipv4": "192.0.2.10",
      "name": "string"
    }
  ],
  "ipv4-block": "string",
  "labels": {},
  "name": "string"
}

SDK reference for get-subnet: golang | Python | Java

CLI: exo api get-subnet

update-subnet

Update a Subnet

PUT /vpc/{vpc-id}/subnet/{id}

Path parameters

Name	In	Description
`vpc-id`	`path`	Must be a valid UUID.
`id`	`path`	Must be a valid UUID.

Request body

Content-Type: application/json

Property	Type	Required	Description
`description`	string	no	Max length: `4096`.
`labels`	object	no
`name`	string	no	Min length: `1`. Max length: `255`.

Example

{
  "description": "string",
  "labels": {},
  "name": "string"
}

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`address-space`	string	Whether the subnet is private or public Allowed values: `private`.
`addressfamily`	string	Whether the subnet support IPv4 and/or IPv6 Allowed values: `inet4`, `dual`.
`created-at`	string	ISO 8601 date-time.
`description`	string	Max length: `4096`.
`id`	string	Must be a valid UUID.
`instances`	array of Instances	Instances attached to the subnet
`ipv4-block`	string	Subnet ipv4 CIDR
`labels`	object
`name`	string	Min length: `1`. Max length: `255`.

Example output

{
  "address-space": "private",
  "addressfamily": "inet4",
  "created-at": "2026-01-01T00:00:00Z",
  "description": "string",
  "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
  "instances": [
    {
      "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
      "ipv4": "192.0.2.10",
      "name": "string"
    }
  ],
  "ipv4-block": "string",
  "labels": {},
  "name": "string"
}

SDK reference for update-subnet: golang | Python | Java

CLI: exo api update-subnet

delete-subnet

Delete a Subnet

DELETE /vpc/{vpc-id}/subnet/{id}

Path parameters

Name	In	Description
`vpc-id`	`path`	Must be a valid UUID.
`id`	`path`	Must be a valid UUID.

Responses

Status: 204 - 204

SDK reference for delete-subnet: golang | Python | Java

CLI: exo api delete-subnet

Other Operations

detach-instance-from-subnet

Detach a Compute instance from a Subnet

PUT /vpc/{vpc-id}/subnet/{subnet-id}/detach

Path parameters

Name	In	Description
`vpc-id`	`path`	Must be a valid UUID.
`subnet-id`	`path`	Must be a valid UUID.

Request body

Content-Type: application/json

Property	Type	Required	Description
`instance`	Target Instance	yes	The target instance to detach

Example

{
  "instance": {
    "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab"
  }
}

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`id`	string	Operation ID Must be a valid UUID.
`message`	string	Operation message
`reason`	string	Operation failure reason Allowed values: `incorrect`, `unknown`, `unavailable`, `forbidden`, `busy`, `fault`, `partial`, `not-found`, `interrupted`, `unsupported`, `conflict`.
`reference`	Reference	Related resource reference
`state`	string	Operation status Allowed values: `failure`, `pending`, `success`, `timeout`.

Example output

{
  "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
  "message": "string",
  "reason": "incorrect",
  "reference": {
    "command": "string",
    "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
    "link": "string"
  },
  "state": "failure"
}

SDK reference for detach-instance-from-subnet: golang | Python | Java

CLI: exo api detach-instance-from-subnet

attach-instance-to-subnet

Attach a Compute instance to a Subnet

PUT /vpc/{vpc-id}/subnet/{subnet-id}/attach

Path parameters

Name	In	Description
`vpc-id`	`path`	Must be a valid UUID.
`subnet-id`	`path`	Must be a valid UUID.

Request body

Content-Type: application/json

Property	Type	Required	Description
`instance`	Target Instance	yes	The target instance to attach
`ipv4`	string	no	An optional IPv4 address assign to the instance Must be a valid IPv4 address.

Example

{
  "instance": {
    "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab"
  },
  "ipv4": "192.0.2.10"
}

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`id`	string	Operation ID Must be a valid UUID.
`message`	string	Operation message
`reason`	string	Operation failure reason Allowed values: `incorrect`, `unknown`, `unavailable`, `forbidden`, `busy`, `fault`, `partial`, `not-found`, `interrupted`, `unsupported`, `conflict`.
`reference`	Reference	Related resource reference
`state`	string	Operation status Allowed values: `failure`, `pending`, `success`, `timeout`.

Example output

{
  "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
  "message": "string",
  "reason": "incorrect",
  "reference": {
    "command": "string",
    "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
    "link": "string"
  },
  "state": "failure"
}

SDK reference for attach-instance-to-subnet: golang | Python | Java

CLI: exo api attach-instance-to-subnet

list-subnets

List Subnets

GET /vpc/{vpc-id}/subnet

Path parameters

Name	In	Description
`vpc-id`	`path`	Must be a valid UUID.

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`subnets`	array of Subnet

Example output

{
  "subnets": [
    {
      "address-space": "private",
      "addressfamily": "inet4",
      "created-at": "2026-01-01T00:00:00Z",
      "description": "string",
      "id": "a1b2c3d4-e5f6-4a5b-8c9d-0123456789ab",
      "ipv4-block": "string",
      "labels": {},
      "name": "string"
    }
  ]
}

SDK reference for list-subnets: golang | Python | Java

CLI: exo api list-subnets

Last updated on October 29, 2026