UnlinkLlmClusters

Applicable Products

Product	Supported (√/x)
Ascend 950PR/Ascend 950DT	√
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	x
Atlas inference products	x
Atlas training products	x

Note: For Atlas A2 training products/Atlas A2 inference products, only the Atlas 800I A2 inference server and A200I A2 Box heterogeneous subrack are supported.

Function Description

Disconnects a link between LLM-DataDist clusters.

Prototype

Status UnlinkLlmClusters(const std::vector<ClusterInfo> &clusters, std::vector<Status> &rets, int32_t timeout_in_millis = 1000, bool force_flag = false)

Parameters

Parameter	Input/Output	Description
clusters	Input	Information about the clusters whose links are to be disconnected. The type is ClusterInfo.
rets	Output	Link disconnection result of each cluster.
timeout_in_millis	Input	Link disconnection timeout interval, in milliseconds.
force_flag	Input	Indicates whether to perform forcible disconnection. By default, this feature is disabled. For forcible link disconnection, only the local link is forcibly disconnected; therefore, this API must be called on both ends. Non-forcible link disconnection is initiated by the client. If no link fault occurs, the link is disconnected on both ends. However, if a link fault occurs, forcible link disconnection must be initiated on the server, which is time-consuming.

Returns

LLM_SUCCESS: A success message is returned only when links are successfully disconnected for all clusters.
Other values: Link disconnection fails. Check the link disconnection result of each cluster in rets.

Exception Handling

LLM_UNLINK_FAILED: Link disconnection fails.

Constraints

Before calling this API, call the Initialize API to complete initialization.

Parent topic: LLM-DataDist APIs