VPC – Exoscale Documentation

[BETA] Create and manipulate VPCs

create-vpc

[BETA] Create a VPC

POST /vpc

Request body

Content-Type: application/json

Property	Type	Required	Description
`name`	string	yes	VPC name Min length: `1`. Max length: `255`.
`description`	string	no	VPC description Max length: `4096`.
`dhcp-options`	VPC DHCP options	no	DHCP options
`labels`	object	no	Resource labels

Example

{
  "description": "string",
  "dhcp-options": {
    "dns-servers": [
      "string"
    ],
    "domain-search": [
      "string"
    ],
    "ntp-servers": [
      "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": "string",
  "message": "string",
  "reason": "incorrect",
  "reference": {
    "command": "string",
    "id": "string",
    "link": "string"
  },
  "state": "failure"
}

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

CLI: exo api create-vpc

get-vpc

[BETA] Retrieve VPC details

GET /vpc/{id}

Path parameters

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

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`created-at`	string	VPC creation date ISO 8601 date-time.
`default`	boolean	Indicates if this is the organization’s default VPC
`description`	string	VPC description Max length: `4096`.
`dhcp-options`	VPC DHCP options	DHCP options
`id`	string	VPC ID Must be a valid UUID.
`labels`	object	Resource labels
`name`	string	VPC name Min length: `1`. Max length: `255`.

Example output

{
  "created-at": "2024-01-01T12:00:00Z",
  "default": true,
  "description": "string",
  "dhcp-options": {
    "dns-servers": [
      "string"
    ],
    "domain-search": [
      "string"
    ],
    "ntp-servers": [
      "string"
    ]
  },
  "id": "string",
  "labels": {},
  "name": "string"
}

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

CLI: exo api get-vpc

update-vpc

[BETA] Update a VPC

PUT /vpc/{id}

Path parameters

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

Request body

Content-Type: application/json

Property	Type	Required	Description
`description`	string	no	VPC description Max length: `4096`.
`dhcp-options`	VPC DHCP options	no	DHCP options (only allowed if VPC has no instances attached)
`labels`	object	no	Resource labels
`name`	string	no	VPC name Min length: `1`. Max length: `255`.

Example

{
  "description": "string",
  "dhcp-options": {
    "dns-servers": [
      "string"
    ],
    "domain-search": [
      "string"
    ],
    "ntp-servers": [
      "string"
    ]
  },
  "labels": {},
  "name": "string"
}

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`created-at`	string	VPC creation date ISO 8601 date-time.
`default`	boolean	Indicates if this is the organization’s default VPC
`description`	string	VPC description Max length: `4096`.
`dhcp-options`	VPC DHCP options	DHCP options
`id`	string	VPC ID Must be a valid UUID.
`labels`	object	Resource labels
`name`	string	VPC name Min length: `1`. Max length: `255`.

Example output

{
  "created-at": "2024-01-01T12:00:00Z",
  "default": true,
  "description": "string",
  "dhcp-options": {
    "dns-servers": [
      "string"
    ],
    "domain-search": [
      "string"
    ],
    "ntp-servers": [
      "string"
    ]
  },
  "id": "string",
  "labels": {},
  "name": "string"
}

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

CLI: exo api update-vpc

delete-vpc

[BETA] Delete a VPC

DELETE /vpc/{id}

Path parameters

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

Responses

Status: 204 - 204

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

CLI: exo api delete-vpc

Other Operations

list-vpcs

[BETA] List VPCs

GET /vpc

Responses

Status: 200 - 200

Content-Type: application/json

Property	Type	Description
`vpcs`	array of VPC

Example output

{
  "vpcs": [
    {
      "created-at": "2024-01-01T12:00:00Z",
      "default": true,
      "description": "string",
      "dhcp-options": {
        "dns-servers": [
          "string"
        ],
        "domain-search": [
          "string"
        ],
        "ntp-servers": [
          "string"
        ]
      },
      "id": "string",
      "labels": {},
      "name": "string"
    }
  ]
}

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

CLI: exo api list-vpcs

Last updated on September 16, 2026