Help Center/ Ubiquitous Cloud Native Service/ API Reference/ API/ Fleet/ Adding Clusters to a Fleet
Updated on 2025-12-01 GMT+08:00
View PDF
Share

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 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 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

No

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.
Table 3 Request body parameters

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

Clusters have been added to the fleet.

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

-

String

-

Status code: 500

Table 5 Response body parameters

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

Status code: 200

Clusters have been added to the fleet.

{ }

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.

Parent topic: Fleet