Skip to content

Latest commit

 

History

History
170 lines (135 loc) · 5.13 KB

instance_level_ci_variables.md

File metadata and controls

170 lines (135 loc) · 5.13 KB
stage group info
Verify
Pipeline Authoring
To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments

Instance-level CI/CD variables API

DETAILS: Tier: Free, Premium, Ultimate Offering: Self-managed, GitLab Dedicated

List all instance variables

  • description parameter introduced in GitLab 16.8.

Get the list of all instance-level variables.

GET /admin/ci/variables

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/admin/ci/variables"
[
    {
        "key": "TEST_VARIABLE_1",
        "description": null,
        "variable_type": "env_var",
        "value": "TEST_1",
        "protected": false,
        "masked": false,
        "raw": false
    },
    {
        "key": "TEST_VARIABLE_2",
        "description": null,
        "variable_type": "env_var",
        "value": "TEST_2",
        "protected": false,
        "masked": false,
        "raw": false
    }
]

Show instance variable details

  • description parameter introduced in GitLab 16.8.

Get the details of a specific instance-level variable.

GET /admin/ci/variables/:key
Attribute Type Required Description
key string Yes The key of a variable 
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/admin/ci/variables/TEST_VARIABLE_1"
{
    "key": "TEST_VARIABLE_1",
    "description": null,
    "variable_type": "env_var",
    "value": "TEST_1",
    "protected": false,
    "masked": false,
    "raw": false
}

Create instance variable

  • description parameter introduced in GitLab 16.8.

Create a new instance-level variable.

The maximum number of instance-level variables can be changed.

POST /admin/ci/variables
Attribute Type Required Description
key string Yes The key of the variable. Maximum of 255 characters, only A-Z, a-z, 0-9, and _ are allowed.
value string Yes The value of the variable. Maximum of 10,000 characters.
description string No The description of the variable. Maximum of 255 characters.
masked boolean No Whether the variable is masked.
protected boolean No Whether the variable is protected.
raw boolean No Whether the variable is expandable.
variable_type string No The type of the variable. Available types are: env_var (default) and file. 
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
     "https://gitlab.example.com/api/v4/admin/ci/variables" --form "key=NEW_VARIABLE" --form "value=new value"
{
    "key": "NEW_VARIABLE",
    "description": null,
    "value": "new value",
    "variable_type": "env_var",
    "protected": false,
    "masked": false,
    "raw": false
}

Update instance variable

  • description parameter introduced in GitLab 16.8.

Update an instance-level variable.

PUT /admin/ci/variables/:key
Attribute Type Required Description
description string No The description of the variable. Maximum of 255 characters.
key string Yes The key of the variable. Maximum of 255 characters, only A-Z, a-z, 0-9, and _ are allowed.
masked boolean No Whether the variable is masked.
protected boolean No Whether the variable is protected.
raw boolean No Whether the variable is expandable.
value string Yes The value of the variable. Maximum of 10,000 characters.
variable_type string No The type of the variable. Available types are: env_var (default) and file. 
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" \
     "https://gitlab.example.com/api/v4/admin/ci/variables/NEW_VARIABLE" --form "value=updated value"
{
    "key": "NEW_VARIABLE",
    "description": null,
    "value": "updated value",
    "variable_type": "env_var",
    "protected": true,
    "masked": true,
    "raw": true
}

Remove instance variable

Remove an instance-level variable.

DELETE /admin/ci/variables/:key
Attribute Type Required Description
key string Yes The key of a variable 
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/admin/ci/variables/VARIABLE_1"