创建资源分组
更新时间：2024-12-17
描述
- 本接口用于创建资源分组
请求
请求结构
Plain Text
1POST /v1/res/group请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| - | Group | 是 | body | 需要创建的资源分组 |
Group
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| extra | String | 否 | 资源组的备注，可以为空。最多存储 256 个字符的文本，只能输入中英文字符和数字。 |
| name | String | 是 | 资源组的名称，同一账户下的名称不能重复，支持中英文及常见符号-_ /.，1～20个字符，必填 |
返回
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| groupId | String | 创建的资源组ID |
示例
请求示例
Plain Text
1POST /v1/res/group HTTP/1.1
2Authorization： bce-auth-v1/f0c3d360f64211e8acd0d73d11c152de/2018-12-02T16:00:00Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/c022ed024e2cc6cc743858b16efc2ea19c090cb575f3b08b46071be98118a919
3{
4 "name"："测试资源组",
5 "extra"："测试",
6}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type： application/json; charset=utf-8
3X-Bce-Request-Id： b45001e8-6957-44af-b93d-a4880e61398c
4{
5 "groupId": "RESG-Bih3kin5yOC"
6}错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| ArgumentInvalid | group name is missing. | 400 | 资源组名字缺失 |
| ArgumentInvalid | group name is invalid. | 400 | 资源组名称格式不合法 |
| ArgumentInvalid | Group extra length is invalid. | 400 | 资源组描述长度不合法 |
| ResourceConflict | group name already exists. | 409 | 资源组名称已经存在 |
| QuotaExceeded | Number of group quota is exceeded. | 400 | 资源组超出配额限制 |