获取云产品资产列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| 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 |
返回参数
示例
正常返回示例
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}"
}
]
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | AccountIdNotExist | AccountId not exist | 账户不存在，请检查您的账户信息是否正确。 |
| 400 | NoPermission | no permission | 无此服务的访问权限。 |
| 403 | NoPermission | caller has no permission | 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。 |
| 500 | ServerError | ServerError | 服务故障，请稍后重试！ |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2023-09-20 | OpenAPI 错误码发生变更 | 查看变更详情 |