Creating a ConfigMap

Function

This API is used to create a ConfigMap.

URI

POST /v2/{project_id}/edgemgr/configmaps

Parameter	Mandatory	Description
project_id	Yes	Project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

Request

Request parameters

**Table 1** 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 2** Parameters in the request body
Parameter	Mandatory	Type	Description
configmap	Yes	Table 3 object	ConfigMap information.

**Table 3** configmap
Parameter	Mandatory	Type	Description
name	Yes	String	ConfigMap name. The value must start with a lowercase letter but cannot end with a hyphen (-). The value contains 4 to 64 characters. Only lowercase letters, digits, and hyphens (-) are allowed.
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": {
        "name": "test-cm",
        "description": "this is a test cm",
        "configs": {
            "key1": "val1 ",
            "key2": "val2 "
        }
    }
}

Response

Response parameters

**Table 4** Parameters in the response body
Parameter	Type	Description
configmap	Table 5 object	ConfigMap information.

**Table 5** configmap
Parameter	Type	Description
id	String	ConfigMap ID.
name	String	ConfigMap name.
description	String	ConfigMap description.
configs	Map<String, String>	ConfigMap 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 cm",
        "configs": {
            "key1": "val-1",
            "key2": "val-2"
        },
        "project_id": "d16e6eb6cc0d49a0941df2f31285757a",
        "created_at": "2018-07-16T13:41:25.347335",
        "updated_at": "2018-07-18T13:41:25.347335"
    }
}