# 向容器舰队中添加集群 - UpdateClusterGroupAssociatedClusters
#### 功能介绍
向容器舰队中添加集群，同批次可以添加一个或多个集群，该接口无法清空或减少管理的集群。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ucs/ucs_api_0026.html)。
#### URI
PUT /v1/clustergroups/{clustergroupid}/associatedclusters
表1路径参数 
| 参数             | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| clustergroupid | 是    | String | 容器舰队ID |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                              |
|:---|:---|:---|:---|
| X-Auth-Token | 否    | String | 身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值 |
| Content-Type | 是    | String | 消息体的类型（格式），仅支持application/json                                  |
   
表3请求Body参数 
| 参数         | 是否必选 | 参数类型             | 描述            |
|:---|:---|:---|:---|
| clusterIds | 否    | Array of strings | 更新容器舰队关联集群信息。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数             | 参数类型             | 描述           |
|:---|:---|:---|
| clusterGroupId | String           | 容器舰队ID       |
| clusterIds     | Array of strings | 更新后关联的集群ID列表 |
| message        | String           | 操作结果信息       |
   
**状态码：400**
表5响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -  |
   
**状态码：500**
表6响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -  |
   
#### 请求示例
更新容器舰队关联的集群信息
```
PUT https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/associatedclusters
{
  "clusterIds" : [ "xxxx-xxxx-xxxx" ]
}
```
#### 响应示例
**状态码：200**
集群加入容器舰队成功
```
{
  "clusterGroupId" : "299ef9b2-d5f1-4028-9c10-b1650cbb40f4",
  "clusterIds" : [ "53d3b2af-bbad-11f0-a3e8-0255ac1001b2", "d3eed044-34bc-11f1-954e-0255ac100b03", "dcf4e276-7e30-11f0-beb1-0255ac100b08" ],
  "message" : "The cluster group associated clusters updated successfully"
}
```
#### 状态码
| 状态码 | 描述                |
|:---|:---|
| 200 | 集群加入容器舰队成功        |
| 400 | 客户端请求错误，服务器无法执行请求 |
| 500 | 服务器内部错误           |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ucs/ErrorCode.html)。