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

Enabling Cluster Federation

Function

This API is used to enable cluster federation for a fleet.

URI

POST /v1/clustergroups/{clustergroupid}/federations

Table 1 Path parameters

Parameter

Mandatory

Type

Description

clustergroupid

Yes

String

Fleet ID

Table 2 Query parameters

Parameter

Mandatory

Type

Description

retryjoinall

No

Boolean

Whether to retry adding the cluster to the federation.

Request Parameters

Table 3 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Identity authentication information

Response Parameters

Status code: 201

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: 404

Table 6 Parameters in the response body

Parameter

Type

Description

-

String

Status code: 500

Table 7 Parameters in the response body

Parameter

Type

Description

-

String

Example Requests

Enabling cluster federation for a fleet

POST https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/federations

Example Responses

None

Status Codes

Status Code

Description

201

Cluster federation has been enabled.

400

Client request error. The server could not execute the request.

404

Resources not found.

500

Internal server error.

Error Codes

See Error Codes.