查询机房详情 - 云平台 OCP V4.3.0

查询机房详情

更新时间：2026-04-14 11:55:54

编辑

功能说明

根据机房 ID 查询主机机房信息。

调用说明

接口约束

调用者需要具备 HOST_VIEWER 权限。

请求路径

GET /api/v2/compute/idcs/{idcId}

请求参数

path：

参数	类型	必选	示例值	描述
idcId	Integer	是	100	主机机房 ID。

返回结果

基础数据结构

参数	类型	说明
data	Object	请求的数据。
├─ contents	Array	Idc 的数组，详情参见 Idc 数据结构。
├─ page	Object	分页信息，详情参见 page 数据结构。
successful	Boolean	请求是否成功。
timestamp	Datetime	服务端完成请求的时间戳。
duration	Integer	服务端处理请求的时间（毫秒）。
status	Integer	符合 HTTP Status 规范的编码。
traceId	String	请求的 Trace ID，用于排查问题。
server	String	响应请求的应用服务的地址。

Idc 数据结构

参数	类型	说明
id	Long	机房 ID。
name	String	机房名称。
description	String	机房描述信息。
regionId	Long	机房关联的地域 ID。
regionName	String	机房关联的地域名称。
createTime	String	机房创建时间。
updateTime	String	机房修改时间。

page 数据结构

参数	类型	说明
totalElements	Integer	总记录数。
totalPages	Integer	总页数。
number	Integer	当前页码。
size	Integer	当前页大小。

示例

请求示例

GET /api/v2/compute/idcs/100

返回示例

{
  "data": {
    "contents": [
      {
        "createTime": "2021-12-31T18:01:44+08:00",
        "description": null,
        "id": 1,
        "name": "changsha",
        "regionId": 1,
        "regionName": "OCP_META_REGION",
        "updateTime": "2021-12-31T18:01:44+08:00"
      }
    ],
    "page": {
      "number": 1,
      "size": 1,
      "totalElements": 2,
      "totalPages": 2
    }
  },
  "duration": 12,
  "server": "b3b6d90167",
  "status": 200,
  "successful": true,
  "timestamp": "2022-04-27T10:23:11.903+08:00",
  "traceId": "33f871031b924b40"
}