更新时间:2025-07-08 GMT+08:00

创建配置分组

功能介绍

此API用于创建配置分组,用于对配置文件分类管理。

URI

POST /v3/{project_id}/cas/config-groups

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目ID。获取方法,请参考获取项目ID

请求消息

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式),默认取值为“application/json;charset=utf8”。

X-Auth-Token

String

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考认证鉴权

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

配置分组名称。

由大小写英文字母、数字、中划线(-)、下划线(_)组成,并以大小写英文字母开头,大小写英文字母或者数字结尾,长度为2~64个字符。

description

String

配置分组描述。

最大长度为256个字符。

enterprise_project_id

String

企业项目ID。

如果不配置此参数,则默认企业项目为“default”,ID为0。

labels

Array of objects

标签,可使用标签管理服务通过标签过滤资源,请参考表4

表4 labels

参数

是否必选

参数类型

描述

key

String

标签名称。

value

String

标签值。

响应消息

表5 响应参数

参数

参数类型

描述

id

String

配置分组ID。

name

String

配置分组名称。

description

String

配置分组描述。

creator

String

创建人。

project_id

String

项目ID。

create_time

Integer

创建时间。

请求示例

创建名为test-group的配置分组。

{
	"name": "test-group",
	"description": ""
}

响应示例

{
    "id": "3f10d752-80e9-4d80-ad74-454fd59e23a7",
    "project_id": "b6097e34f6694a1fa2a49052acc9718d",
    "name": "test-group",
    "description": null,
    "create_time": 1744698133769,
    "creator": "ss-test",
    "labels": [],
    "enterprise_project_id": "0",
    "enterprise_project_name": null
}

状态码

状态码

描述

200

操作成功。

400

错误的请求。

404

请求对象不存在。

500

内部错误。

错误码

请参考ServiceStage错误码