更新时间:2026-01-08 GMT+08:00
创建服务器组
功能介绍
创建服务器组
URI
POST /v5/{project_id}/host-management/groups
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enterprise_project_id | 否 | String | 企业项目ID,查询所有企业项目时填写:all_granted_eps |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
| region | 是 | String | Region ID |
| Content-Type | 否 | String | 缺省值:application/json; charset=utf-8 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| group_name | 是 | String | 服务器组名称 |
| host_id_list | 是 | Array of strings | 服务器ID列表 |
响应参数
状态码:200
请求已成功
无
请求示例
创建名称为test的服务器组,服务器组中包含的服务器ID为15dac7fe-d81b-43bc-a4a7-4710fe673972。
POST https://{endpoint}/v5/{project_id}/host-management/groups
{
"group_name" : "test",
"host_id_list" : [ "15dac7fe-d81b-43bc-a4a7-4710fe673972" ]
} 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功 |
| 400 | 参数非法 |
| 401 | 鉴权失败 |
| 403 | 权限不足 |
| 404 | 资源未找到 |
| 500 | 系统异常 |
错误码
请参见错误码。
父主题: 主机管理