调用DescribeInstallCodes接口查询手动安装云安全中心Agent的安装命令列表。

使用说明

本接口用户查询在服务器上手动安装云安全中心Agent时的安装命令。查询结果包含安装验证码和服务器相关的信息。当您需要在服务器上手动安装云安全中心Agent时,您可以调用本接口获取手动安装命令。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeInstallCodes

要执行的操作。取值:DescribeInstallCodes

返回数据

名称 类型 示例值 描述
RequestId String C0D6119F-92EE-1276-B8B6-C81A7F9D57F5

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

InstallCodes Array of InstallCode

安装命令信息。

OnlyImage Boolean false

是否镜像安装。取值:

  • true:是
  • false:否
CaptchaCode String 15v02r

手动安装云安全中心Agent的安装验证码。

GroupId Long 9165712

服务器所属分组的ID。

GroupName String 未分组

服务器所属分组的名称。

ExpiredDate Long 1637810007000

安装命名到期的时间戳,单位为毫秒。

VendorName String 腾讯云

服务器供应商的名称。

Os String linux

服务器的操作系统。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeInstallCodes
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInstallCodesResponse>
    <RequestId>C0D6119F-92EE-1276-B8B6-C81A7F9D57F5</RequestId>
    <InstallCodes>
        <OnlyImage>false</OnlyImage>
        <CaptchaCode>15v02r</CaptchaCode>
        <GroupId>9165712</GroupId>
        <GroupName>未分组</GroupName>
        <ExpiredDate>1637810007000</ExpiredDate>
        <VendorName>腾讯云</VendorName>
        <Os>linux</Os>
    </InstallCodes>
</DescribeInstallCodesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C0D6119F-92EE-1276-B8B6-C81A7F9D57F5",
  "InstallCodes" : [ {
    "OnlyImage" : false,
    "CaptchaCode" : "15v02r",
    "GroupId" : 9165712,
    "GroupName" : "未分组",
    "ExpiredDate" : 1637810007000,
    "VendorName" : "腾讯云",
    "Os" : "linux"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
500 ServerError ServerError 服务故障

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