DescribeCloudCenterInstances - 查询资产信息 - 云安全中心

通过设置搜索条件查询符合条件的资产信息，例如通过资产实例名称、资产实例所属区域等条件搜索指定资产。目前提供分页和NextToken两种方式，推荐NextToken方式。

接口说明

您可以通过资产的实例 ID、实例名称、所属 VPC ID、地域、公网 IP 地址等条件搜索资产，还可以通过设置不同搜索条件之间的逻辑关系搜索符合多个搜索条件的资产。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sas:DescribeCloudCenterInstances	get	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId`deprecated`	string	否	要查询的实例所在地域的 ID。	cn-hangzhou
Criteria	string	否	设置搜索资产的条件。该参数 JSON 格式，输入参数时注意大小写。说明支持使用资产的实例 ID、实例名称、所属 VPC ID、地域、公网 IP 地址等条件搜索资产。您可以调用 DescribeCriteria 接口查询支持的搜索条件。	[{"name":"riskStatus","value":"YES"},{"name":"internetIp","value":"1.2.XX.XX"}]
MachineTypes	string	否	要查询的资产的类型。取值： ecs：服务器。 cloud_product：云产品。	ecs
LogicalExp	string	否	设置多个搜索条件间生效的逻辑关系。默认 OR，取值： OR：表示多个搜索条件之间是或的关系。 AND：表示多个搜索条件之间是与的关系。	OR
PageSize	integer	否	设置分页查询时，每页显示的资产的数量。默认值为 20，表示每页显示 20 条资产信息。	100
CurrentPage	integer	否	设置从返回结果的第几页开始显示查询结果。默认值为 1，表示从第 1 页开始显示。	1
Importance	integer	否	设置资产重要性。取值： 2：重要资产 1：一般资产 0：测试资产	2
NoGroupTrace	boolean	否	默认分组未分组是否要做国际化处理。默认 false，取值： true：不做国际化处理。即返回参数 GroupTrace 的取值为云安全中心的默认分组未分组时，未分组仍然显示为未分组。 false：需要国际化处理。即返回参数 GroupTrace 的取值为云安全中心的默认分组未分组时，未分组显示为 default。	false
Lang	string	否	设置请求和接收消息的语言类型，默认为 zh。取值： zh：中文 en：英文	zh
UseNextToken	boolean	否	是否使用 NextToken 方式拉取资产列表数据。如果使用此参数 TotalCount 不再返回。取值： true：使用 NextToken 方式 false：不使用 NextToken 方式	false
NextToken	string	否	使用 NextToken 方式下返回的 NextToken 值。第一次拉取传空。	E17B501887A2D3AA5E8360A6EFA3B***
ResourceDirectoryAccountId	long	否	资源目录成员账号主账号 ID。说明调用 DescribeMonitorAccounts 接口可以获取该参数。	1232428423234****
Flags	string	否	资产厂商。多个资产厂商之间使用半角逗号（,）分隔。取值： 0：阿里云资产 1：云外资产 2：IDC 资产 3、4、5、7：其它云资产 8：轻量级资产 9：SAE 10：PAI	1,2,3

返回参数

名称	类型	描述	示例值
	object
