{"base_path":"/","components":null,"consumes":"","definitions":{"InstallAgentCredentialV3":{"description":"设备安装凭据。","properties":{"adminPwd":{"description":"管理员密码,使用WinRM协议时此字段必填。","type":"string"},"adminUser":{"description":"管理员账号,使用WinRM协议时此字段必填。","type":"string"},"ip":{"description":"连接到主机使用的IP地址,多IP用\";\"分割,优先使用mgmtIp。","type":"string"},"loginPwd":{"description":"登录密码,使用SSH2协议时此字段必填。","type":"string"},"loginUser":{"description":"登录账号,使用SSH2协议时此字段必填。","type":"string"},"port":{"description":"连接到主机使用的端口。","format":"int16","type":"integer"},"protocol":{"description":"安全协议。可取值为:\n* SSH2 (SSH连接协议)\n* CredSSP (WinRM连接协议)\n* Negotiate (WinRM连接协议)","type":"string"},"rootPwd":{"description":"root账户密码,使用SSH2协议时此字段必填。","type":"string"},"suCommand":{"description":"切root用户的命令,使用SSH2协议时此字段必填,可选值:\n* auto (自动配置)\n* su - root\n* sudo su - root","type":"string"}},"required":["protocol","ip","port"]},"InstallAgentRequestV3":{"description":"批量安装agent请求体V3。","properties":{"targets":{"description":"待安装agent的目标设备列表。","items":{"$ref":"#/definitions/InstallAgentTargetV3"},"maxItems":100,"type":"array"}},"required":["targets"]},"InstallAgentResponseV3":{"description":"批量安装agent返回体V3。","properties":{"targets":{"description":"安装agent的目标设备返回消息列表。","items":{"$ref":"#/definitions/RestResponseV3"},"maxItems":100,"type":"array"}},"required":["targets"]},"InstallAgentTargetV3":{"description":"待安装agent的目标设备","properties":{"credential":{"$ref":"#/definitions/InstallAgentCredentialV3","description":"登录主机使用的凭据。"},"id":{"description":"设备的resId。","maxLength":128,"type":"string"},"useSystemPython":{"description":"是否使用系统默认python。","type":"boolean"}},"required":["id","useSystemPython","credential"]},"RestResponseV3":{"description":"通用结果返回体V3。","properties":{"id":{"description":"id","maxLength":128,"type":"string"},"message":{"description":"失败的原因","maxLength":500,"type":"string"},"success":{"description":"是否成功","type":"boolean"}},"required":["id","success"]}},"description":null,"group_id":"a58bba086da947389167b8c3715f7155","host":"hcs.cn-north-4.myhuaweicloud.com","id":"9e8f19b742e24c21885adbfaffe3f71c","info_version":"v1","method":"post","name":"InstallAgentsV3","parameters":{},"paths":{"/rest/moautoops/v3/agents/installation":{"post":{"consumes":["application/json"],"description":"批量安装agentV3。\n|SLA项|定义|\n|-----|-----|\n|请求成功率| ≥99.9%|\n|可用性|Tier 1|\n|数据一致性|最终一致,不一致时长<1min|\n|吞吐量|60次/分钟|\n|TP50请求时延|500 ms|\n|TP99.9请求时延|1000 ms|","operationId":"InstallAgentsV3","parameters":[{"description":"批量安装agent请求体V3。","in":"body","name":"installAgentRequest","required":true,"schema":{"$ref":"#/definitions/InstallAgentRequestV3"}}],"produces":["application/json"],"responses":{"200":{"description":"安装agent响应。","examples":{"application/json":{"targets":[{"id":"1F661798DB8934DD98EFBDBD63000B25","message":"","success":true},{"id":"1F661798DB8934DD98EFBDBD63000B26","message":"","success":true},{"id":"1F661798DB8934DD98EFBDBD63000B27","message":"Connection refused. The winrm service is not available, or winrm is not available.","success":false}]}},"schema":{"$ref":"#/definitions/InstallAgentResponseV3"}},"206":{"description":"部分成功。"},"400":{"description":"参数错误。"},"401":{"description":"鉴权失败。"},"403":{"description":"URL鉴权失败。"},"404":{"description":"rest接口未找到。"},"424":{"description":"由于之前的某个请求发生的错误,导致当前请求失败。"},"500":{"description":"默认ServiceException异常码,应用内部错误。"},"502":{"description":"网关错误。"},"503":{"description":"服务不可用。"},"504":{"description":"表示时间超时,总线超时时间300s。"},"888":{"description":"服务摘机,不提供服务。"}},"summary":"批量安装agentV3","tags":["自动化运维"],"x-filter":"ManageOne,irservice,openapi","x-plane":"OM","x-precautions":"1.权限码:(自动作业-配置-安装Agent) moocapp:moautoops-agent:install; \n2.错误码:当请求不成功时,响应体内的错误码信息请参见“ManageOne 运维面API参考 > 错误码说明 > ManageOne运维面错误码说明 > 自动化运维”章节。\n","x-request-examples-1":{"targets":[{"credential":{"ip":"192.168.8.94","loginPwd":"******","loginUser":"admin","port":22,"protocol":"SSH2","rootPwd":"******","suCommand":"su - root"},"id":"1F661798DB8934DD98EFBDBD63000B25","useSystemPython":true},{"credential":{"adminPwd":"******","adminUser":"root","ip":"192.168.8.94","port":5985,"protocol":"CredSSP"},"id":"1F661798DB8934DD98EFBDBD63000B26","useSystemPython":true},{"credential":{"adminPwd":"******","adminUser":"root","ip":"192.168.8.94","port":5985,"protocol":"Negotiate"},"id":"1F661798DB8934DD98EFBDBD63000B27","useSystemPython":true}]},"x-request-examples-description-1":"","x-request-examples-url-1":"POST https://{endpoint}/rest/moautoops/v3/agents/installation","x-support-sdk":"N"}}},"product_short":"ManageOneOCHCS","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"批量安装agentV3","tags":"自动化运维","uri":null,"version":"2.0"}