主机列表

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例

POST /?Action=ListAssetCenterHosts&Version=2024-05-08&PageNumber=1&PageSize=10&SortBy=SortBy&SortOrder=Asc HTTP/1.1
Host: seccenter.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241214T145753Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241214/cn-beijing/seccenter/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "Conditions": {
    "AgentID": "i-ycwdlfegw0qbxyxxxxxx",
    "AgentIDList": [
      "i-ycwdlfegw0qbxyxxxxxx","i-ycwdlfegw1qbxyxxxxxx"
    ],
    "CloudProviders": [
      "volc","ali"
    ],
    "Hostname": "instance-host-name",
    "Ip": "172.16.xx.xx",
    "LeafGroupIDs": [
      "crl9aa73pfsdrned3gn0","crl9aa73pfsdrned3xv6"
    ],
    "Platforms": [
      "CentOS","Ubuntu"
    ],
    "ProxyName": "ProxyName",
    "ProxyServerName": "ProxyServerName",
    "Regions": [
      "cn-shanghai","cn-beijing"
    ],
    "Risk": {
      "Alarm": true,
      "Baseline": true,
      "Virus": true,
      "Vuln": true
    },
    "SecurityEnhancement": true,
    "Tags": [
      "tag1","tag2"
    ],
    "TopGroupID": "crl9aa73pfsdrned3gmg",
    "VirusFileAutoIsolate": true,
    "AgentStatus": [
      "online","offline"
    ],
    "AllHost": true,
    "Status": [
      "Protecting","Unprotected"
    ],
    "VpcIds": [
      "vpc-3thbinq64t4bwbxxxxxx","vpc-3thbinq64t4bwbxxxxxx"
    ],
    "Visibility": [
      "public"
    ]
  },
  "IdList": [
    "i-ycwdlfegw0qbxyxxxxxx","i-ycwdlfegw1qbxyxxxxxx"
  ]
}

返回示例

{
  "PageInfo": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 1
  },
  "ResponseMetadata": {
    "RequestId": "2024121422593712619707706789FA1B",
    "Action": "ListAssetCenterHosts",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": [
    {
      "AbnormalPluginsList": "events,collector",
      "AgentID": "i-ycwdlfegw0qbxyxxxxxx",
      "AgentStatus": "online",
      "CloudProvider": "volc",
      "CpuUsage": 63.224845574002394,
      "Dns": "100.96.xx,xx,100.96.xx,xx",
      "EcsInstance": {
        "AccessKey": "AccessKey",
        "AccountID": "210070****",
        "Cpu": 4,
        "EipAddress": "101.10.xx.xx",
        "HostName": "instance-host-name",
        "IPList": [
          "192.168.xx.xx",
          "192.168.xx.xx"
        ],
        "InstanceName": "InstanceName",
        "Mem": 65536,
        "OsName": "CentOS 7.9 64位",
        "OsType": "linux",
        "Platform": "CentOS",
        "PlatformVersion": "7.9",
        "PrimaryIpAddress": "192.168.xx.xx",
        "Region": "cn-shanghai",
        "Status": "RUNNING",
        "Visibility": "public",
        "VpcName": "VPC-4bwbxxxxxx",
        "ZoneId": "cn-shanghai-a",
        "ECSUpdateAt": "2024-12-11T03:22:14.861Z",
        "VpcId": "vpc-3thbinq64t4bwbxxxxxx"
      },
      "FirstHeartbeatTime": 1702090889,
      "Gateway": "172.31.xx.xx",
      "Group": "auto_gz",
      "GroupPath": "/未分组",
      "KernelVersion": "5.10.0-23-amd64",
      "LastHeartbeatTime": 1702090889,
      "MemUsage": 18.35766946947702,
      "Online": true,
      "Platform": "CentOS",
      "PluginsBriefInfo": "[{\"name\":\"collector\",\"pversion\":\"2.2.5.10\",\"status\":\"removed\"},{\"name\":\"container_monitor\",\"pversion\":\"1.0.0.8\",\"status\":\"removed\"},{\"name\":\"driver\",\"pversion\":\"1.0.0.56\",\"status\":\"removed\"},{\"name\":\"journal_watcher\",\"pversion\":\"1.0.0.24\",\"status\":\"removed\"},{\"name\":\"scanner\",\"pversion\":\"3.2.0.174\",\"status\":\"removed\"}]",
      "PluginsStatus": "all_online",
      "Reason": "--",
      "Risk": {
        "Alarm": 8,
        "Baseline": 16,
        "Virus": 51,
        "Vuln": 21
      },
      "SecurityEnhancement": true,
      "StartTime": 1702090889,
      "Status": "Protecting",
      "Tags": [
        "tag1",
        "tag2"
      ],
      "TotalMem": 8233947136,
      "UserStatus": "start_succeed",
      "UserStatusReason": "--"
    }
  ]
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。