更新时间：2025-12-25 GMT+08:00
环境下导入主机
功能介绍
环境下导入主机。
调用方法
请参见如何调用API。
URI
POST /v1/applications/{application_id}/environments/{environment_id}/hosts/import
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| application_id | 是 | String | 参数解释： 应用id。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 |
| environment_id | 是 | String | 参数解释： 环境id。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 参数解释： 消息体的类型（格式）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
| X-Auth-Token | 是 | String | 参数解释： 用户Token。 通过调用IAM服务接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 不涉及。 取值范围： 字符串，长度不超过20000个字符。 默认取值： 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| group_id | 是 | String | 参数解释： 主机集群id。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 |
| host_ids | 是 | Array of strings | 参数解释： 要导入的主机id列表。 约束限制： 不涉及。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| status | String | 参数解释： 请求成功、失败状态。 取值范围：
|
| 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 请求响应成功 |
错误码
请参见错误码。
父主题： 环境管理
