华为云用户手册

请求示例 https://{endpoint}/v2/89931e210b214b5892ea833712f0f5e0/tasks/metrics/success-rate{ "start_date" : "2022-01-01", "end_date" : "2022-10-26", "task_ids" : [ "5bf0a54f36b04ddda7b94470fee39307", "b6d20b703ffe4a04bc68790ddabf6ab7" ]}

响应示例 状态码： 200 OK 请求响应成功 { "project_id" : "89931e210b214b5892ea833712f0f5e0", "project_name" : "Happy", "start_date" : "2022-01-01", "end_date" : "2022-10-26", "tasks_success_rate" : [ { "task_id" : "5bf0a54f36b04ddda7b94470fee39307", "task_name" : "happy482URL健康测试", "success_rate" : "0", "record_count" : 8, "success_record_count" : 0 }, { "task_id" : "b6d20b703ffe4a04bc68790ddabf6ab7", "task_name" : "happy486启动停止Tomcat", "success_rate" : "14.29", "record_count" : 14, "success_record_count" : 2 } ]}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 project_id String 项目id，获取方式请参见获取项目id。 project_name String 项目名称 start_date String 部署应用开始时间范围的左边界（包含），格式yyyy-MM-dd end_date String 部署应用开始时间范围的右边界（包含），格式yyyy-MM-dd。最大时间范围为1年。 tasks_success_rate Array of TaskSuccessRate objects 应用的成功率列表 表4 TaskSuccessRate 参数 参数类型 描述 task_id String 任务id task_name String 应用名称 success_rate String 成功率 record_count Integer 部署记录数 success_record_count Integer 成功的部署记录数

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 主机数量 group_name String 主机集群名称 hosts Array of DeploymentHostDetail objects 主机列表信息 表5 DeploymentHostDetail 参数 参数类型 描述 group_id String 主机集群id host_name String 主机名称 ip String IPv4/IPv6格式的IP地址 port Integer ssh端口，如：22 os String 操作系统：windows|linux，需要和主机集群保持一致 as_proxy Boolean 是否为代理机 proxy_host_id String 代理机id authorization DeploymentHostAuthorizationBody object 登录主机鉴权，使用密码登录则填写密码即可，使用密钥则填写密钥，二选一即可。 install_icagent Boolean 免费启用应用运维服务（ AOM ），提供指标监控、日志查询、告警功能（自动安装数据采集器 ICAgent，仅支持华为云linux主机） host_id String 主机id proxy_host DeploymentHostDetail object 代理机信息详情 group_name String 主机集群名 project_id String 项目id，获取方式请参见获取项目id。 project_name String 项目名称 permission PermissionHostDetail object 主机相关权限详情类 update_time String 更新时间 lastest_connection_time String 最后连接时间 connection_status String 连接状态 owner_name String 拥有者名称 updator_id String 维护者id create_time String 创建时间 nick_name String 昵称 owner_id String 拥有者id updator_name String 维护者名称 connection_result String 连接结果 表6 DeploymentHostAuthorizationBody 参数 参数类型 描述 username String 用户名，可输入中英文，数字和符号(-_.)。 password String 密码，认证类型为0时，密码必填。 private_key String 密钥，认证类型为1时，密钥必填 trusted_type Integer 认证类型，0表示使用密码认证，1表示使用密钥认证 表7 PermissionHostDetail 参数 参数类型 描述 can_view Boolean 是否有查看权限 can_edit Boolean 是否有编辑权限 can_delete Boolean 是否有删除权限 can_add_host Boolean 是否有添加主机权限 can_connection_test Boolean 是否有测试主机连通性权限

