文档首页/ 部署 CodeArts Deploy/ API参考（联盟区域）/ API/ 环境管理/ 环境下导入主机
更新时间：2025-12-25 GMT+08:00
在线调试
CLI示例
分享

环境下导入主机

功能介绍

环境下导入主机。

调用方法

请参见如何调用API。

URI

POST /v1/applications/{application_id}/environments/{environment_id}/hosts/import

表1 路径参数

参数

是否必选

参数类型

描述

application_id

是

String

参数解释：

应用id。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

environment_id

是

String

参数解释：

环境id。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释：

消息体的类型（格式）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

用户Token。 通过调用IAM服务接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

字符串，长度不超过20000个字符。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

group_id

是

String

参数解释：

主机集群id。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

host_ids

是

Array of strings

参数解释：

要导入的主机id列表。

约束限制：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

status

String

参数解释：

请求成功、失败状态。

取值范围：

  • success：请求成功。

  • failed：请求失败。

result

Array of strings

参数解释：

被导入的主机id列表。

请求示例

https://{endpoint}/v1/applications/43943381f7764c52baae8e697720873f/environments/666ec038a53c4b9f899823747a7130e8/hosts/import

{
  "group_id" : "4b0cb2f098174d38b0c15645c13eae6f",
  "host_ids" : [ "8e1eb7f010d4442ca150e3a1a5d96d94" ]
}

响应示例

状态码：200

OK 请求响应成功

{
  "status" : "success",
  "result" : [ "8e1eb7f010d4442ca150e3a1a5d96d94" ]
}

状态码

状态码

描述

200

OK 请求响应成功

错误码

请参见错误码。

父主题： 环境管理