# 获取串口登录地址 - ShowSerialConsoleActions
#### 功能介绍
获取云服务器的串口登录地址。
#### 接口约束
该接口仅在"非洲-开罗"、""非洲-约翰内斯堡"和"中东-利雅得"区域支持，其他区域暂不支持。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ECS/doc?api=ShowSerialConsoleActions)中调试该接口。
#### URI
POST /v1/{project_id}/cloudservers/{server_id}/actions/serial-console
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| project_id | 是    | **参数解释：** 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| server_id  | 是    | **参数解释：** 云服务器ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                        |
   
#### 请求消息
无
#### 响应消息
响应参数如[表2]所示。
 表2响应参数 
| 参数             | 参数类型   | 描述                                                                                                                                                                                       |
|:---|:---|:---|
| serial_console | Object | **参数解释：** 串口登录地址。详情请参见[表3]。 **取值范围：** 不涉及 |
   
 表3serial_console参数信息 
| 参数  | 参数类型   | 描述                                                                                                                             |
|:---|:---|:---|
| url | String | **参数解释：** 串口登录的URL。 **取值范围：** 不涉及 |
   
#### 请求示例
```
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/serial-console
```
#### 响应示例
```
{ 
     "serial_console": { 
             "url": "xxxx" 
         } 
 }
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。