新增区域信息 - 云平台 OCP V4.3.0

新增区域信息

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

编辑

功能说明

添加主机区域信息。

调用说明

接口约束

调用者需要具备 HOST_MANAGER 权限。

请求路径

POST /api/v2/compute/regions

请求参数

body：

参数	类型	必选	示例值	描述
name	String	是	Beijing	区域名称。
description	String	否	北京地区	区域描述信息。

返回结果

基础数据结构

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

Region 数据结构

参数	类型	说明
id	Integer	区域 ID。
name	String	区域名称。
description	String	区域描述信息。
createTime	String	区域信息创建时间。
updateTime	String	区域信息修改时间。

示例

请求示例

POST /api/v2/compute/regions' -H 'Content-Type: application/json' --data-raw '{"name":"shanghai","description":"上海"}'

返回示例

{
    "data": {
        "createTime": null,
        "description": "region1 description",
        "id": 2000002,
        "idcs": null,
        "name": "region1",
        "updateTime": null
    },
    "duration": 67,
    "server": "b3b6d90167",
    "status": 200,
    "successful": true,
    "timestamp": "2022-04-25T14:02:51.31+08:00",
    "traceId": "9032ce344d5e60a0"
}