使用 ECS 自带的云助手安装 EDAS Agent(将 ECS 导入 EDAS)。
使用该接口将 ECS 导入 EDAS 时,不会重装系统,推荐使用该接口将 ECS 导入 EDAS
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
请求语法
POST /pop/v5/ecss/install_agent HTTPS|HTTP
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
ClusterId | String | 是 | b3e3f77b-462e-****-****-bec8727a4dc8 |
集群 ID |
InstanceIds | String | 是 | 2ze7s2v0b789k60pk1af |
实例 ID,如instanceId1,instanceId2 |
DoAsync | Boolean | 否 | true |
已不再使用 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | Integer | 200 |
Code 码 |
ExecutionResultList | Array |
执行结果 |
|
ExecutionResult | |||
FinishedTime | String | 2019-11-10T07:02:17Z |
安装结束时间 |
InstanceId | String | i-2ze7s2v0b789k60pk1af |
实例 ID |
InvokeRecordStatus | String | Finished |
安装状态 |
Status | String | OK |
命令执行状态信息 |
Success | Boolean | true |
是否安装成功 |
Message | String | success |
信息 |
RequestId | String | b197-40ab-9155-7ca7 |
唯一请求ID |
示例
请求示例
POST /pop/v5/ecss/install_agent HTTP/1.1
公共请求头
{
"ClusterId": "b3e3f77b-462e-****-****-bec8727a4dc8"
"InstanceIds": "2ze7s2v0b789k60pk1af"
}
正常返回示例
XML
格式
<ExecutionResultList>
<ExecutionResult>
<InvokeRecordStatus>Finished</InvokeRecordStatus>
<Status>OK</Status>
<FinishedTime>2019-11-10T07:02:17Z</FinishedTime>
<InstanceId>i-2ze7s2v0b789k60pk1af</InstanceId>
<Success>true</Success>
</ExecutionResult>
</ExecutionResultList>
<Message>success</Message>
<Code>200</Code>
JSON
格式
{
"ExecutionResultList": {
"ExecutionResult": [
{
"InvokeRecordStatus": "Finished",
"Status": "OK",
"FinishedTime": "2019-11-10T07:02:17Z",
"InstanceId": "i-2ze7s2v0b789k60pk1af",
"Success": true
}
]
},
"Message": "success",
"Code": 200
}
错误码
访问错误中心查看更多错误码。
注意事项
该接口在实际执行中,会遇到在 API 接口 Client 程序端在连接 API 网关超时(默认 10 秒)的情况,所以,用户在使用该接口时,须手工设置调用该接口时读取 POP API 网关返回的数据的超时时间(推荐设置为 30 秒,因 POP API 网关到接口 Server 端的服务处理时间最长即为 30 秒):
- 使用 Java SDK 时,Client 端代码中使用该接口时设置读取超时时间方法:
java InstallAgentRequest request = new InstallAgentRequest(); request.setSysReadTimeout(30000); //单位毫秒,客户端 API 接口程序等待 POP API网关返回数据的超时时间. request.setClusterId(clusterId); ........
- 使用 Python SDK 时,Client 端代码中使用该接口时设置读取超时时间方法:
python request = InstallAgentRequest() request.set_read_timeout(30000) request.set_ClusterId(clusterId)