Success	boolean	接口调用的结果状态。取值： true：接口调用成功。 false：接口调用失败。	true
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	32A73759-4C0F-4801-BE98-901223ACEE9A
PageInfo	object	页面显示信息。
CurrentPage	integer	分页查询时，当前页的页码。	1
PageSize	integer	分页查询时，每页显示的资产的数量。默认值为 20，表示每页显示 20 条资产信息。	20
TotalCount	integer	查询到的资产的总数量。	50
Count	integer	当前页显示的资产的条数。	10
NextToken	string	使用 NextToken 方式下返回的 NextToken 值。	B604532DEF982B875E8360A6EFA3B***
Instances	array<object>	资产详细信息列表。
Instance	object	资产详细信息。
Status	string	实例的运行状态。取值： Running：运行中。 notRunning：已关机。	Running
CpuInfo	string	资产的 CPU 信息。	Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz
InternetIp	string	实例的公网 IP 地址。	1.2.XX.XX
Kernel	string	内核版本信息。	3.10.0-1127.19.1.el7.x86_64
Bind	boolean	资产是否已绑定授权。取值： true：已绑定授权 false：未绑定授权	true
OsName	string	实例的内核版本。	-
Tag	string	资产实例的标签名称。	InternetIp,test
ClientStatus	string	实例的客户端在线状态。取值： online：在线，表示资产的 Agent 客户端状态为开启。 offline：离线，表示资产的 Agent 客户端状态为关闭。 pause：暂停，表示资产的 Agent 客户端状态为暂停保护。	online
Mem	integer	内存（MB）。	1024
VpcInstanceId	string	实例所属 VPC 的 ID。	vpc-uf60agqq65bs98zoo****
TagId	string	资产的标签 ID。	121313,41412
Flag	integer	实例是否为阿里云资产。取值： 0：阿里云资产 1：非阿里云资产	0
LastLoginTimestamp	long	客户端最后一次在线的时间戳。单位为毫秒。	1637592907000
AuthVersion	integer	资产的授权版本。取值： 1：Free Edition 6：Anti-virus Edition 5：Advanced 3：Enterprise Edition 7：Ultimate Edition	1
Region	string	实例所属地域 ID。	cn-hangzhou-cm*-*
InstanceName	string	实例名称。	yztest-l***
PodCount	integer	容器组个数。	1
VulCount	integer	实例上存在的漏洞数量。	2
HcStatus	string	实例是否检测出了基线风险项。取值： YES：检测出了基线风险项 NO：未检测出基线风险项	YES
CreatedTime	long	集群创建的时间戳，单位为毫秒。	1607365213000
GroupTrace	string	资产所在的分组的名称。	default
ClusterId	string	集群 ID。	c690a0789419f4284a4e0a29e12fe****
RiskStatus	string	资产是否存在安全风险。取值： YES：存在 NO：不存在	NO
Cores	integer	资产的 CPU 核数。	4
VulStatus	string	实例是否存在漏洞。取值： YES：存在漏洞。 NO：不存在漏洞。	YES
AlarmStatus	string	资产是否存在安全告警。取值： YES：存在安全告警 NO：不存在安全告警	NO
MacListString	string	系统的 Mac 地址。	00:13:3e:31:13:39,02:12:67:b8::
Importance	integer	资产的重要性。取值： 2：重要资产 1：一般资产 0：测试资产	2
HealthCheckCount	integer	实例中存在的基线风险数量。	1
Ip	string	实例的公网 IP 地址。	1.2.XX.XX
Os	string	实例的操作系统。	Linux
AuthModifyTime	long	资产的授权绑定时间戳。单位：毫秒。	1627974044000
SafeEventCount	integer	资产存在的安全告警数量。	5
InstanceId	string	实例 ID。	i-m5***
AssetType	string	资产的类型。取值： 0：云服务器 1：负载均衡 2：NAT 网关 3：RDS 数据库 4：MongoDb 数据库 5：REDIS 数据库 6：容器镜像 7：容器	0
IntranetIp	string	实例的私网 IP 地址。	1.2.XX.XX
Vendor	integer	资产厂商。取值： 0：阿里云资产 1：云外资产 2：IDC 资产 3、4、5、7：其它云资产 8：轻量级资产 9：SAE 10：PAI	0
RegionId	string	资产所在的地域的 ID。	cn-hanghzou
Uuid	string	实例的 UUID。	c9107c04-942f-40c1-981a-f1c1***
GroupId	long	实例所属分组 ID。	4120080
RegionName	string	资产的地域名称。	China (Hangzhou)
VendorName	string	资产的服务商名称。取值： ALIYUN：阿里云 OUT：云外资产 IDC：IDC TENCENT：其它云 HUAWEICLOUD：其它云 Microsoft：其它云 AWS：其它云 TRIPARTITE：轻量级服务器 SAE：SAE PAI：PAI	IDC
AuthVersionName	string	资产的授权版本（具体名称）。取值：免费版防病毒版高级版企业版旗舰版	Ultimate Edition
ClusterName	string	集群名称。	cluster1
ExposedStatus	integer	资产暴露状态。取值： 0：未暴露 1：已暴露	0
RiskCount	string	资产存在的风险项统计。JSON 格式，包含以下字段： account：异地登录和爆破成功的账号数量 appNum：扫描器漏洞数量 asapVulCount：高危漏洞总数量 baselineHigh：高危基线风险数量 baselineLow：低危基线风险数量 baselineMedium：中危基线风险数量 baselineNum：云产品配置风险总数量 cmsNum： WEB-CMS 漏洞数量 containerAsap：容器高危漏洞数量 containerLater：容器中危漏洞数量 containerNntf：容器低危漏洞数量 containerRemind：容器提醒告警数量 containerSerious：容器紧急告警数量 containerSuspicious：容器可疑告警数量 cveNum：Linux 漏洞数量 emgNum：应急漏洞数量 health：未处理的基线告警数量 imageBaselineHigh：镜像高危基线风险数量 imageBaselineLow：镜像低危基线风险数量 imageBaselineMedium：镜像中危基线风险数量 imageBaselineNum：镜像基线风险总数量 imageMaliciousFileRemind：镜像提醒恶意文件数量 imageMaliciousFileSerious：镜像紧急恶意文件数量 imageMaliciousFileSuspicious：镜像可疑恶意文件数量 imageVulAsap：镜像高危漏洞数量 imageVulLater：镜像中危漏洞数量 imageVulNntf：镜像低危漏洞数量 laterVulCount：中危漏洞数量 newSuspicious：告警数量 nntfVulCount：低危漏洞数量 remindNum：提醒告警数量 scaNum：软件成分分析漏洞数量 seriousNum：紧急告警数量 suspNum：可疑告警数量 suspicious：告警总数量 sysNum：Windows 漏洞数量 trojan：木马数量 uuid：资产 UUID vul：漏洞数量 weakPWNum：弱口令数量	{ "account": 0, "appNum": 0, "asapVulCount": 0, "baselineHigh": 0, "baselineLow": 0, "baselineMedium": 0, "baselineNum": 0, "cmsNum": 0, "containerAsap": 0, "containerLater": 0, "containerNntf": 0, "containerRemind": 0, "containerSerious": 0, "containerSuspicious": 0, "cveNum": 0, "emgNum": 0, "health": 0, "imageBaselineHigh": 0, "imageBaselineLow": 0, "imageBaselineMedium": 0, "imageBaselineNum": 0, "imageMaliciousFileRemind": 0, "imageMaliciousFileSerious": 0, "imageMaliciousFileSuspicious": 0, "imageVulAsap": 0, "imageVulLater": 0, "imageVulNntf": 0, "laterVulCount": 0, "newSuspicious": 0, "nntfVulCount": 0, "remindNum": 0, "scaNum": 0, "seriousNum": 0, "suspNum": 0, "suspicious": 0, "sysNum": 0, "trojan": 0, "uuid": "inet-37316411-37fe-4b72-b245-346a2721****", "vul": 0, "weakPWNum": 0 }
IpListString	string	系统的 IP 列表。	172.31.XX.XX,172.171.XX.XX
AssetTypeName	string	资产的类型名称。	Elastic Compute Service
FlagName	string	资产厂商。取值： ALIYUN OUT IDC Tencent HUAWEICLOUD Azure AWS ASK TRIPARTITE SAE PAI	ASK
AppId	string	应用 ID。说明该数据仅当 Vendor 为 9 时可存在。	test
AppName	string	应用名称。说明该数据仅当 Vendor 为 9 时可存在。	testAppName

