Getting Information About a Specific Project

You can get information about a specific project using OKS CLI.

Getting Information About a Specific Project Using OKS CLI

Before you begin: Install and configure OKS CLI. For more information, see Installing and Configuring OKS CLI.

The project get command allows you to retrieve information about a specific project:

Request sample
$ oks-cli project get \
    --project-name NAME_OF_PROJECT \
    --output json

This command contains the following options that you need to specify:

  • project-name: The name of the project that you want to retrieve information from.

  • (optional) output: The output format for the response (json | yaml). By default, the response format is JSON.

The project get command returns the following elements:

  • id: The unique identifier of the project.

  • name: The name of the project.

  • description: The description of the project.

  • cidr: The CIDR block allocated for VPC subnets where cluster VMs will run.

  • region: The Region where the project is deployed.

  • status: The current state of the project (pending | ready | deploying | updating | upgrading | failed | deleting).

  • tags: One or more tags associated with the project.

  • created_at: The date and time, in UTC format, at which the project was created.

  • updated_at: The date and time, in UTC format, at which the project was last updated.

  • deleted_at: The date and time, in UTC format, at which the project was deleted (null if the project is still active).

  • disable-api-termination: The ability to delete the project through the API. If true, project deletion is disabled. If false, it is enabled.

Result sample
{
    "id": "12ca0d38-2927-4cf1-93de-049135f88f00",
    "name": "NAME_OF_PROJECT",
    "description": "DESCRIPTION_OF_PROJECT",
    "cidr": "10.50.0.0/16",
    "region": "eu-west-2",
    "status": "ready",
    "tags": {
        "tag1": "this",
        "tag2": "that"
    },
    "disable_api_termination": false,
    "created_at": "2025-01-01T12:10:00.000000Z",
    "updated_at": "2025-01-01T12:12:10.000000Z",
    "deleted_at": null
}

Related Pages

Corresponding API Method

Export to PDF