human: 如何处理七牛云的专有云计算查询主机详情

gpt: [专有云计算](https://developer.qiniu.com/qec) > API 文档 >
[云主机](https://developer.qiniu.com/qec/api/10639/compute) >
[主机管理](https://developer.qiniu.com/qec/api/10686/the-server) > 查询主机详情

#  查询主机详情

最近更新时间: 2022-05-31 22:46:36

# 请求路径

> `GET` /api/rio/v1/compute/server/:id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
x-rio-zone-id | string | header | 是 | 区域 ID  
id | string | path | 是 | 主机 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | ServerInfo | 主机信息  
  
## ServerInfo 主机信息

名称 | 类型 | 描述  
---|---|---  
server_id | string | 主机 ID  
server_name | string | 主机名  
description | string | 主机描述  
zone_id | string | 区域 ID  
status | string | 主机状态 

  * `Creating` 创建中 
  * `Changing` 修改配置中
  * `Running` 运行中 
  * `Starting` 开机中 
  * `Stopping` 关机中 
  * `Stopped` 已关机 
  * `Inactive` 非激活的 
  * `Rebooting` 重启中 
  * `Pending` 准备中 
  * `Deleted` 已删除 
  * `Deleting` 删除中 
  * `Unknown` 未知状态 

  
hostname | string | 网络主机域名  
tags | []TagInfo | 标签  
image | ServerImageInfo | 主机镜像信息  
flavor | ServerFlavorInfo | 主机规格信息  
vpc | []ServerVPCInfo | 主机网络信息  
disks | []ServerDiskInfo | 主机磁盘信息  
security_groups | []ServerSecurityGroupInfo | 主机安全组绑定信息  
key_pair_name | string | 主机密钥对名称  
expired_at | int64 | 主机过期时间  
created_at | int64 | 主机创建时间  
  
### TagInfo 标签参数

名称 | 类型 | 描述  
---|---|---  
key | string | 键名称  
value | string | 值  
  
### ServerImageInfo 主机镜像信息

名称 | 类型 | 描述  
---|---|---  
image_id | string | 镜像 ID  
image_name | string | 名称  
os_type | string | 操作系统类型：

  * `linux`
  * `windows`

  
os_name | string | 系统名称  
  
#### ServerFlavorInfo 主机规格信息

名称 | 类型 | 描述  
---|---|---  
flavor_id | string | 主机规格 ID  
flavor_name | string | 主机规格名称  
cpu | int64 | 主机 CPU 核数  
memory | int64 | 主机内存大小 单位 MB  
gpu_spec | string | 实例规格附带的 GPU 类型。  
gpu_amount | int64 | 实例规格附带的 GPU 数量。  
  
### ServerVPCInfo 专有网络信息

名称 | 类型 | 描述  
---|---|---  
private_ip_address | string | 专有网络 IP 地址  
vpc_id | string | 专有网络 ID  
vpc_name | string | 专有网络名称  
v_switch_id | string | 交换机 ID  
v_switch_name | string | 交换机名称  
eip_info | ServerEIPInfo | EIP 信息  
  
#### ServerEIPInfo 信息

名称 | 类型 | 描述  
---|---|---  
eip_id | string | EIP ID  
eip_name | string | 名称  
ip_address | string | IP 地址  
bandwidth | integer | 带宽，单位：Mbps  
  
### ServerDiskInfo 主机磁盘信息

名称 | 类型 | 描述  
---|---|---  
id | string | 磁盘 ID  
size | int | 磁盘大小单位 GB  
is_boot | bool | 是否是系统盘  
  
### ServerSecurityGroupInfo 主机安全组信息

名称 | 类型 | 描述  
---|---|---  
security_group_id | string | 安全组 ID  
security_group_name | string | 安全组名称  
  
## 请求示例

> `GET` api/rio/v1/compute/server/d183cbf6-0871-4c00-a0f4-90c901f832b7

##返回值示例

    
    
    {
      "request_id": "TqeOOUuW9riTKs0W",
      "data": {
        "server_id": "d183cbf6-0871-4c00-a0f4-90c901f832b7",
        "server_name": "S-h1IMC",
        "description": "",
        "zone_id": "xiasha",
        "status": "Running",
        "hostname": "s-h1imc",
        "tags": [],
        "image": {
          "image_id": "812e3500-7591-48b7-8dbc-7706ff83e674",
          "image_name": "CentOS",
          "os_type": "linux",
          "os_name": "CentOS7-64"
        },
        "flavor": {
          "flavor_id": "00c90f83-b633-4c7f-9c77-344e85295af1",
          "flavor_name": "1C1G",
          "cpu": 1,
          "memory": 1024
        },
        "vpc": [
          {
            "private_ip_address": "192.168.100.5",
            "vpc_id": "c393b0e8-02be-462c-b531-b30a8c401abf",
            "vpc_name": "test",
            "v_switch_id": "19863173-462c-4040-84d7-7a0c22a8e8d9",
            "v_switch_name": "test_network"
          }
        ],
        "disks": [
          {
            "id": "8662b907-5810-44e7-9efd-bcccc5cac8eb",
            "size": 40,
            "is_boot": true
          }
        ],
        "security_groups": [
          {
            "security_group_id": "31a57ec0-d9e6-4219-815d-9ace570d30a9",
            "security_group_name": "default"
          }
        ],
        "key_pair_name": "",
        "expired_at": 0,
        "created_at": 1643016019000
      }
    }
    

以上内容是否对您有帮助？