DescribeCloudCenterInstances - sas-查询资产信息
sas-查询云安全中心实例列表
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
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,10,13 |
| Importance |
integer |
否 |
设置资产重要性。取值:
|
2 |
| Lang |
string |
否 |
返回值语言,取值:
默认:en |
zh |
| LogicalExp |
string |
否 |
设置多个搜索条件间生效的逻辑关系。取值:
|
AND |
| MachineTypes |
string |
否 |
要查询的资产的类型。取值:
|
ecs |
| NextToken |
string |
否 |
用于获取下一页结果的分页令牌。若无更多结果,则不返回此字段。 |
AAAAAZak7VOTMl2OSt/xmc4J6gbg4Z5eXuWnrvKgOsGARL76TVbKERXHXKNFurqjtfDdRw== |
| NoGroupTrace |
boolean |
否 |
默认分组未分组是否要做国际化处理。默认 false,取值:
|
true |
| PageSize |
string |
否 |
设置分页查询时,每页显示的资产的数量。默认值为 20,表示每页显示 20 条资产信息。 |
99 |
| ResourceDirectoryAccountId |
string |
否 |
资源目录成员账号 ID。 说明
调用 DescribeMonitorAccounts 接口可以获取该参数。 |
1587359978118481 |
| UseNextToken |
boolean |
否 |
是否使用 NextToken 方式拉取漏洞列表数据。如果使用此参数 TotalCount 不再返回。取值:
|
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 |
镜像是否存在安全告警。取值:
|
NO |
| AppId |
string |
应用 ID 说明
该数据仅当 Vendor 为 9 时可存在。 |
FC2U0JVHWS49S2OT |
| AppName |
string |
应用名称 说明
该数据仅当 Vendor 为 9 时可存在。 |
guokent |
| AssetType |
string |
资产的类型。取值:
|
1 |
| AssetTypeName |
string |
资产的类型名称。 |
负载均衡 |
| AuthModifyTime |
integer |
资产的授权绑定时间戳。单位:毫秒。 说明
请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。 |
1627974044000 |
| AuthVersion |
integer |
资产的授权版本。取值:
|
5 |
| AuthVersionName |
string |
资产的授权版本(具体名称)。取值:
|
免费版 |
| Bind |
boolean |
资产是否已绑定授权。取值:
|
true |
| BindFileProtectType |
string |
是否绑定防篡改授权。取值:
|
none |
| ClientStatus |
string |
实例的客户端在线状态。取值:
|
online |
| ClientSubStatus |
string |
实例的客户端子状态。取值:
|
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 |
| Flag |
integer |
资产厂商。多个资产厂商之间使用半角逗号(,)分隔。取值:
|
0 |
| FlagName |
string |
资产厂商。取值:
|
ALIYUN |
| GroupId |
integer |
实例所属分组 ID。 |
86d30f8b0e124aadb7ef3197f9dbd1f5 |
| GroupTrace |
string |
资产所在的分组的名称。 |
default |
| HasContainer |
string |
是否含有容器。取值:
|
YES |
| HcStatus |
string |
实例是否检测出了基线风险项。取值:
|
YES |
| HealthCheckCount |
integer |
实例中存在的基线风险数量。 |
1 |
| Importance |
integer |
设置资产重要性。取值:
|
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 |
| OsName |
string |
实例的内核版本。 |
AliOS7U2-x86-64 |
| PodCount |
integer |
容器组个数。 |
8 |
| PostPaidFlag |
integer |
当前资产绑定的防护版本计费方式。取值:
|
1 |
| Region |
string |
实例所属地域 ID。 |
cn-hangzhouxxxx |
| RegionId |
string |
资产所在的地域的 ID。 |
cn-zhangjiakou |
| RegionName |
string |
地域名称。 |
cn-shanghai |
| RiskCount |
string |
资产存在的风险项统计。JSON 格式,包含以下字段:
|
{ "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 |
| SafeEventCount |
string |
资产存在的安全告警数量。 |
5 |
| ServiceId |
string |
服务 ID,仅实例为 Serverless 实例,且归属于 PAI 平台时有值。 |
dsw-76jlywunsif09bp15p |
| Status |
string |
实例的运行状态。取值:
|
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 |
| VendorName |
string |
资产的服务商名称。
|
IDC |
| VendorUid |
string |
多云实例的账号 ID。 |
123 |
| VendorUserName |
string |
多云实例的账号名称。 |
VendorUserName |
| VpcInstanceId |
string |
实例所属 VPC 的 ID。 |
vpc-2zek7v0z4r6lbp02xckei |
| VulCount |
integer |
实例上存在的漏洞数量。 |
2 |
| VulStatus |
string |
实例是否存在漏洞。取值:
|
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
}
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。