DescribeCloudCenterInstances - sas-查询资产信息

更新时间:
复制 MD 格式

sas-查询云安全中心实例列表

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

riskmanagement:DescribeCloudCenterInstances

get

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

RegionId

string

否

要查询的实例所在地域的 ID。

cn-beijing

SdkRequest

object

否

云安全中心 SDK 请求

Criteria

string

否

设置搜索资产的条件。该参数 JSON 格式,输入参数时注意大小写。

说明

支持使用资产的实例 ID、实例名称、所属 VPC ID、地域、公网 IP 地址等条件搜索资产。您可以调用 DescribeCriteria 接口查询支持的搜索条件。

{\"contactIds\":[\"job-658854766790086656\",\"job-658854801112113152\"]}

CurrentPage

integer

否

当前页码。

1

Flags

string

否

资产厂商。多个资产厂商之间使用半角逗号(,)分隔。取值:

  • 0:阿里云资产

  • 1:云外资产

  • 2:IDC 资产

  • 3、4、5、7、14、16:其它云资产

  • 8:轻量级资产

  • 9:SAE

  • 10:PAI

0,10,13

Importance

integer

否

设置资产重要性。取值:

  • 2:重要资产

  • 1:一般资产

  • 0:测试资产

2

Lang

string

否

返回值语言,取值:

  • zh:中文

  • en:英文

默认:en

zh

LogicalExp

string

否

设置多个搜索条件间生效的逻辑关系。取值:

  • OR:表示多个条件间为或的关系。

  • AND:表示多个条件间为与的关系。

AND

MachineTypes

string

否

要查询的资产的类型。取值:

  • ecs:服务器

  • cloud_product:云产品

  • eci:弹性容器实例

  • rund:RunD 容器实例

  • runc:RunC 容器实例

ecs

NextToken

string

否

用于获取下一页结果的分页令牌。若无更多结果,则不返回此字段。

AAAAAZak7VOTMl2OSt/xmc4J6gbg4Z5eXuWnrvKgOsGARL76TVbKERXHXKNFurqjtfDdRw==

NoGroupTrace

boolean

否

默认分组未分组是否要做国际化处理。默认 false,取值:

  • true:不做国际化处理。即返回参数 GroupTrace 的取值为云安全中心的默认分组未分组时,未分组仍然显示为未分组。

  • false:需要国际化处理。即返回参数 GroupTrace 的取值为云安全中心的默认分组未分组时,未分组显示为 default。

true

PageSize

string

否

设置分页查询时,每页显示的资产的数量。默认值为 20,表示每页显示 20 条资产信息。

99

ResourceDirectoryAccountId

string

否

资源目录成员账号 ID。

说明

调用 DescribeMonitorAccounts 接口可以获取该参数。

1587359978118481

UseNextToken

boolean

否

是否使用 NextToken 方式拉取漏洞列表数据。如果使用此参数 TotalCount 不再返回。取值:

  • true:使用 NextToken 方式。

  • false:不使用 NextToken 方式。

true

返回参数

名称

类型

描述

示例值

object

返回参数

RequestId

string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

1B4C9A14-94E6-5EEB-BF39-7DACCE9AC0D6

Code

string

接口调用状态

200

Message

string

错误信息。

successful

Success

boolean

请求是否成功。

true

Data

object

实例详情列表。

Body

object

消息体内容经过 Base 64 算法加密后的字符串。

RequestId

string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

20EBDE7B-AA36-5D60-9DCA-151C48EDB9F8

Instances

array<object>

资产详细信息列表。

object

资产详细信息。

AlarmStatus

string

镜像是否存在安全告警。取值:

  • YES:存在安全告警

  • NO:不存在安全告警

NO

AppId

string

应用 ID

说明

该数据仅当 Vendor 为 9 时可存在。

FC2U0JVHWS49S2OT

AppName

string

应用名称

说明

该数据仅当 Vendor 为 9 时可存在。

guokent

AssetType

string

资产的类型。取值:

  • 0:云服务器

  • 1:负载均衡

  • 2:NAT 网关

  • 3:RDS 数据库

  • 4:MongoDb 数据库

  • 5:REDIS 数据库

  • 6:容器镜像

  • 7:容器

1

AssetTypeName

string

资产的类型名称。

负载均衡

AuthModifyTime

integer

资产的授权绑定时间戳。单位:毫秒。

说明

请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。

1627974044000

AuthVersion

integer

资产的授权版本。取值:

  • 1:免费版(未授权)

  • 6:防病毒版

  • 5:高级版

  • 3:企业版

  • 7:旗舰版

5

AuthVersionName

string

资产的授权版本(具体名称)。取值:

  • 免费版

  • 防病毒版

  • 高级版

  • 企业版

  • 旗舰版

免费版

Bind

boolean

资产是否已绑定授权。取值:

  • true:已绑定授权

  • false:未绑定授权

true

BindFileProtectType

string

是否绑定防篡改授权。取值:

  • block:是

  • none:否

none

ClientStatus

string

实例的客户端在线状态。取值:

  • online:在线,表示资产的 Agent 客户端状态为开启。

  • offline:离线,表示资产的 Agent 客户端状态为关闭。

  • pause:暂停,表示资产的 Agent 客户端状态为暂停保护。

online

ClientSubStatus

string

实例的客户端子状态。取值:

  • online:在线,表示资产的 Agent 客户端状态为开启。

  • offline:离线,表示资产的 Agent 客户端状态为关闭。

  • pause:暂停,表示资产的 Agent 客户端状态为暂停保护。

  • uninstalled:未安装,表示资产的 Agent 客户端状态为未安装。

  • stopped:服务器关机,表示资产的 Agent 客户端状态服务器关机。

online

ClusterId

string

资源组所在的集群 ID。

cb703cb0ba6bd40d4a6d8de5bff050fb9

ClusterName

string

集群名称

auto-cn-heyuan

Cores

integer

资产的 CPU 核数。

9

CpuInfo

string

资产的 CPU 信息。

Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz

CreatedTime

integer

集群创建的时间戳,单位为毫秒。

1607365213000

ExposedStatus

integer

资产暴露状态。取值:

  • 0: 未暴露

  • 1: 已暴露

0

Flag

integer

资产厂商。多个资产厂商之间使用半角逗号(,)分隔。取值:

  • 0:阿里云资产

  • 1:云外资产

  • 2:IDC 资产

  • 3、4、5、7、14、16:其它云资产

  • 8:轻量级资产

  • 9:SAE

  • 10:PAI

0

FlagName

string

资产厂商。取值:

  • ALIYUN

  • OUT

  • IDC

  • Tencent

  • HUAWEICLOUD

  • Azure

  • AWS

  • ASK

  • TRIPARTITE

  • SAE

  • PAI

  • google

  • VOLCENGINE

ALIYUN

GroupId

integer

实例所属分组 ID。

86d30f8b0e124aadb7ef3197f9dbd1f5

GroupTrace

string

资产所在的分组的名称。

default

HasContainer

string

是否含有容器。取值:

  • YES:有。

  • NO:无。

YES

HcStatus

string

实例是否检测出了基线风险项。取值:

  • YES:检测出了基线风险项

  • NO:未检测出基线风险项

YES

HealthCheckCount

integer

实例中存在的基线风险数量。

1

Importance

integer

设置资产重要性。取值:

  • 2:重要资产

  • 1:一般资产

  • 0:测试资产

2

InstanceId

string

实例 id

ls-cn-tl32rf**008

InstanceName

string

实例名称。

ra-supabase-22u1iv3hr**5v9

InternetIp

string

关联实例的公网 IP。

47.1**.52.125

IntranetIp

string

当前服务器的私网 IP 地址。

172.16.1**.245

Ip

string

管控 IP

114.55.*4.*6

IpListString

string

系统的 IP 列表。

172.31.XX.XX,172.171.XX.XX

Kernel

string

内核版本信息。

3.10.0-1127.19.1.el7.x86_64

LastLoginTimestamp

integer

客户端最后上线的时间戳。单位为毫秒。

1637592907000

MacListString

string

系统的 Mac 地址。

00:13:3e:31:13:39,02:12:67:b8:**:**

Mem

string

内存总量,单位为 MB。

1024

Namespace

string

命名空间。

slsshpcorlsmetrics

Os

string

实例的操作系统。取值:

  • linux:linux

  • windows:windows

linux

OsName

string

实例的内核版本。

AliOS7U2-x86-64

PodCount

integer

容器组个数。

8

PostPaidFlag

integer

当前资产绑定的防护版本计费方式。取值:

  • 0:包年包月

  • 1:按量付费

1

Region

string

实例所属地域 ID。

cn-hangzhouxxxx

RegionId

string

资产所在的地域的 ID。

cn-zhangjiakou

RegionName

string

地域名称。

cn-shanghai

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 }