响应示例 状态码： 200 OK 请求响应成功 { "hosts" : [ { "host_name" : "100.101.28.203", "ip" : "100.101.28.203", "port" : 22, "os" : "linux", "authorization" : { "username" : "root", "password" : null, "private_key" : null, "trusted_type" : 0 }, "permission" : { "can_view" : true, "can_edit" : true, "can_delete" : true, "can_add_host" : true, "can_connection_test" : true }, "host_id" : "2cc913cc9a494f09b7320801ebacad02", "group_id" : "ab7647b0863c4e969c8949d38d591339", "as_proxy" : false, "proxy_host_id" : null, "owner_id" : "6baa7454109d47c192f22078fe6cda20", "owner_name" : "devcloud_devcloud_l00490255_01", "updator_id" : "6baa7454109d47c192f22078fe6cda20", "updator_name" : "devcloud_devcloud_l00490255_01", "connection_status" : "success", "install_icagent" : false, "create_time" : "2021-04-15 11:01:51", "update_time" : "2021-04-21 15:04:24", "connection_result" : "连接成功", "lastest_connection_time" : "2021-04-15 11:02:00", "nick_name" : "AB边账号", "proxy_host" : null, "group_name" : null, "project_id" : "6039d4480efc4dddb178abff98719913", "project_name" : null } ], "total" : 1, "group_name" : "test"}

URI GET /v2/host-groups/{group_id}/hosts 表1 路径参数 参数 是否必选 参数类型 描述 group_id 是 String 主机集群id 表2 Query参数 参数 是否必选 参数类型 描述 as_proxy 否 Boolean 是否为代理机 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0 limit 否 Integer 每页显示的条目数量，默认为1000 name 否 String 主机名，可输入中英文，数字和符号(-_.) sort_key 否 String 排序字段，支持：AS_PROXY|HOST_NAME|OS|OWNER_NAME|as_proxy|host_name|os|owner_name|nickName。不填默认为：as_proxy sort_dir 否 String 排序方式,默认为：DESC。DESC：降序排序。ASC：升序排序 with_auth 否 Boolean 返回结果是否加密

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total Integer 主机集群个数 host_groups Array of DeploymentGroupDetail objects 主机集群详情响应体 表4 DeploymentGroupDetail 参数 参数类型 描述 group_id String 主机集群id created_time String 创建时间 updated_time String 修改时间 host_count Integer 集群内主机数量，一个主机集群内最多可添加200台主机 project_name String 项目名称 name String 主机集群名 region_name String 局点信息 project_id String 项目id，获取方式请参见获取项目id。 os String 操作系统：windows|linux auto_connection_test_switch Integer 自动测试功能已下架，该字段已失效 slave_cluster_id String slave集群id，默认为null时使用默认slave集群，用户自定义slave时为slave集群id nick_name String 用户昵称 created_by UserInfo object 参数解释： 用户信息，包含用户id、用户名等。 约束限制： 不涉及。 updated_by UserInfo object 参数解释： 用户信息，包含用户id、用户名等。 约束限制： 不涉及。 description String 描述 permission PermissionGroupDetail object 主机集群相关权限详情类 表5 UserInfo 参数 参数类型 描述 user_id String 参数解释： 用户id。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 user_name String 参数解释： 用户名。 取值范围： 只能由英文字母、数字组成，且长度为[1-255]个字符。 表6 PermissionGroupDetail 参数 参数类型 描述 can_view Boolean 是否有查看权限 can_edit Boolean 是否有编辑权限 can_delete Boolean 是否有删除权限 can_add_host Boolean 是否有添加主机权限 can_manage Boolean 是否有编辑主机集群权限矩阵的权限

响应示例 状态码： 200 OK 请求响应成功 { "total" : 1, "host_groups" : [ { "name" : "testwyk", "description" : "11122211", "os" : "linux", "nick_name" : "AB边账号", "group_id" : "ab7647b0863c4e969c8949d38d591339", "region_name" : "cn-north-7", "project_id" : "6039d4480efc4dddb178abff98719913", "permission" : { "can_view" : true, "can_edit" : true, "can_delete" : true, "can_add_host" : true, "can_manage" : true }, "created_by" : { "user_id" : "6baa7454109d47c192f22078fe6cda20", "user_name" : "devcloud_devcloud_l00490255_01" }, "updated_by" : { "user_id" : "6baa7454109d47c192f22078fe6cda20", "user_name" : "devcloud_devcloud_l00490255_01" }, "auto_connection_test_switch" : 0, "slave_cluster_id" : "", "created_time" : "2021-04-01 17:05:53", "updated_time" : "2021-04-21 14:29:14", "host_count" : 1, "project_name" : null } ]}

