调用DescribeCloudCenterInstances接口查询资产中心页面中的资产信息,例如资产实例名称、资产实例所属区域等。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeCloudCenterInstances

系统规定参数。取值:DescribeCloudCenterInstances。

Criteria String [{\"name\":\"riskStatus\",\"value\":\"YES\"},{\"name\":\"internetIp\",\"value\":\"1.2.\"}]

搜索条件。例如:实例ID/名称,所属VPC ID、地域、IP等。

参数格式:{\"name\":\"条件1名称\",\"value\":\"条件1值\"},{\"name\":\"条件2名称\",\"value\":\"条件2值\"},{},...

CurrentPage Integer 1

分页查询时,当前页的页码。

LogicalExp String OR

多个搜索条件间的逻辑关系。

  • OR:表示多个条件间是“或”的关系
  • AND:表示多个条件间是“与”的关系
MachineTypes String ecs

资产类型。

  • ecs:服务器
  • cloud_product:云产品
NoPage Boolean true

是否分页查询。

  • true:表示进行分页查询数据
  • false:表示不进行分页查询数据
PageSize Integer 20

分页查询时,每页显示的数据最大条数。

返回数据

名称 类型 示例值 描述
Instances Array

资产详细信息。

AlarmStatus String NO

资产实例是否有安全告警。

  • YES:有
  • NO:无
AssetType String ecs

资产类型。

ClientStatus String online

资产实例的客户端是否在线。

  • online:在线,表示资产的安全防护状态为开启
  • offline:离线,表示资产的安全防护状态为关闭
  • pause:暂停,表示资产的安全防护状态为暂停保护
Flag Integer 0

资产实例是否为阿里云所有。

  • 0:阿里云资产
  • 1:非阿里云资产
GroupId String 4120080

资产实例所属分组ID。

HcStatus String YES

资产实例是否有基线问题。

  • YES:有
  • NO:无
HealthCheckCount Integer 1

资产实例的基线检查问题数量。

InstanceId String i-m5***

资产实例ID。

InstanceName String yztest-l***

资产实例名称。

InternetIp String 1.2.3.4

资产实例的公网IP地址。

IntranetIp String 1.2.3.0

资产实例的私网IP地址。

Ip String 1.2.3.4

资产实例的公网IP地址。

Os String Linux

资产实例的操作系统。

OsName String CentOS 7.6 64位

资产实例的内核版本。

Region String cn-hangzhou-cm***-***

资产实例所属区域。

RegionId String cn-hanghzou

资产实例所属地域ID。

RegionName String 华北1(青岛)

资产实例所属地域名称。

RiskStatus String NO

资产实例是否存在风险。

  • YES:存在
  • NO:不存在
SafeEventCount Integer 5

资产实例的安全告警数量。

Status String Running

资产实例的开机状态。

  • Running:开机
  • notRunning:关机
Tag String InternetIp

资产实例所属标签名称。

Uuid String c9107c04-942f-40c1-981a-f1c1***

资产实例的唯一标识ID。

VpcInstanceId String classic

资产实例的所属VPC ID。

VulCount Integer 2

资产实例的漏洞数量。

VulStatus String YES

资产实例是否有漏洞问题。

  • YES:有
  • NO:无
PageInfo

页面显示信息。

Count Integer 10

当前页显示的数据条数。

CurrentPage Integer 1

当前页的页码。

PageSize Integer 20

每页显示数据条数。

TotalCount Integer 50

数据的总条数。

RequestId String 32A73759-4C0F-4801-BE98-901223ACEE9A

结果的请求ID。

Success Boolean true

结果的请求状态。

  • true:请求成功
  • false:请求失败

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeCloudCenterInstances
&<公共请求参数>

正常返回示例

XML 格式

<DescribeCloudCenterInstances>
  <RequestId>32A73759-4C0F-4801-BE98-901223ACEE9A</RequestId>
  <PageInfo>
        <Count>0</Count>
        <TotalCount>691</TotalCount>
        <PageSize>20</PageSize>
        <CurrentPage>1</CurrentPage>
  </PageInfo>
  <Instances>
        <RiskStatus>NO</RiskStatus>
        <Uuid>88f7ce77-595e-4580-b655-3***</Uuid>
        <Ip>1.2.3.4</Ip>
        <Flag>0</Flag>
        <RegionName>华东1(杭州)</RegionName>
        <OsName>CentOS  7.6 64位</OsName>
        <AssetType>0</AssetType>
        <InstanceId>i-m5e50***</InstanceId>
        <InternetIp>1.2.3.4</InternetIp>
        <HealthCheckCount>0</HealthCheckCount>
        <HcStatus>NO</HcStatus>
        <Os>linux</Os>
        <ClientStatus>online</ClientStatus>
        <Status>Running</Status>
        <Region>cn-hangzhou-cm***-***</Region>
        <VpcInstanceId>classic</VpcInstanceId>
        <VulStatus>NO</VulStatus>
        <Tag>InternetIp</Tag>
        <RegionId>cn-hangzhou</RegionId>
        <IntranetIp>1.2.3.0</IntranetIp>
        <AlarmStatus>NO</AlarmStatus>
        <VulCount>0</VulCount>
        <SafeEventCount>0</SafeEventCount>
        <InstanceName>yztest-l***</InstanceName>
  </Instances>
  <Instances>
        <RiskStatus>NO</RiskStatus>
        <Uuid>7a4735d6-75a4-4555-a18f-b***</Uuid>
        <Ip>1.2.3.4</Ip>
        <Flag>0</Flag>
        <RegionName>华东1(杭州)</RegionName>
        <OsName>CentOS  7.6 64位</OsName>
        <AssetType>0</AssetType>
        <InstanceId>i-m5e5***</InstanceId>
        <InternetIp>1.2.3.4</InternetIp>
        <HealthCheckCount>0</HealthCheckCount>
        <HcStatus>NO</HcStatus>
        <Os>linux</Os>
        <ClientStatus>online</ClientStatus>
        <Status>Running</Status>
        <Region>cn-hangzhou-cm***-***</Region>
        <VpcInstanceId>classic</VpcInstanceId>
        <VulStatus>NO</VulStatus>
        <Tag>InternetIp</Tag>
        <RegionId>cn-hangzhou</RegionId>
        <IntranetIp>1.2.3.0</IntranetIp>
        <AlarmStatus>NO</AlarmStatus>
        <VulCount>0</VulCount>
        <SafeEventCount>0</SafeEventCount>
        <InstanceName>yztest-l***</InstanceName>
  </Instances>
  <Success>true</Success>
</DescribeCloudCenterInstances>

JSON 格式

{
	"RequestId":"32A73759-4C0F-4801-BE98-901223ACEE9A",
	"Instances":[
		{
			"RiskStatus":"NO",
			"Uuid":"88f7ce77-595e-4580-b655-3***",
			"Ip":"1.2.3.4",
			"Flag":0,
			"RegionName":"华东1(杭州)",
			"OsName":"CentOS  7.6 64位",
			"AssetType":"0",
			"InstanceId":"i-m5e50***",
			"InternetIp":"1.2.3.4",
			"HealthCheckCount":0,
			"HcStatus":"NO",
			"Os":"linux",
			"Status":"Running",
			"ClientStatus":"online",
			"Region":"cn-hangzhou-cm***-***",
			"VpcInstanceId":"classic",
			"Tag":"InternetIp",
			"VulStatus":"NO",
			"IntranetIp":"1.2.3.0",
			"RegionId":"cn-hangzhou",
			"AlarmStatus":"NO",
			"VulCount":0,
			"InstanceName":"yztest-l***",
			"SafeEventCount":0
		},
		{
			"RiskStatus":"NO",
			"Uuid":"7a4735d6-75a4-4555-a18f-b***",
			"Ip":"1.2.3.4",
			"Flag":0,
			"RegionName":"华东1(杭州)",
			"OsName":"CentOS  7.6 64位",
			"AssetType":"0",
			"InstanceId":"i-m5e5***",
			"InternetIp":"1.2.3.4",
			"HealthCheckCount":0,
			"HcStatus":"NO",
			"Os":"linux",
			"Status":"Running",
			"ClientStatus":"online",
			"Region":"cn-hangzhou-cm***-***",
			"VpcInstanceId":"classic",
			"Tag":"InternetIp",
			"VulStatus":"NO",
			"IntranetIp":"1.2.3.0",
			"RegionId":"cn-hangzhou",
			"AlarmStatus":"NO",
			"VulCount":0,
			"InstanceName":"yztest-l***",
			"SafeEventCount":0
		}
	],
	"PageInfo":{
		"Count":0,
		"TotalCount":691,
		"PageSize":20,
		"CurrentPage":1
	},
	"Success":true
}

错误码

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