unlink_clusters

Applicability

Product	Supported
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 the Atlas A2 training products/Atlas A2 inference products, only the Atlas 800I A2 inference server, Atlas 300I A2 inference card, and A200I A2 Box heterogeneous components 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. In forcible disconnection, only the local link is forcibly disconnected, therefore, this function needs to be called at both ends. Non-forcible 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.

In forcible disconnection, only the local link is forcibly disconnected, therefore, this function needs to be called at both ends.
Non-forcible 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 setup 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