更新时间:2024-04-22 GMT+08:00

更新配置项

功能介绍

该API用于更新一个配置项。

URI

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

表1 Path参数

名称

是否必选

说明

project_id

项目ID,获取方法请参见获取项目ID

configmap_id

配置项ID

请求消息

请求参数

表2 请求Header参数

参数

是否必选

类型

描述

Content-Type

String

消息体的类型(格式)

推荐您使用默认值application/json。

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

ief-instance-id

String

铂金版实例ID,专业版实例为空值

表3 请求Body参数

名称

是否必选

参数类型

说明

configmap

表4 object

配置项

表4 configmap

名称

是否必选

参数类型

说明

description

String

配置项描述,最大长度255,不允许^ ~ # $ % & * < > ( ) [ ] { } ' " \

configs

Map<String, String>

configs是一个字典,由多个键值对组成,json化后最大总长度为1048576,key和value均为字符串。键值对中key由大小写字母或中划线开头,由数字、大小写字母、点号(.)、中划线(-)、下划线(_)组成,最小长度为1,最大长度63个字符,键值对中的value无其它限制。

注:configs字典的长度即字典转为标准的字符串后的长度,例如字典{"a": "b"}转为标准字符串后为'{"a": "b"}',长度为10。

请求示例

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

响应消息

响应参数

表5 响应Body参数

名称

参数类型

说明

configmap

表6 object

配置项

表6 configmap

名称

参数类型

说明

id

String

配置项ID

name

String

配置项名称

description

String

配置项描述

configs

Map<String, String>

属性键列表

project_id

String

项目ID

created_at

String

创建时间

updated_at

String

更新时间

响应示例

{
    "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"
    }
}

错误码

请参见错误码