文档首页/裸金属服务器 BMS/API参考/历史API/裸金属服务器状态管理（OpenStack Nova API）/获取远程登录地址（废弃）
更新时间：2025-10-31 GMT+08:00
查看PDF
分享

获取远程登录地址（废弃）

功能介绍

获取裸金属服务器远程登录地址。

当前API已废弃，请使用“获取裸金属服务器远程登录地址 - ShowServerRemoteConsole”。

URL

POST /v2.1/{project_id}/servers/{server_id}/action

参数说明请参见表1。

表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方式请参见获取项目ID。

server_id

是

裸金属服务器ID。

可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    os-getSerialConsole

    是

    Object

    获取裸金属服务器远程登录地址。详情请参见表2。

    表2 os-getSerialConsole字段数据结构说明

    参数

    是否必选

    参数类型

    描述

    type

    是

    String

    获取对象，请将type配置为“serial”。

  • 请求示例
    获取ID为47e9be4e-a7b9-471f-92d9-ffc83814e07a的裸金属服务器的远程登录地址。 
    1
    POST https://{ECS Endpoint}/v2/9c53a566cb3443ab910cf0daebca90c4/servers/47e9be4e-a7b9-471f-92d9-ffc83814e07a/action

    1
2
3
4
5
    {
    "os-getSerialConsole": {
        "type": "serial"
    }
}

响应消息

  • 响应参数

    无

  • 响应示例 
    1
2
3
4
5
6
    {
    "console": {
        "url": "https://baremetal-consoleproxy.az1.dc1.domainname.com:8003/?token=040134bb-9195-4029-9a62-550bce390258",
        type": "serial"
    }
}

返回值

正常返回值：

返回值

说明

200

服务器已成功处理了请求。

其他返回值请参考状态码。

错误码

请参考错误码。