URI GET /v2/host-groups 表1 Query参数 参数 是否必选 参数类型 描述 project_id 否 String 项目id，获取方式请参见获取项目id。 region_name 是 String 局点信息 os 否 String 操作系统：windows|linux offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0 limit 否 Integer 每页显示的条目数量，默认为1000 name 否 String 主机集群名 sort_key 否 String 排序字段：nickName|NAME|OWNER_NAME|CREATE_TIME|name|owner_name|create_time，不传使用默认排序 sort_dir 否 String 排序方式：DESC、ASC，默认为DESC

响应示例 状态码： 200 OK 请求响应成功 { "task_id" : "d2dc947ec2424d8789bb3984bb3adf45", "name" : "wyktest111", "state" : "Available", "description" : "111222", "owner" : "devcloud_devcloud_l00490255_01", "steps" : { "step1" : { "id" : "1583", "name" : "选择部署来源", "params" : { }, "enable" : true }, "step2" : { "id" : "1293", "name" : "URL健康测试", "params" : { }, "enable" : true } }, "project_id" : "6039d4480efc4dddb178abff98719913", "project_name" : "wyk_test", "deploy_system" : "deployTemplate", "create_time" : "2021-04-01 17:07:49", "update_time" : "2021-05-17 11:26:58", "role_id" : 0, "is_defaut_permission" : false, "template_id" : "242ea879b3444b8391c3feb2e9c073de", "nick_name" : "AB边账号", "owner_id" : "6baa7454109d47c192f22078fe6cda20", "tenant_id" : "26a680dd72e7482eb60d2ef5513588bb", "tenant_name" : "devcloud_devcloud_l00490255_01", "slave_cluster_id" : "", "is_care" : false, "can_modify" : true, "can_delete" : true, "can_view" : true, "can_execute" : true, "can_copy" : true, "can_manage" : true, "can_disable" : false, "app_component_list" : [ ], "is_disable" : true}

响应示例 状态码： 200 OK 请求响应成功 { "name" : "test", "description" : "11122211", "os" : "linux", "region_name" : "cn-north-7", "project_id" : "6039d4480efc4dddb178abff98719913", "created_by" : { "user_id" : "6baa7454109d47c192f22078fe6cda20", "user_name" : "devcloud_devcloud_l00490255_01" }, "updated_by" : { "user_id" : "6baa7454109d47c192f22078fe6cda20", "user_name" : "devcloud_devcloud_l00490255_01" }, "permission" : { "can_view" : true, "can_edit" : true, "can_delete" : true, "can_add_host" : true, "can_manage" : true }, "auto_connection_test_switch" : 0, "slave_cluster_id" : "", "nick_name" : "AB边账号", "group_id" : "ab7647b0863c4e969c8949d38d591339", "created_time" : "2021-04-01 17:05:53", "updated_time" : "2021-04-21 14:29:14", "host_count" : 1}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 group_id String 主机集群id created_time String 创建时间 updated_time String 修改时间 host_count Integer 集群内主机数量，一个主机集群内最多可添加200台主机 project_name String 项目名称 name String 主机集群名 region_name String 局点信息 project_id String 项目id，获取方式请参见获取项目id。 os String 操作系统：windows|linux auto_connection_test_switch Integer 自动测试功能已下架，该字段已失效 slave_cluster_id String slave集群id，默认为null时使用默认slave集群，用户自定义slave时为slave集群id nick_name String 用户昵称 created_by UserInfo object 参数解释： 用户信息，包含用户id、用户名等。 约束限制： 不涉及。 updated_by UserInfo object 参数解释： 用户信息，包含用户id、用户名等。 约束限制： 不涉及。 description String 描述 permission PermissionGroupDetail object 主机集群相关权限详情类 表4 UserInfo 参数 参数类型 描述 user_id String 参数解释： 用户id。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 user_name String 参数解释： 用户名。 取值范围： 只能由英文字母、数字组成，且长度为[1-255]个字符。 表5 PermissionGroupDetail 参数 参数类型 描述 can_view Boolean 是否有查看权限 can_edit Boolean 是否有编辑权限 can_delete Boolean 是否有删除权限 can_add_host Boolean 是否有添加主机权限 can_manage Boolean 是否有编辑主机集群权限矩阵的权限

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 请求成功失败状态 result EnvironmentDetail object 环境详情 表4 EnvironmentDetail 参数 参数类型 描述 id String 环境id name String 环境名称 description String 环境描述 os String 操作系统 nick_name String 用户昵称 deploy_type Integer 部署类型：0表示主机, 1表示kubernetes created_time String 创建时间 instance_count Integer 环境下主机实例数量 created_by UserInfo object 参数解释： 用户信息，包含用户id、用户名等。 约束限制： 不涉及。 permission EnvironmentPermissionDetail object 环境权限详情 表5 UserInfo 参数 参数类型 描述 user_id String 参数解释： 用户id。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 user_name String 参数解释： 用户名。 取值范围： 只能由英文字母、数字组成，且长度为[1-255]个字符。 表6 EnvironmentPermissionDetail 参数 参数类型 描述 can_delete Boolean 是否有删除环境权限 can_deploy Boolean 是否有部署权限 can_edit Boolean 是否有编辑环境权限 can_manage Boolean 是否有编辑环境权限矩阵的权限 can_view Boolean 是否有环境的查看权限

