ListAssetCenterHosts - 主机列表--云安全中心-火山引擎

文档中心

云安全中心

请输入

HIDS_ASSET_HOST

ListAssetCenterHosts - 主机列表

主机列表

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	ListAssetCenterHosts	要执行的操作，取值：ListAssetCenterHosts。
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	排序顺序 Asc 升序排列 Desc 降序排列

返回参数

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

参数	类型	示例值	描述
Data	Array of Object	--	Data
PageNumber	Long	34	当前页面
PageSize	Long	1	页面大小
TotalCount	Long	68	全部数据条数

请求示例

POST /?Action=ListAssetCenterHosts&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": [
    "mKJmz",
    "ADQXI",
    "aebFA"
  ],
  "PageNumber": 56,
  "PageSize": 68,
  "SortBy": "pWisV",
  "SortOrder": "ykkVa"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "ListAssetCenterHosts",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": {
    "Data": [
      {
        "AbnormalPluginsList": "KOSfp",
        "AccountID": "ssJXE",
        "AgentID": "TdweU",
        "AgentStatus": "iRLZR",
        "ClientPublicIP": "VWIzU",
        "CloudProvider": "ZesGn",
        "CpuUsage": 0.5307617353615516,
        "Dns": "BoaMg",
        "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": 28,
        "Gateway": "eUtgx",
        "Group": "OWHiZ",
        "GroupPath": "GtfOV",
        "GroupPathEn": "UBGGP",
        "KernelVersion": "UzJhX",
        "LastHeartbeatTime": 47,
        "MemUsage": 0.23776479628926495,
        "OldValidCode": 89,
        "Online": true,
        "Platform": "czExi",
        "PlatformVersion": "qeojg",
        "PluginsBriefInfo": "CmvKo",
        "PluginsStatus": "ohTqD",
        "Reason": "fcjOm",
        "Risk": {
          "Alarm": 25,
          "Baseline": 60,
          "RealRiskVul": 79,
          "Virus": 94,
          "Vuln": 13
        },
        "SecurityEnhancement": true,
        "StartTime": 38,
        "Status": "WXSCp",
        "Tags": [
          "iASsE",
          "XFfnB",
          "mWGuy"
        ],
        "TotalMem": 88,
        "UserStatus": "uKXDO",
        "UserStatusReason": "CXvDp",
        "UserStatusReasonCode": 81
      }
    ],
    "PageNumber": 96,
    "PageSize": 36,
    "TotalCount": 27
  }
}

错误码

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

状态码	错误码	错误信息	说明
400	OperationDenied	Operation is denied because the specified resource is in use.	不允许的操作
400	InvalidParameter	The specified parameter %s is invalid.	请求参数错误
400	MissingParameter	The required parameter %s is missing.	请求参数缺失
403	OperationDenied.TenantUnauthorized(%s)	The request has failed due to tenant not found(%s)	未授权的租户操作
500	DBOperateError	The request has failed because database return error: %s	数据库操作异常
500	InternalError	The request has failed due to an unknown error.	服务器内部错误

最近更新时间：2026.06.01 14:48:58

这个页面对您有帮助吗？

有用

无用

云安全中心

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码