新增机房信息 - 云平台 OCP V4.3.0

新增机房信息

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

编辑

功能说明

添加主机机房信息。

调用说明

接口约束

调用者需要具备 HOST_MANAGER 权限。

请求路径

POST /api/v2/compute/idcs

请求参数

body：

参数	类型	必选	示例值	描述
name	String	是	idc-bj	机房名称。
description	String	否	北京 idc	机房描述信息。
regionId	Long	是	100	区域 ID。

返回结果

基础数据结构

参数	类型	说明
data	Object	Idc 的数组，详情参见 Idc 数据结构。
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	机房修改时间。

示例

请求示例

POST /api/v2/compute/idcs -H 'Content-Type: application/json' --data-raw '{"name":"idc-bj","description":"北京机房","regionId":100}'

返回示例

{
  "data": {
    "createTime": "2021-07-22T20:04:15+08:00",
    "description": null,
    "id": 1000002,
    "name": "test-idc",
    "regionId": 1000002,
    "regionName": "testregion",
    "updateTime": "2021-07-22T20:04:15+08:00"
  },
  "duration": 41,
  "server": "a83ad33525",
  "status": 200,
  "successful": true,
  "timestamp": "2021-08-25T16:00:19.895+08:00",
  "traceId": "c8e610e3b33a4b17"
}