unlink_clusters

Applicability

Product	Supported (√/x)
Atlas 350 Accelerator Card	x
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	x
Atlas inference product	x
Atlas training product	x

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

Function Description

Disconnects a link unilaterally. The request can be initiated by the client to notify the server of disconnection. Alternatively, both the client and server can initiate forcible disconnection to clean up only local links.

Prototype

unlink_clusters(clusters: Union[List[LLMClusterInfo], Tuple[LLMClusterInfo]], timeout=3000, force=False)

Parameters

Parameter	Data Type	Description
clusters	Union[List[LLMClusterInfo], Tuple[LLMClusterInfo]]	Cluster list.
timeout	int	Timeout interval, in milliseconds. The default timeout interval is 3000 ms.
force	bool	Whether to forcibly disconnect the link. The default value is False. True indicates forcible disconnection. 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 fault occurs, both ends of the link are disconnected. If a fault occurs, a disconnection operation needs to be initiated by the server.

Parameter

Data Type

Description

clusters

Union[List[LLMClusterInfo], Tuple[LLMClusterInfo]]

Cluster list.

timeout

int

Timeout interval, in milliseconds. The default timeout interval is 3000 ms.

force

bool

Whether to forcibly disconnect the link. The default value is False. True indicates forcible disconnection.

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 fault occurs, both ends of the link are disconnected.
- If a fault occurs, a disconnection operation needs to be initiated by the server.

Example

Click GitCode, select the matching version, and obtain the sample from the examples/python directory.

Returns

In normal cases, a tuple of two values is returned. The first value is the return value of the API, and the type is LLMStatusCode. The second value is the list of link establishment results of each cluster, and the type is LLMStatusCode.

If a parameter is incorrect, a TypeError or ValueError may be thrown.

Restrictions

None

Parent topic: LLMDataDist