响应示例 状态码： 200 OK 请求响应成功 { "status" : "success", "result" : { "created_by" : { "user_id" : "6baa7454109d47c192f22078fe6cda20", "user_name" : "devcloud_devcloud_l00490255_01" }, "created_time" : "2023-06-20 16:53:29.0", "deploy_type" : 0, "description" : "", "id" : "a0a2274acc4f482bb2ecf49f865879fa", "name" : "casdasd", "nick_name" : "AB边账号", "os" : "linux", "permission" : { "can_delete" : true, "can_deploy" : true, "can_edit" : true, "can_manage" : true, "can_view" : true } }}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 [数组元素] Array of ConfigInfo objects 查询部署记录执行参数返回体 表5 ConfigInfo 参数 参数类型 描述 name String 参数解释： 参数名。 取值范围： 不涉及。 type String 参数解释： 参数类型。 取值范围： 不涉及。 value String 参数解释： 参数值。 取值范围： 不涉及。

URI GET /v2/history/tasks/{task_id}/params 表1 路径参数 参数 是否必选 参数类型 描述 task_id 是 String 参数解释： 部署任务id。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 record_id 否 String 参数解释： 执行记录id。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 region String 局点信息 role_id String 角色id devuc_role_id_list Array of strings 角色id列表 name String 角色名称 group_id String 主机集群id can_view Boolean 是否有查看权限 can_edit Boolean 是否有编辑权限 can_delete Boolean 是否有删除权限 can_add_host Boolean 是否有添加主机权限 can_manage Boolean 是否有权限管理权限 can_copy Boolean 是否有拷贝权限 create_time String 创建时间 update_time String 修改时间 role_type String 角色类型，project-customized：自定义角色；template-project-customized：系统自定义角色；template-customized-inst：系统角色；cluster-creator：集群创建者；project_admin 项目创建者

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式） X-Auth-Token 是 String 用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 表3 请求Body参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id role_id 是 String 角色id permission_name 是 String 权限名称，can_view：查看权限；can_edit：编辑权限；can_delete：删除权限；can_add_host：添加主机权限；can_manage：权限管理权限；can_copy：复制主机权限 permission_value 是 Boolean true 有权限，false 无权限

请求示例 https://{endpoint}/v2/host-groups/2a8c2da888c04a5eaff10d0787c90ea4/permissions{ "permission_name" : "can_delete", "permission_value" : true, "project_id" : "7e6caf3cd9a64d5b8ea451e38221892e", "role_id" : "c869ebc4000c4bb9a2605c4020450ab4"}

