根据 AgentID 获取单台主机的系统、网络、客户端、防护状态和各类安全风险统计；AgentID 为必填，TopGroupID 不传时不限制根分组。

调试 #

请求参数 #

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

返回参数 #

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

请求示例 #

GET /?Action=GetHostBasicInfo&Version=2024-05-08&AgentID=agent-id-001&TopGroupID=group-id-001 HTTP/1.1
Host: seccenter.volcengineapi.com
X-Date: 20241120T080538Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241120/cn-beijing/seccenter/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

返回示例 #

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "GetHostBasicInfo",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": {
    "AbnormalPluginsList": "collector: offline",
    "AccountID": "account-id-001",
    "AgentID": "agent-id-001",
    "Alarm": {
      "Critical": 1,
      "High": 1,
      "Low": 1,
      "Medium": 1
    },
    "Baseline": {
      "High": 1,
      "Low": 1,
      "Medium": 1,
      "Pass": 1
    },
    "ClientPublicIP": "192.0.2.10",
    "CloudProvider": "volcengine",
    "CollectStatus": true,
    "CpuUsage": 0.95,
    "Dns": "DNS",
    "EcsInstance": {
      "AccessKey": "AKLTEXAMPLE001",
      "AccountID": "account-id-001",
      "Cpu": 1,
      "CreatedAt": "2024-05-08T10:00:00Z",
      "ECSUpdateAt": "2024-05-08T10:00:00Z",
      "EipAddress": "192.0.2.10",
      "HostName": "host-001",
      "IPList": [
        "192.0.2.10"
      ],
      "InstanceName": "example-name",
      "Mem": 1,
      "OsName": "veLinux 1.0 64位",
      "OsType": "veLinux",
      "Platform": "Linux",
      "PlatformVersion": "1.0",
      "PrimaryIpAddress": "192.0.2.10",
      "Region": "cn-beijing",
      "SecurityEnhancementStrategy": "security-enhancement-strategy-sample",
      "Status": "RUNNING",
      "Visibility": "visibility-sample",
      "VpcId": "vpc-id-001",
      "VpcName": "example-name",
      "ZoneId": "cn-beijing-a"
    },
    "FirstHeartbeatTime": 1786533780,
    "Gateway": "192.0.2.1",
    "Group": "default-group",
    "GroupPath": "/group1/group2",
    "GroupPathEn": "/group1/group2",
    "KernelVersion": "1.0.0",
    "LastHeartbeatTime": 1786533780,
    "MemUsage": 0.95,
    "OldValidCode": 1,
    "Online": true,
    "Platform": "linux",
    "PlatformVersion": "linux",
    "PluginsBriefInfo": "collector 1.0.0 online",
    "PluginsStatus": "all_online",
    "RealRiskVul": {
      "Critical": 1,
      "High": 1,
      "Low": 1,
      "Medium": 1,
      "Unknown": 1
    },
    "Reason": "--",
    "SecurityEnhancement": true,
    "StartTime": 1786533780,
    "State": "success",
    "StateDetail": "success",
    "Status": "Protecting",
    "Tags": [
      "production"
    ],
    "TotalMem": 8589934592,
    "UserStatus": "start_succeed",
    "UserStatusReason": "success",
    "UserStatusReasonCode": 0,
    "Virus": {
      "Critical": 1,
      "High": 1,
      "Low": 1,
      "Medium": 1
    },
    "Vuln": {
      "Critical": 1,
      "High": 1,
      "Low": 1,
      "Medium": 1,
      "Unknown": 1
    }
  }
}

错误码 #

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