Updated on 2023-11-23 GMT+08:00

Updating a ConfigMap

Function

This API is used to update a ConfigMap.

URI

PUT /v2/{project_id}/edgemgr/configmaps/{configmap_id}

Table 1 Path parameters

Parameter

Mandatory

Description

project_id

Yes

Project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

configmap_id

Yes

ConfigMap ID.

Request

Request parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format).

The default value application/json is recommended.

X-Auth-Token

Yes

String

User token. The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Table 3 Parameters in the request body

Parameter

Mandatory

Type

Description

configmap

Yes

Table 4 object

ConfigMap information.

Table 4 configmap

Parameter

Mandatory

Type

Description

description

No

String

ConfigMap description. The value contains a maximum of 255 characters. The following characters are not allowed: ^~#$%&*<>()[]{}'"\

configs

No

Map<String, String>

configs is a dictionary consisting of multiple key-value pairs. The maximum length of the dictionary is 1,048,576 characters after being converted into JSON strings. The keys and values are strings. The key in a key-value pair must contain 1 to 63 characters and start with a letter or hyphen. Only letters, digits, periods (.), hyphens (-), and underscores (_) are allowed. There is no other restriction on the value in the key-value pair.

Note: The length of the configs dictionary is the length after the dictionary is converted into a standard string. For example, after the dictionary {"a": "b"} is converted into a standard string '{"a": "b"}', the length is 10 characters.

Example request

{
    "configmap": {
        "description": "this is a test cm2",
        "configs": {
            "key1": "val-1",
            "key2": null,
            "key3": "val-3"
        }
    }
}

Response

Response parameters

Table 5 Parameters in the response body

Parameter

Type

Description

configmap

Table 6 object

ConfigMap information.

Table 6 configmap

Parameter

Type

Description

id

String

ConfigMap ID.

name

String

ConfigMap name.

description

String

ConfigMap description.

configs

Map<String, String>

Configuration key list.

project_id

String

Project ID.

created_at

String

Time when the ConfigMap is created.

updated_at

String

Update time.

Example response

{
    "configmap": {
        "id": "12ns9eb6cc0d49a0941df2f31283mds8 ",
        "name": "test-cm",
        "description": "this is a test cm2",
        "configs": {
            "key1": "val1",
            "key3": "val3"
        },
        "project_id": "d16e6eb6cc0d49a0941df2f31285757a",
        "created_at": "2018-07-16T13:41:25.347335",
        "updated_at": "2018-07-19T13:41:25.347335"
    }
}

Error Codes

For details, see Error Codes.