更新时间:2026-05-22 GMT+08:00
分享

创建参数组V3

功能介绍

创建参数组

URI

POST /v3/{project_id}/configurations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数组名称。

参数模板名称在1到64个字符之间,区分大小写,可包含字母、数字、中划线、下划线或句点,不能包含其他特殊字符。

description

String

参数组描述。

描述不能超过256位,且不能包含回车和特殊字符 ! < " = ' > &。

描述超过256个字符时,仍能创建参数组成功,会自动截取前256个字符的描述

values

Map<String,String>

参数解释

参数值对象,用户基于默认参数模板自定义的参数值。

约束限制

不涉及。

取值范围

  • key:参数名称,如“contains_shard_key”,“connection_idle_timeout”。为空时不修改参数值。

  • value:参数值,如“6”,“20”。key不为空时value也不可为空。

默认取值

不涉及。

请求示例

创建参数组

POST https://{endpoint}/v3/{project_id}/configurations
{
  "name" : "param1688972688",
  "description" : "test"
}

响应参数

  • 正常响应参数说明
表4 响应Body参数

参数

参数类型

描述

id

String

参数组id。

name

String

名称。

响应示例

  • 正常响应示例
{
  "id": "404f3bbb8a724f7697e7fb15a1b09370pr09",
  "name": "param1688972688"
}

状态码

错误码

请参见错误码

相关文档