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

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| 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 异构组件。


#### 函数功能

设置LLM-DataDist的角色。建议仅在使用PagedAttention的场景使用。


#### 函数原型

```
Status SetRole(LlmRole role, const std::map<AscendString, AscendString> &options = {})
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| role | 输入 | 角色类型，类型为LlmRole。 |
| options | 输入 | 设置角色的参数，当前支持的参数请参见表1。 |


**表1 配置项**

| 配置项 | 可选/必选 | 描述 |
| --- | --- | --- |
| OPTION\_LISTEN\_IP\_INFO | 切换至Prompt必选 | 设置为Device的IP地址和端口，如"192.168.1.1:26000" |


#### 返回值

- LLM_SUCCESS：设置角色成功
- LLM_PARAM_INVALID：参数错误
- LLM_FEATURE_NOT_ENABLED：该特性未使能
- LLM_EXIST_LINK：存在残留链路资源
- 其他：失败


#### 异常处理

无


#### 约束说明

LLM-DataDist初始化时，需要设置OPTION_ENABLE_SET_ROLE为"1"，才可以使用该接口。