Updated on 2024-12-16 GMT+08:00

Creating a Configuration Group

Function

This API is used to create a configuration group to manage configuration files.

URI

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

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant's project ID. See Obtaining a Project ID.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Default value: application/json;charset=utf8.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain the token, see Authentication.

Table 3 Request body parameter

Parameter

Mandatory

Type

Description

name

Yes

String

Configuration group name.

The value contains 2 to 64 characters consisting of letters, digits, hyphens (-), and underscores (_). It starts with a letter and ends with a letter or digit.

description

No

String

Configuration group description.

The value can contain up to 256 characters.

Response

Table 4 Response parameters

Parameter

Type

Description

id

String

Configuration group ID.

name

String

Configuration group name.

description

String

Configuration group description.

creator

String

Creator.

project_id

String

Project ID.

create_time

Integer

Creation time.

Example Request

Create a configuration group named test-group.

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

Example Response

{
	"id": "0f5722ea-ee97-42bf-8583-404caa0a46e5",
	"project_id": "2cfeefc3e4c54a5aa7548b8350e638d7",
	"name": "test-group",
	"description": "",
	"create_time": 1717482692680,
	"creator": "ss-test"
}

Status Code

Status Code

Description

200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

Error Code

The error code format is SVCSTG.00100.[Error_ID], for example, SVCSTG.00100400. For details, see ServiceStage Error Codes.