接口功能介绍

该接口提供用户轻量型云主机信息查询功能，用户可以根据此接口的返回值了解自己轻量型云主机的详细信息。
准备工作：
  构造请求：在调用前需要了解如何构造请求，详情查看构造请求
  认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
注意事项：
  单台查询：当前接口只能查询单台云主机信息，查询多台云主机信息请使用接口查询轻量型云主机列表进行查询

接口约束

  1. 使用限制，本接口只支持在部分资源池进行公测
  2. 确保当前请求资源池下，该云主机存在

URI

GET /v4/ecs/lite/details

路径参数
无

Query参数

请求参数

请求头header参数
无

请求体body参数
无

响应参数

表 returnObj

表 addresses

表 securityGroup

表 networkCard

表 image

表 flavor

表 addressList

枚举参数

无

请求示例

请求url

GET .../v4/ecs/lite/details?regionID=41f64827f25f468595ffa3a5deb5d15d&instanceID=7a9acf36-ed22-49e4-8ca2-a9ab6021e8a2

请求头header

无

请求体body

无

响应示例

{
    "returnObj": {
        "instanceStatus": "running",
        "secGroupList": [{
            "securityGroupID": "c6e1d96a-cff8-45c0-97db-91fca62b5f26",
            "securityGroupName": "VM-79ab13b6"
        }],
        "vpcID": "b1a5ff70-cdd1-4295-8a17-07b7e53c5759",
        "displayName": "LiteECS-cafd",
        "addresses": {
            "addressList": [{
                "version": 4,
                "type": "fixed",
                "addr": "172.31.1.8"
            }, {
                "version": 4,
                "type": "floating",
                "addr": "100.127.12.88"
            }]
        },
        "updatedTime": "2023-07-07T09:45:12Z",
        "instanceID": "7a9acf36-ed22-49e4-8ca2-a9ab6021e8a2",
        "resourceID": "ad2ba3d200e54e00850f7f7f9f35205c",
        "image": {
            "imageName": "CentOS7.6.v1-20020301",
            "imageID": "dca942b0-e934-4bd5-b5c1-4f5e1aad56a6"
        },
        "vpcName": "liteecs_network",
        "createdTime": "2023-07-03T06:47:04Z",
        "bandwidth": 10,
        "expiredTime": "2023-10-03T06:47:04Z",
        "bootDiskSize": 80,
        "zabbixName": "7a9acf36-ed22-49e4-8ca2-a9ab6021e8a2",
        "osType": 5,
        "attachedVolume": ["3163fc5e-70ed-4341-8d68-ffd3b3d48379"],
        "flavor": {
            "flavorCPU": 4,
            "flavorID": "6c76c383-586c-4302-aeff-2f891734e8e4",
            "flavorRAM": 8192,
            "flavorName": "lite1.band.xlarge.2"
        },
        "networkCardList": [{
            "subnetID": "f24f5695-6eaa-4ff9-b986-fb8f33a7fad4",
            "IPv4Address": "172.31.1.8",
            "IPv6Address": ""
        }],
        "instanceName": "VM-79ab13b6"
    },
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码