Updated on 2025-07-15 GMT+08:00

Adding Clusters to a Fleet

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 parameters

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

Table 3 Parameters 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

Status code: 200

Table 4 Parameters in the response body

Parameter

Type

Description

-

String

Status code: 400

Table 5 Parameters in the response body

Parameter

Type

Description

-

String

Status code: 500

Table 6 Parameters in the response body

Parameter

Type

Description

-

String

Example Requests

Updating clusters in a fleet

PUT https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/associatedclusters

{
  "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.