获取主机基本信息列表
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | ListHostsBasicInfos | 要执行的操作,取值:ListHostsBasicInfos。 |
Version | String | 是 | 2024-05-08 | API的版本,取值:2024-05-08。 |
Conditions | Object | 否 | -- | 主机信息的筛选条件 |
IdList | Array of String | 否 | [rjrAS CCgGE HhccG] | 主机ID列表 |
PageNumber | Long | 是 | 83 | 翻页页码 |
PageSize | Long | 是 | 86 | 每页的大小 |
SortBy | String | 否 | eagxB | 排序字段 |
SortOrder | String | 否 | yqvEh | 排序顺序
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
TotalCount | Long | 68 | 全部数据条数 |
PageNumber | Long | 34 | 当前页面 |
PageSize | Long | 1 | 页面大小 |
Data | Array of Object | -- | Data |
POST /?Action=ListHostsBasicInfos&Version=2024-05-08HTTP/1.1 Host: seccenter.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20241120T080538Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241120/cn-beijing/seccenter/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "Conditions": { "AgentID": "TpOpy", "AgentIDList": [ "xAbjp", "xKNUt", "hcgKS" ], "AgentStatus": [ "ZriXw", "UbbhF", "jiFal" ], "AllHost": true, "CloudProviders": [ "VgSZf", "euLnO", "rBVEL" ], "Hostname": "LXAXK", "Ip": "YuFqG", "LeafGroupIDs": [ "nvWTO", "XOBQt", "Selfz" ], "Os": "ldWjh", "Platforms": [ "rzdah", "bFDZQ", "krYWC" ], "ProxyName": "xEltW", "ProxyServerName": "fDNee", "Regions": [ "aFknm", "UzqBX", "VBNDN" ], "Risk": { "Alarm": true, "Baseline": false, "IsRealRiskVul": false, "Virus": true, "Vuln": false }, "SecurityEnhancement": false, "Status": [ "cqTaP", "ZivGU", "VYgqT" ], "Tags": [ "VZKjP", "ZEkbG", "WFyZq" ], "TopGroupID": "PPnhE", "VirusFileAutoIsolate": false, "Visibility": [ "CKzlt", "ctYVH", "KCTaw" ], "VpcIds": [ "MILMq", "wygBh", "widkl" ] }, "IdList": [ "wsquF", "ieWcx", "OAJUM" ], "PageNumber": 61, "PageSize": 17, "SortBy": "NWXMx", "SortOrder": "Uveiu" }
{ "ResponseMetadata": { "RequestId": "20241120165538010234567890", "Action": "ListHostsBasicInfos", "Version": "2024-05-08", "Service": "seccenter", "Region": "cn-beijing" }, "Result": { "Data": [ { "AbnormalPluginsList": "eLYoV", "AccountID": "fqGhE", "AgentID": "BpKrP", "AgentStatus": "zXtnK", "ClientPublicIP": "DXAgl", "CloudProvider": "ZtxGT", "CollectStatus": true, "CpuUsage": 0.009222445676576272, "Dns": "lWVln", "EcsInstance": { "AccessKey": "ipVvA", "AccountID": "WDwQj", "Cpu": 81, "CreatedAt": "sNLis", "ECSUpdateAt": "wNQeb", "EipAddress": "BwhnS", "HostName": "hVgdE", "IPList": [ "OmvrI", "bcHnk", "bXMba" ], "InstanceName": "EJBdK", "Mem": 0, "OsName": "IcWnL", "OsType": "eTvQJ", "Platform": "mIocx", "PlatformVersion": "QzBKy", "PrimaryIpAddress": "RQUaS", "Region": "cQgwj", "SecurityEnhancementStrategy": "xCXfr", "Status": "OVOiy", "Visibility": "nVEOv", "VpcId": "UBFpe", "VpcName": "EhJww", "ZoneId": "INzrw" }, "FirstHeartbeatTime": 5, "Gateway": "USUdr", "Group": "HwDjs", "GroupPath": "RBbnp", "GroupPathEn": "saCdS", "KernelVersion": "AJkae", "LastHeartbeatTime": 23, "MemUsage": 0.6736300522105161, "OldValidCode": 17, "Online": true, "Platform": "GZuhf", "PlatformVersion": "EtGQg", "PluginsBriefInfo": "PwTPS", "PluginsStatus": "uIbSE", "Reason": "pAAwf", "SecurityEnhancement": true, "StartTime": 3, "Status": "aKiZc", "Tags": [ "yYQky", "AeRzf", "mWmYQ" ], "TotalMem": 94, "UserStatus": "JAGNR", "UserStatusReason": "MYPFy", "UserStatusReasonCode": 82 } ], "PageNumber": 34, "PageSize": 98, "TotalCount": 20 } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
400 | MissingParameter | 请求参数缺失 |
400 | InvalidParameter | 请求参数错误 |
400 | OperationDenied | 不允许的操作 |
403 | OperationDenied.TenantUnauthorized(%s) | 未授权的租户操作 |
500 | InternalError | 服务器内部错误 |
500 | DBOperateError | 数据库操作异常 |