Updating a Project

You can update a project using OKS CLI.

Updating a Project Using OKS CLI

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

The project update command allows you to modify certain project options:

The specified project will then be redeployed with the latest OMI versions.
Request sample
$ oks-cli project update \
    --project-name NAME_OF_PROJECT \
    --description "DESCRIPTION_OF_PROJECT" \
    --tags \
    --disable-api-termination true \
    --output json

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

  • project-name: The name of the project that you want to update.

  • (optional) description: The updated description for the project.

  • (optional) tags: The updated tags for the project.

  • (optional) quirk: Advanced keys and parameters to pass to the control panel of the project. This option is required for feature requests.

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

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

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": true,
    "created_at": "2025-01-01T12:10:00.000000Z",
    "updated_at": "2025-01-02T17:00:00.000000Z",
    "deleted_at": null
}

The project update 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).

  • organization_id: The organization to which the project belongs.

Related Pages

Corresponding API Method

Export to PDF