获取主机基本信息列表

调试

请求参数

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

返回参数

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

请求示例

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

{
  "Conditions": {
    "Hostname": "xxxx",
    "Ip": "xxxx",
    "Risk": {
      "Alarm": true,
      "Baseline": true,
      "Virus": true,
      "Vuln": true
    },
    "SecurityEnhancement": true,
    "VirusFileAutoIsolate": true,
    "ProxyName": "xxxx",
    "ProxyServerName": "xxxx",
    "AgentIdList": [
      "[\"i-ycwdlfegw0qbxyxxxxxx\",\"i-ycwdlfegw0qbxyxxxxxx\"]"
    ],
    "AgentStatus": [
      "[\"online\",\"offline\"]"
    ],
    "AgentId": "i-ycwdlfegw0qbxyxxxxxx",
    "Platforms": [
      "[\"linux\"]"
    ],
    "Regions": [
      "[\"cn-beijing\"]"
    ],
    "VpcIds": [
      "[\"vpc-5gudln3kb47473inqlkixxxx\"]"
    ],
    "Tags": [
      "[\"tag1\",\"tag2\"]"
    ],
    "Groups": [
      "[\"crl9aa73pfsdrned3gmg\"]"
    ],
    "Status": [
      "[\"running\"]"
    ],
    "Visibility": [
      "[\"private\"]"
    ]
  },
  "IdList": [
    "[\"i-ycwdlfegw0qbxyxxxxxx\", \"i-ycwdlfegw0qbxyxxxxxx\"]"
  ]
}

返回示例

{
  "PageInfo": {
      "PageNumber": 1,
      "PageSize": 10,
      "TotalCount": 1
  },
  "ResponseMetadata": {
    "RequestId": "2024120814154915923714219459C005",
    "Action": "ListHostsBasicInfos",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": [
    {
      "AbnormalPluginsList": "xxxx",
      "AgentID": "i-ycwdlfegw0qbxyxxxxxx",
      "AgentStatus": "online",
      "CollectStatus": true,
      "CpuUsage": 1,
      "Dns": "8.8.8.8",
      "EcsInstance": {
        "AccountID": "210070****",
        "Cpu": 1,
        "EipAddress": "xxxx",
        "HostName": "xxxx",
        "InstanceName": "xxxx",
        "Mem": 1,
        "OsName": "xxxx",
        "OsType": "xxxx",
        "Platform": "xxxx",
        "PlatformVersion": "xxxx",
        "PrimaryIpAddress": "xxxx",
        "Region": "xxxx",
        "Status": "xxxx",
        "Visibility": "xxxx",
        "VpcId": "xxxx",
        "VpcName": "xxxx",
        "ZoneId": "xxxx"
      },
      "FirstHeartbeatTime": 1733380044,
      "Gateway": "xxxx",
      "Group": "crl9aa73pfsdrned3gmg",
      "KernelVersion": "10.0.20348.1850 Build 20348.1850",
      "LastHeartbeatTime": 1733380044,
      "MemUsage": 1,
      "Online": true,
      "PluginsBriefInfo": "xxxx",
      "PluginsStatus": "all_online",
      "Reason": "xxxx",
      "SecurityEnhancement": true,
      "StartTime": 1,
      "Status": "Protecting",
      "Tags": [
        "[\"tag1\",\"tag2\"]"
      ],
      "UserStatus": "start_succeed",
      "UserStatusReason": "xxxx"
    }
  ]
}

错误码

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