RiskStatus

string

是否存在风险 。取值:

  • NO:无风险

  • YES:有风险

NO

SafeEventCount

string

资产存在的安全告警数量。

5

ServiceId

string

服务 ID,仅实例为 Serverless 实例,且归属于 PAI 平台时有值。

dsw-76jlywunsif09bp15p

Status

string

实例的运行状态。取值:

  • Running:运行中。

  • notRunning:已关机。

Running

Tag

string

资产实例的标签名称。

pre_20250714_idpt_adjust

TagId

string

资产的标签 ID。

d8586ab8be4549e3815995858d277763

TagResources

string

灵骏节点自定义标签,当机器是灵骏机器时才会返回值。

app:test,type:lingjun

Uuid

string

终端设备 UUID。

1f0459ee-ed49-6484-8958-4f10f61e6362

Vendor

integer

资产厂商。取值:

  • 0:阿里云资产

  • 1:云外资产

  • 2:IDC 资产

  • 3、4、5、7、14、16:其它云资产

  • 8:轻量级资产

  • 9:SAE

  • 10:PAI

0

VendorName

string

资产的服务商名称。

  • 取值:

  • ALIYUN:阿里云

  • OUT:云外资产

  • IDC:IDC

  • TENCENT:其它云

  • HUAWEICLOUD:其它云

  • Microsoft:其它云

  • AWS:其它云

  • TRIPARTITE:轻量级服务器

  • SAE:SAE

  • PAI:PAI

  • VOLCENGINE:其它云

  • google:其它云

