Function

This API is used to add clusters to a fleet. One or more clusters can be added at the same time. This API cannot be used to remove all or some clusters from a fleet.

URI

PUT /v1/clustergroups/{clustergroupid}/associatedclusters

**Table 1** Path parameter
Parameter	Mandatory	Type	Description
clustergroupid	Yes	String	Fleet ID

Request Parameters

**Table 2** Parameters in the request header
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Identity authentication information. Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token.
Content-Type	Yes	String	Message body type (format). Only application/json is supported.

**Table 3** Parameter in the request body
Parameter	Mandatory	Type	Description
clusterIds	No	Array of strings	Cluster IDs for updating information about clusters associated with a fleet

Response Parameters

None

Example Requests

Updating clusters in a fleet

{
  "clusterids" : [ "xxxx-xxxx-xxxx" ]
}

Example Responses

None

Status Codes

Status Code	Description
200	Clusters have been added to the fleet.
400	Client request error. The server could not execute the request.
500	Internal server error.

Error Codes

See Error Codes.

Adding Clusters to a Fleet