调用OperateAgentClientInstall安装Agent_云安全中心(Security Center)-阿里云帮助中心

为服务器安装云安全中心Agent插件。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
InstanceIds	string	否	要安装云安全中心 Agent 的服务器实例的 ID 列表，多个实例 ID 之间使用半角逗号（,）分隔。说明 InstanceIds、Uuids 这两个参数二选一，必须设置一个，才可以成功调用本接口，如果选择 InstanceIds，则 Region 和 Os 必填。	i-uf6j8vq9l4r5ntht****
Uuids	string	否	要安装的服务器的 UUID 列表，多个 UUID 之间使用半角逗号（,）分隔。说明 InstanceIds、Uuids 这两个参数二选一，必须设置一个，才可以成功调用本接口。	1587bedb-fdb4-48c4-9330-************
Lang	string	否	设置请求和接收消息的语言类型，默认为 zh。取值： zh：中文 en：英文	en
Region	string	否	机器所在地域，包括但不限于如下地域： cn-hangzhou：杭州 cn-beijing：北京 cn-shanghai：上海 cn-zhangjiakou：张家口 cn-shenzhen：深圳	cn-hangzhou
Os	string	否	实例的操作系统。取值： linux：linux windows：windows	linux

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	AE79B457-877C-51C6-AD72-0D34A025D***
AegisCelintInstallResposeList	array<object>	安装 Agent 客户端调用请求的返回结果。
	object	安装 Agent 客户端返回结果详情。
Uuid	string	服务器 UUID。	1587bedb-fdb4-48c4-9330-****
InstanceId	string	服务器的实例 ID。	i-uf6j8vq9l4r5ntht****
RecordId	long	客户端安装任务 ID。	2856

示例

正常返回示例

JSON格式

{
  "RequestId": "AE79B457-877C-51C6-AD72-0D34A025D***",
  "AegisCelintInstallResposeList": [
    {
      "Uuid": "1587bedb-fdb4-48c4-9330-****",
      "InstanceId": "i-uf6j8vq9l4r5ntht****",
      "RecordId": 2856
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InstallNotGranted	The installation permission is not granted.	权限不足，请先登录RAM控制台授予AliyunServiceRoleForSas权限
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	InternalError	The request processing has failed due to some unknown error.	服务发生某些未知错误，请稍后再试。
500	ServerError	ServerError	服务故障，请稍后重试！

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2023-08-29	OpenAPI 错误码发生变更	查看变更详情
2023-06-05	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2022-12-19	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情
2022-08-01	API 内部配置变更，不影响调用	查看变更详情
2022-08-01	API 内部配置变更，不影响调用	查看变更详情