IDC

VendorUid

string

多云实例的账号 ID。

123

VendorUserName

string

多云实例的账号名称。

VendorUserName

VpcInstanceId

string

实例所属 VPC 的 ID。

vpc-2zek7v0z4r6lbp02xckei

VulCount

integer

实例上存在的漏洞数量。

2

VulStatus

string

实例是否存在漏洞。取值:

  • YES:存在漏洞。

  • NO:不存在漏洞。

YES

PageInfo

object

驱动数量。

Count

integer

总数。

7

CurrentPage

integer

分页查询时,每页最大行数。

1

NextToken

string

使用 NextToken 方式下返回的 NextToken 值。

m1NGAAAAAABzLzIwMjQwMg==

PageSize

integer

每页返回记录数。

10

TotalCount

integer

总记录数。

0

Success

boolean

是否调用成功:true:调用成功。 false:调用失败。

True

示例

正常返回示例

JSON格式

{
  "RequestId": "1B4C9A14-94E6-5EEB-BF39-7DACCE9AC0D6",
  "Code": "200",
  "Message": "successful",
  "Success": true,
  "Data": {
    "Body": {
      "RequestId": "20EBDE7B-AA36-5D60-9DCA-151C48EDB9F8",
      "Instances": [
        {
          "AlarmStatus": "NO",
          "AppId": "FC2U0JVHWS49S2OT",
          "AppName": "guokent",
          "AssetType": "1",
          "AssetTypeName": "负载均衡",
          "AuthModifyTime": 1627974044000,
          "AuthVersion": 5,
          "AuthVersionName": "免费版",
          "Bind": true,
          "BindFileProtectType": "none",
          "ClientStatus": "online",
          "ClientSubStatus": "online",
          "ClusterId": "cb703cb0ba6bd40d4a6d8de5bff050fb9",
          "ClusterName": "auto-cn-heyuan",
          "Cores": 9,
          "CpuInfo": "Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz",
          "CreatedTime": 1607365213000,
          "ExposedStatus": 0,
          "Flag": 0,
          "FlagName": "ALIYUN",
          "GroupId": 0,
          "GroupTrace": "default",
          "HasContainer": "YES",
          "HcStatus": "YES",
          "HealthCheckCount": 1,
          "Importance": 2,
          "InstanceId": "ls-cn-tl32rf**008",
          "InstanceName": "ra-supabase-22u1iv3hr**5v9",
          "InternetIp": "47.1**.52.125",
          "IntranetIp": "172.16.1**.245",
          "Ip": "114.55.*4.*6",
          "IpListString": "172.31.XX.XX,172.171.XX.XX",
          "Kernel": "3.10.0-1127.19.1.el7.x86_64",
          "LastLoginTimestamp": 1637592907000,
          "MacListString": "00:13:3e:31:13:39,02:12:67:b8:**:**",
          "Mem": "1024",
          "Namespace": "slsshpcorlsmetrics",
          "Os": "linux",
          "OsName": "AliOS7U2-x86-64",
          "PodCount": 8,
          "PostPaidFlag": 1,
          "Region": "cn-hangzhouxxxx",
          "RegionId": "cn-zhangjiakou",
          "RegionName": "cn-shanghai",
          "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}",
          "RiskStatus": "NO",
          "SafeEventCount": "5",
          "ServiceId": "dsw-76jlywunsif09bp15p",
          "Status": "Running",
          "Tag": "pre_20250714_idpt_adjust",
          "TagId": "d8586ab8be4549e3815995858d277763",
          "TagResources": "app:test,type:lingjun",
          "Uuid": "1f0459ee-ed49-6484-8958-4f10f61e6362",
          "Vendor": 0,
          "VendorName": "IDC",
          "VendorUid": "123",
          "VendorUserName": "VendorUserName",
          "VpcInstanceId": "vpc-2zek7v0z4r6lbp02xckei",
          "VulCount": 2,
          "VulStatus": "YES"
        }
      ],
      "PageInfo": {
        "Count": 7,
        "CurrentPage": 1,
        "NextToken": "m1NGAAAAAABzLzIwMjQwMg==",
        "PageSize": 10,
        "TotalCount": 0
      },
      "Success": true
    }
  }
}

错误码

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

变更历史

更多信息,参考变更详情。