响应示例 状态码： 200 OK 请求响应成功 { "region" : "region", "name" : null, "role_id" : "0", "devuc_role_id_list" : null, "group_id" : "2a8c2da888c04a5eaff10d0787c90ea4", "can_view" : true, "can_edit" : true, "can_delete" : true, "can_add_host" : true, "can_manage" : true, "can_copy" : true, "create_time" : null, "update_time" : null, "role_type" : "cluster-creator"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式） X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 主机集群名 description 否 String 描述 slave_cluster_id 否 String 自定义slave资源池id auto_connection_test_switch 否 Integer 自动测试功能已下架，该字段已失效

请求示例 修改目标主机集群基本信息，信息包含主机集群名称、描述等。 https://{endpoint}/v2/host-groups/f3938bd63e354d2bb9d9cf7b5dc3bf95{ "name" : "test123", "description" : "这是一条描述信息", "slave_cluster_id" : "", "auto_connection_test_switch" : 0}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 参数解释： 请求成功、失败状态。 取值范围： success：请求成功。 failed：请求失败。 result HostClusterInfoDetailDetail object 参数解释： 主机集群信息。 取值范围： 不涉及。 表4 HostClusterInfoDetailDetail 参数 参数类型 描述 id String 参数解释： 主机集群id。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 name String 参数解释： 主机集群名称。 取值范围： 只能由中文字符、英文字母、数字及"-"、"_"、"."组成，且长度为[3-128]个字符。 os String 参数解释： 主机集群的操作系统类型。 取值范围： windows：windows操作系统类型。 linux：linux操作系统类型。 slave_cluster_id String 参数解释： 自托管资源池id。 取值范围： 只能由英文字母、数字组成，且长度为[1-32]个字符。 created_by UserInfo object 参数解释： 用户信息，包含用户id、用户名等。 约束限制： 不涉及。 description String 参数解释： 主机集群描述信息。 取值范围： 字符串，长度为[0-500]个字符。 permission PermissionClusterDetail object 参数解释： 主机集群权限信息。 约束限制： 不涉及。 nick_name String 参数解释： 用户昵称。 取值范围： 字符串，长度为[1-30]个字符。 is_proxy_mode Integer 参数解释： 是否为代理模式主机集群。 取值范围： 0：非代理模式主机集群。 1：代理模式主机集群。 created_time String 参数解释： 主机集群创建时间，格式为yyyy-MM-dd HH:mm:ss。例如：'2021-04-01 17:05:53'。 取值范围： 不涉及。 updated_time String 参数解释： 主机集群更新时间，格式为yyyy-MM-dd HH:mm:ss。例如：'2021-04-01 17:05:53'。 取值范围： 不涉及。 表5 UserInfo 参数 参数类型 描述 user_id String 参数解释： 用户id。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 user_name String 参数解释： 用户名。 取值范围： 只能由英文字母、数字组成，且长度为[1-255]个字符。 表6 PermissionClusterDetail 参数 参数类型 描述 can_view Boolean 参数解释： 是否有查看权限。 取值范围： true：有查看权限。 false：无查看权限。 can_edit Boolean 参数解释： 是否有编辑权限。 取值范围： true：有编辑权限。 false：无编辑权限。 can_delete Boolean 参数解释： 是否有删除权限。 取值范围： true：有删除权限。 false：无删除权限。 can_add_host Boolean 参数解释： 是否有添加主机权限。 取值范围： true：有添加主机权限。 false：无添加主机权限。 can_manage Boolean 参数解释： 是否有管理主机集群权限矩阵的权限。 取值范围： true：有管理主机集群权限矩阵的权限。 false：无管理主机集群权限矩阵的权限。 can_copy Boolean 参数解释： 是否有复制主机的权限。 取值范围： true：有复制主机的权限。 false：无复制主机的权限。

响应示例 状态码： 200 OK 请求响应成功 { "status" : "success", "result" : { "id" : "ab7647b0863c4e969c8949d38d591339", "name" : "test", "description" : "11122211", "os" : "linux", "created_by" : { "user_id" : "6baa7454109d47c192f22078fe6cda20", "user_name" : "devcloud_devcloud_l00490255_01" }, "permission" : { "can_view" : true, "can_edit" : true, "can_delete" : true, "can_add_host" : true, "can_manage" : true, "can_copy" : true }, "is_proxy_mode" : 0, "slave_cluster_id" : "", "nick_name" : "AB边账号", "created_time" : "2021-04-01 17:05:53", "updated_time" : "2021-04-21 14:29:14" }}

请求示例 修改目标主机基本信息，信息包含主机名称、IP地址、端口等。 https://{endpoint}/v2/host-groups/ab7647b0863c4e969c8949d38d591339/hosts/300d6d2e53624d0da08b182099ad10f7{ "host_name" : "100.101.28.215", "ip" : "100.101.28.215", "port" : 22, "as_proxy" : false, "proxy_host_id" : null, "authorization" : { "username" : "root", "password" : null, "private_key" : "", "trusted_type" : 0 }, "install_icagent" : false, "sync" : true}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式） X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 表3 请求Body参数 参数 是否必选 参数类型 描述 host_name 是 String 主机名称 ip 是 String IPv4/IPv6格式的IP地址 port 是 Integer ssh端口，如：22 as_proxy 是 Boolean 是否为代理机 proxy_host_id 否 String 代理机id authorization 是 DeploymentHostAuthorizationBody object 登录主机鉴权，使用密码登录则填写密码即可，使用密钥则填写密钥，二选一即可。 install_icagent 否 Boolean 免费启用应用运维服务（AOM），提供指标监控、日志查询、告警功能（自动安装数据采集器 ICAgent，仅支持华为云linux主机） sync 否 Boolean 是否将当前主机的密码信息同步到同一项目下其他主机集群中具有相同IP、用户名、端口的主机。 表4 DeploymentHostAuthorizationBody 参数 是否必选 参数类型 描述 username 是 String 用户名，可输入中英文，数字和符号(-_.)。 password 否 String 密码，认证类型为0时，密码必填。 private_key 否 String 密钥，认证类型为1时，密钥必填 trusted_type 是 Integer 认证类型，0表示使用密码认证，1表示使用密钥认证

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 表2 请求Body参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id permission_level 是 String 应用鉴权级别，instance：实例级；project：项目级 application_ids 是 Array of strings 应用id列表

请求示例 https://{endpoint}/v3/applications/permission-level{ "application_ids" : [ "eac65c10c5c34df1824af96ec93a9eea", "3ba2ad194ff141e39b1d3d0749242858" ], "project_id" : "0a38ce9ba3c740c199a0f872b6163661", "permission_level" : "instance"}

请求示例 https://{endpoint}/v1/resources/host-groups/6bec5f67ab9b4c34a21c7ffe0b0191c8/hosts/a94facdc4b1e40d799dbe6de91167072{ "as_proxy" : false, "host_name" : "hostName", "install_icagent" : true, "ip" : "100.101.28.215", "port" : 22, "proxy_host_id" : "", "authorization" : { "username" : "root", "password" : "*****", "private_key" : "", "trusted_type" : 0 }}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式） X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 表3 请求Body参数 参数 是否必选 参数类型 描述 as_proxy 否 Boolean 是否为代理主机 authorization 否 DeploymentHostAuthorizationBody object 登录主机鉴权，使用密码登录则填写密码即可，使用密钥则填写密钥，二选一即可。 host_name 是 String 主机名称 ip 是 String IPv4/IPv6格式的IP地址 port 是 Integer ssh端口，如：22 proxy_host_id 否 String 代理主机id sync 否 Boolean 是否同步主机信息 install_icagent 否 Boolean 是否安装icAgent 表4 DeploymentHostAuthorizationBody 参数 是否必选 参数类型 描述 username 是 String 用户名，可输入中英文，数字和符号(-_.)。 password 否 String 密码，认证类型为0时，密码必填。 private_key 否 String 密钥，认证类型为1时，密钥必填 trusted_type 是 Integer 认证类型，0表示使用密码认证，1表示使用密钥认证