Environment

Environments are organizational containers that group related resources such as key pairs, virtual machines, and volumes within a region. These endpoints let you create, list, retrieve, update, and delete environments, check VM quota, and verify name availability.

Endpoints

---

POST

Create environment

Creates an environment to organize related resources within a region. Environment names must be unique within your organization.

GET

List environments

Returns a list of your existing environments with their ID, name, region, and creation timestamp.

GET

Retrieve environment

Retrieves details for a specified environment by ID.

PUT

Update environment

Updates the name of an existing environment by ID.

DEL

Delete environment

Permanently deletes an environment by ID.

GET

Get environment VM quota

Retrieves VM quota information for a specific environment, including current count, maximum allowed, and percentage used.

GET

Fetch environment name availability

Checks whether a name is available for use as an environment.