---
title: LinkLlmClusters
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/llmdatadistdev/llmcrv1_42_09.html
sourcePath: /source/zh/canncommercial/900/others/llmdatadistdev/llmcrv1_42_09.html
indexId: 0b2856b9a83d63d2ae6678301aa9517db20956f73e3b853db5dcb6f2d621b05b70
---
# LinkLlmClusters

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | x |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | x |
| Atlas 推理系列产品 | x |
| Atlas 训练系列产品 | x |


说明：针对 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，仅支持Atlas 800I A2 推理服务器、A200I A2 Box 异构组件。


#### 函数功能

进行Device间建链。


#### 函数原型

```
Status LinkLlmClusters(const std::vector<ClusterInfo> &clusters, std::vector<Status> &rets, int32_t timeout_in_millis = 1000)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| clusters | 输入 | 需要建链的cluster信息。类型为ClusterInfo。 |
| rets | 输出 | 每个cluster建链结果。 |
| timeout\_in\_millis | 输入 | 建链超时时间，单位ms。默认超时1000。 |


#### 返回值

- LLM_SUCCESS：只有所有clusters建链成功，接口才会返回成功。
- 其他：建链失败，需要查看每个cluster的建链结果。


#### 异常处理

- LLM_PROCESSING_LINK：接口有锁保护，一个LLM-DataDist多线程调用建链接口会串行执行，其他线程等待时间超过设置的超时时间会报错退出。
- LLM_ALREADY_LINK：增量的cluster已经和全量cluster建立了链接。
- LLM_LINK_FAILED：建链失败。
- LLM_CLUSTER_NUM_EXCEED_LIMIT：建链cluster数量超过上限，当前是16个。


#### 约束说明

需要在Initialize接口初始化完成后调用，只支持角色为Decoder时调用。