编组

新增机房

更新时间：2023-08-10 11:45:58

功能说明

添加主机机房信息。

调用说明

接口约束

调用者需要具备 HOST_MANAGER 权限。

请求路径

POST /api/v2/compute/idcs

请求参数

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

返回结果

参数	类型	说明
data	Object	请求的 IDC 信息
successful	Boolean	请求是否成功
timestamp	Datetime	服务端完成请求的时间戳
duration	Integer	服务端处理请求的时间（毫秒）
status	Integer	符合 HTTP Status 规范的编码
traceId	String	请求的 Trace Id，用于排查问题
server	String	响应请求的应用服务的地址

IDC 的数据结构

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

示例

请求示例

POST /api/v2/compute/idcs

curl --user <username>:<password> -X POST 'http://<IP>:<PORT>/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"
}