获取云产品资产列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-sas:ListCloudAssetInstances |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
实例所在的地域的 ID。 |
cn-hangzhou |
| Criteria |
string |
否 |
设置搜索资产的条件。该参数 JSON 格式，包含以下字段：
说明
您可以调用 GetCloudAssetCriteria 接口查询支持的搜索条件。 |
[{\"name\":\"internetIp\",\"value\":\"192.168\",\"logicalExp\":\"OR\"}] |
| LogicalExp |
string |
否 |
设置多个搜索条件间生效的逻辑关系。取值：
|
OR |
| PageSize |
integer |
否 |
每页最多可显示的行数，最大值为 100，默认值为 20。 |
20 |
| CurrentPage |
integer |
否 |
分页查询时，显示的当前页的页码。 |
2 |
| CloudAssetTypes |
array<object> |
否 |
云资产实例的资产列表。 |
|
|
object |
否 |
云资产实例的资产。 |
||
| AssetType |
integer |
否 |
云资产的类型。 说明
具体含义参考接口 GetCloudAssetCriteria AssetType。 |
18 |
| AssetSubType |
integer |
否 |
云产品的子类型。 说明
具体含义参考接口 GetCloudAssetCriteria AssetSubType。 |
0 |
| Vendor |
integer |
否 |
服务器厂商。取值：
|
0 |
| CloudAssetQueryData |
array<object> |
否 |
根据关键字查询数据列表。 |
|
|
object |
否 |
|||
| Data |
string |
否 |
查询内容。 |
163.8.8.9 |
| Operator |
string |
否 |
查询操作符，目前仅支持：INCLUDE。 |
INCLUDE |
| IsSaleData |
boolean |
否 |
是否返回售卖相关数据。取值：
|
|
| ResourceDirectoryAccountId |
integer |
否 |
资源目录成员账号主账号 ID。 说明
调用 DescribeMonitorAccounts 接口可以获取该参数。 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Success |
boolean |
接口调用是否成功。取值：
|
true |
| RequestId |
string |
本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。 |
028CF634-5268-5660-9575-48C9ED6BF880 |
| PageInfo |
object |
分页信息。 |
|
| CurrentPage |
integer |
分页查询时，当前页的页码。 |
2 |
| PageSize |
integer |
分页大小。 |
100 |
| TotalCount |
integer |
云资产总数。 |
69 |
| Count |
integer |
当前页显示的数据条数。 |
20 |
| Instances |
array<object> |
云资产详细信息列表。 |
|
|
object |
云资产详细信息。 |
||
| RegionId |
string |
资产实例所属区域 id。 |
cn-hanghzou |
| Vendor |
integer |
资产厂商。取值：
|
0 |
| AssetType |
integer |
资产的类型。取值：
|
0 |
| AssetSubType |
string |
云产品的子类型。 资产的类型-子类型。取值：
|
0 |
| InstanceId |
string |
云资产实例 id。 |
d-uf60vevzkztnflx7cny5 |
| InstanceName |
string |
资产的实例名称。 |
yztest-l*** |
| CreatedTime |
integer |
实例创建时间。采用 Unix 时间戳，单位为毫秒。 |
1607365213000 |
| InternetIp |
string |
实例的公网 IP 地址。 |
1.2.XX.XX |
| AlarmStatus |
string |
云资产是否存在安全告警。取值：
|
NO |
| RiskStatus |
string |
云资产是否存在安全风险。取值：
|
NO |
| AssetTypeName |
string |
云资产类型名称。 |
ECS |
| AssetSubTypeName |
string |
云资产的子类型名称。 |
SECURITY_GROUP |
| SecurityInfo |
string |
云资产的安全信息。 |
{"seriousNum":0,"appNum":0,"baselineMedium":0,"remindNum":0,"imageVulNntf":0,"cveNum":0,"vul":0,"uuid":"yuejia-test","emgNum":0,"weakPWNum":0,"imageMaliciousFileRemind":0,"imageBaselineMedium":0,"laterVulCount":0,"cmsNum":0,"imageMaliciousFileSerious":0,"agentlessMalicious":0,"suspNum":0,"imageBaselineHigh":0,"asapVulCount":0,"imageVulLater":0,"agentlessAll":0,"sysNum":0,"containerLater":0,"containerSuspicious":0,"imageBaselineNum":0,"newSuspicious":0,"nntfVulCount":0,"scaNum":0,"containerNntf":0,"health":0,"trojan":0,"suspicious":0,"imageMaliciousFileSuspicious":0,"containerRemind":0,"baselineLow":0,"imageVulAsap":0,"imageBaselineLow":0,"containerAsap":0,"agentlessBaseline":0,"agentlessVulSca":0,"agentlessVulCve":0,"containerSerious":0,"baselineHigh":0,"account":0,"baselineNum":5} |
| Tags |
array |
标签列表。 |
|
|
string |
标签。 |
AI |
|
| VendorUid |
string |
多云实例的账号 ID。 |
123xxx |
| VendorUserName |
string |
多云实例的用户名称。 |
testxxx |
| SaleCspm |
integer |
CSPM 售卖标识。 |
0 |
| AssetUuid |
string |
资产的 UUID。 |
|
| SaleType |
integer |
售卖类型。 |
0 |
示例
正常返回示例
JSON格式
{
"Success": true,
"RequestId": "028CF634-5268-5660-9575-48C9ED6BF880",
"PageInfo": {
"CurrentPage": 2,
"PageSize": 100,
"TotalCount": 69,
"Count": 20
},
"Instances": [
{
"RegionId": "cn-hanghzou",
"Vendor": 0,
"AssetType": 0,
"AssetSubType": "0",
"InstanceId": "d-uf60vevzkztnflx7cny5",
"InstanceName": "yztest-l***",
"CreatedTime": 1607365213000,
"InternetIp": "1.2.XX.XX",
"AlarmStatus": "NO",
"RiskStatus": "NO",
"AssetTypeName": "ECS",
"AssetSubTypeName": "SECURITY_GROUP",
"SecurityInfo": "{\"seriousNum\":0,\"appNum\":0,\"baselineMedium\":0,\"remindNum\":0,\"imageVulNntf\":0,\"cveNum\":0,\"vul\":0,\"uuid\":\"yuejia-test\",\"emgNum\":0,\"weakPWNum\":0,\"imageMaliciousFileRemind\":0,\"imageBaselineMedium\":0,\"laterVulCount\":0,\"cmsNum\":0,\"imageMaliciousFileSerious\":0,\"agentlessMalicious\":0,\"suspNum\":0,\"imageBaselineHigh\":0,\"asapVulCount\":0,\"imageVulLater\":0,\"agentlessAll\":0,\"sysNum\":0,\"containerLater\":0,\"containerSuspicious\":0,\"imageBaselineNum\":0,\"newSuspicious\":0,\"nntfVulCount\":0,\"scaNum\":0,\"containerNntf\":0,\"health\":0,\"trojan\":0,\"suspicious\":0,\"imageMaliciousFileSuspicious\":0,\"containerRemind\":0,\"baselineLow\":0,\"imageVulAsap\":0,\"imageBaselineLow\":0,\"containerAsap\":0,\"agentlessBaseline\":0,\"agentlessVulSca\":0,\"agentlessVulCve\":0,\"containerSerious\":0,\"baselineHigh\":0,\"account\":0,\"baselineNum\":5}",
"Tags": [
"AI"
],
"VendorUid": "123xxx",
"VendorUserName": "testxxx",
"SaleCspm": 0,
"AssetUuid": "",
"SaleType": 0
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | AccountIdNotExist | AccountId not exist | 账户不存在，请检查您的账户信息是否正确。 |
| 400 | NoPermission | no permission | 无此服务的访问权限。 |
| 400 | RdCheckNoPermission | Resource directory account verification has no permission. | 资源目录账号校验无权限。 |
| 500 | ServerError | ServerError | 服务故障，请稍后重试！ |
| 500 | RdCheckInnerError | Resource directory account service internal error. | 资源目录账号服务内部错误。 |
| 403 | NoPermission | caller has no permission | 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。