# 获取远程登录地址（废弃）
#### 功能介绍
获取裸金属服务器远程登录地址。
当前API已废弃，请使用"[获取裸金属服务器远程登录地址 - ShowServerRemoteConsole](https://support.huaweicloud.com/api-bms/bms_api_0617.html)"。
#### URL
POST /v2.1/{project_id}/servers/{server_id}/action
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                                                                  |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。                           |
| server_id  | 是    | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用[查询裸金属服务器列表（废弃）](https://support.huaweicloud.com/api-bms/bms_api_0709.html)获取。 |
   
#### 请求消息
- 请求参数
  
  | 参数                  | 是否必选 | 参数类型   | 描述                                                           |
  |:---|:---|:---|:---|
  | os-getSerialConsole | 是    | Object | 获取裸金属服务器远程登录地址。详情请参见[表2]。 |
     
   表2os-getSerialConsole字段数据结构说明 
  | 参数   | 是否必选 | 参数类型   | 描述                      |
  |:---|:---|:---|:---|
  | type | 是    | String | 获取对象，请将type配置为"serial"。 |
     
  
- 请求示例
  获取ID为47e9be4e-a7b9-471f-92d9-ffc83814e07a的裸金属服务器的远程登录地址。
  ```
  POST https://{ECS Endpoint}/v2/9c53a566cb3443ab910cf0daebca90c4/servers/47e9be4e-a7b9-471f-92d9-ffc83814e07a/action
  ```
  ```
  {
      "os-getSerialConsole": {
          "type": "serial"
      }
  }
  ```
  
 
#### 响应消息
- 响应参数 无
  
- 响应示例
  ```
  {
      "console": {
          "url": "https://baremetal-consoleproxy.az1.dc1.domainname.com:8003/?token=040134bb-9195-4029-9a62-550bce390258",
          type": "serial"
      }
  }
  ```
  
 
#### 返回值
正常返回值：
| 返回值 | 说明           |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。