示例

正常返回示例

JSON格式

{
  "Success": true,
  "RequestId": "32A73759-4C0F-4801-BE98-901223ACEE9A",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 50,
    "Count": 10,
    "NextToken": "B604532DEF982B875E8360A6EFA3B***"
  },
  "Instances": [
    {
      "Status": "Running",
      "CpuInfo": "Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz",
      "InternetIp": "1.2.XX.XX",
      "Kernel": "3.10.0-1127.19.1.el7.x86_64",
      "Bind": true,
      "OsName": "-",
      "Tag": "InternetIp,test",
      "ClientStatus": "online",
      "Mem": 1024,
      "VpcInstanceId": "vpc-uf60agqq65bs98zoo****",
      "TagId": "121313,41412",
      "Flag": 0,
      "LastLoginTimestamp": 1637592907000,
      "AuthVersion": 1,
      "Region": "cn-hangzhou-cm***-***",
      "InstanceName": "yztest-l***",
      "PodCount": 1,
      "VulCount": 2,
      "HcStatus": "YES",
      "CreatedTime": 1607365213000,
      "GroupTrace": "default",
      "ClusterId": "c690a0789419f4284a4e0a29e12fe****",
      "RiskStatus": "NO",
      "Cores": 4,
      "VulStatus": "YES",
      "AlarmStatus": "NO",
      "MacListString": "00:13:3e:31:13:39,02:12:67:b8:**:**",
      "Importance": 2,
      "HealthCheckCount": 1,
      "Ip": "1.2.XX.XX",
      "Os": "Linux",
      "AuthModifyTime": 1627974044000,
      "SafeEventCount": 5,
      "InstanceId": "i-m5***",
      "AssetType": "0",
      "IntranetIp": "1.2.XX.XX",
      "Vendor": 0,
      "RegionId": "cn-hanghzou",
      "Uuid": "c9107c04-942f-40c1-981a-f1c1***",
      "GroupId": 4120080,
      "RegionName": "China (Hangzhou)",
      "VendorName": "IDC",
      "AuthVersionName": "Ultimate Edition",
      "ClusterName": "cluster1",
      "ExposedStatus": 0,
      "RiskCount": "{\n      \"account\": 0,\n      \"appNum\": 0,\n      \"asapVulCount\": 0,\n      \"baselineHigh\": 0,\n      \"baselineLow\": 0,\n      \"baselineMedium\": 0,\n      \"baselineNum\": 0,\n      \"cmsNum\": 0,\n      \"containerAsap\": 0,\n      \"containerLater\": 0,\n      \"containerNntf\": 0,\n      \"containerRemind\": 0,\n      \"containerSerious\": 0,\n      \"containerSuspicious\": 0,\n      \"cveNum\": 0,\n      \"emgNum\": 0,\n      \"health\": 0,\n      \"imageBaselineHigh\": 0,\n      \"imageBaselineLow\": 0,\n      \"imageBaselineMedium\": 0,\n      \"imageBaselineNum\": 0,\n      \"imageMaliciousFileRemind\": 0,\n      \"imageMaliciousFileSerious\": 0,\n      \"imageMaliciousFileSuspicious\": 0,\n      \"imageVulAsap\": 0,\n      \"imageVulLater\": 0,\n      \"imageVulNntf\": 0,\n      \"laterVulCount\": 0,\n      \"newSuspicious\": 0,\n      \"nntfVulCount\": 0,\n      \"remindNum\": 0,\n      \"scaNum\": 0,\n      \"seriousNum\": 0,\n      \"suspNum\": 0,\n      \"suspicious\": 0,\n      \"sysNum\": 0,\n      \"trojan\": 0,\n      \"uuid\": \"inet-37316411-37fe-4b72-b245-346a2721****\",\n      \"vul\": 0,\n      \"weakPWNum\": 0\n}",
      "IpListString": "172.31.XX.XX,172.171.XX.XX",
      "AssetTypeName": "Elastic Compute Service",
      "FlagName": "ASK",
      "AppId": "test",
      "AppName": "testAppName"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	NoPermission	no permission	无此服务的访问权限。
400	RdCheckNoPermission	Resource directory account verification has no permission.	资源目录账号校验无权限。
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！
500	RdCheckInnerError	Resource directory account service internal error.	资源目录账号服务内部错误。

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-08-01	OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更	查看变更详情
2023-07-20	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2023-07-04	OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更	查看变更详情
2022-12-23	OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 标记、OpenAPI 错误码发生变更	查看变更详情