Help Center> ServiceStage> API Reference> Application Management V2 APIs> Application> Modifying Application Configurations
Updated on 2024-01-09 GMT+08:00
View PDF

Modifying Application Configurations

Function

This API is used to modify application configurations.

Application configurations refer to common environment variables of an application. Components deployed in the application inherit these environment variables.

URI

PUT /v2/{project_id}/cas/applications/{application_id}/configuration

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant's project ID. See Obtaining a Project ID.

application_id

Yes

String

Application ID. See Obtaining All Applications.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type or format.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain a token, see Obtaining a User Token.
Table 3 Request body parameters

Parameter

Mandatory

Type

Description

environment_id

Yes

String

Environment ID, which can be obtained in the corresponding environment by referring to Obtaining All Environments.

configuration

Yes

Object

Application configurations, such as public environment variables. See Table 4.
Table 4 configuration parameter

Parameter

Mandatory

Type

Description

env

Yes

Array of objects

Environment variables of the application. See Table 5.

If the names of multiple environment variables are the same, only the last environment variable takes effect.
Table 5 env parameters

Parameter

Mandatory

Type

Description

name

Yes

String

Name of the environment variable.

The value contains 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and dots (.), and cannot start with a digit.

value

Yes

String

Value of the environment variable.

The env variable in the request parameter configuration will overwrite the existing environment variable configuration of the application. Set this parameter based on the scenario where environment variables are added or replaced.

Response

Table 6 Response parameters

Parameter

Type

Description

application_id

String

Application ID.

environment_id

String

Environment ID.

configuration

Object

Application configurations. See Table 7.
Table 7 configuration parameter

Parameter

Type

Description

env

Array of objects

Environment variables of the application. See Table 8.
Table 8 env parameters

Parameter

Type

Description

name

String

Name of the environment variable.

value

String

Value of the environment variable.

Example Request

Modify the environment whose ID is 0fa75dfe-0d32-4bc1-848b-8008cf3f2567 by changing the name to app-env and the value to env.

{
    "environment_id": "0fa75dfe-0d32-4bc1-848b-8008cf3f2567", 
    "configuration": {
        "env": [
            {
                "name": "app-env", 
                "value": "env"
            }
        ]
    }
}

Example Response

{
    "application_id": "06cf2fda-af45-44b4-9e22-6294c4804515", 
    "environment_id": "0fa75dfe-0d32-4bc1-848b-8008cf3f2567", 
    "configuration": {
        "env": [
            {
                "name": "app-env", 
                "value": "env"
            }
        ]
    }
}

Status Code

Table 9 Status codes

HTTP Status Code

Description

200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

Error Code

The error code format is SVCSTG.00100.[Error_ID], for example, SVCSTG.00100400. For details, see ServiceStage Error Codes.

Parent topic: Application