获取左侧菜单栏各风险等级的资产 - ListRiskLevels
功能介绍
功能介绍:获取左侧菜单栏各风险等级的资产
查询参数:type、security_level_ids、security_group_ids、owner_account_id、owner_project_id(可选参数不传时使用默认值)。
响应:请求成功返回HTTP 200及响应体。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v2/{project_id}/data-map/risk-level
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,标识当前请求所属的华为云项目,可参考获取项目ID相关文档获取 约束限制: 满足正则匹配"^[a-z0-9]{32}$",32位小写字母和数字 取值范围: 长度为32个字符,只能由小写英文字母和数字组成 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| type | 否 | String | 参数解释: 标签类型,用于标识查询标签所属的类型类别,用于按类型筛选标签 约束限制: 满足正则匹配"^[\u4E00-\u9FA5\uF900-\uFA2D()()-_\w-]{1,255}$",1到255位中文字符、英文字母、数字及下划线、连字符 取值范围: 默认取值: 不涉及 |
| security_level_ids | 否 | Array of strings | 参数解释: 安全级别ID列表,数组元素为String类型,每个元素为一个安全级别ID,由英文字母和数字组成 约束限制: 满足正则匹配"^[\u4E00-\u9FA5\uF900-\uFA2D()()-_\w-]{1,255}$",1到255位中文字符、英文字母、数字及下划线、连字符 取值范围: 不涉及 默认取值: 不涉及 |
| security_group_ids | 否 | Array of strings | 参数解释: 安全分组ID列表,数组元素为String类型,每个元素为一个安全分组ID,由英文字母和数字组成 约束限制: 满足正则匹配"^[\u4E00-\u9FA5\uF900-\uFA2D()()-_\w-]{1,255}$",1到255位中文字符、英文字母、数字及下划线、连字符 取值范围: 不涉及 默认取值: 不涉及 |
| owner_account_id | 否 | String | 参数解释: 拥有者账号ID,标识数据资产所属的华为云账号,可通过IAM服务或控制台获取 约束限制: 满足正则匹配"^[a-z0-9]{32}$",32位小写字母和数字 取值范围: 不涉及 默认取值: 不涉及 |
| owner_project_id | 否 | String | 参数解释: 拥有者项目ID,标识数据资产所属的项目,可通过IAM服务或控制台获取 约束限制: 满足正则匹配"^[a-z0-9]{32}$",32位小写字母和数字 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值) 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| data_level | Array of DataLevelInfo objects | 参数解释: 概览等级信息列表,包含各风险等级的资产概览数据 取值范围: 不涉及 |
| total | Integer | 参数解释: 总记录数 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| level_id | String | 参数解释: 级别ID 取值范围: 不涉及 |
| level_name | String | 参数解释: 级别名称 取值范围: 不涉及 |
| level_color_number | Integer | 参数解释: 级别颜色编号,标识安全级别对应的展示颜色,格式为RGB颜色值 取值范围: 不涉及 |
| total | Integer | 参数解释: 总记录数 取值范围: 不涉及 |
| risk_list | Array of RiskListInfo objects | 参数解释: 风险列表 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | String | 参数解释: 风险类型 取值范围: 不涉及 |
| total | Integer | 参数解释: 总记录数 取值范围: 不涉及 |
| detail_list | Array of CommonInfo objects | 参数解释: 详情列表 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 资源ID,唯一标识 取值范围: 不涉及 |
| asset_name | String | 参数解释: 资产名称 取值范围: 不涉及 |
| asset_type | String | 参数解释: 资产类型,标识该资产所属的数据类型类别 取值范围: 不涉及 |
| ins_type | String | 参数解释: 实例类型,标识资产实例所属的类别 取值范围: |
| is_scaned | Boolean | 参数解释: 是否已扫描 取值范围: true-是,false-否 |
| is_authorized | Boolean | 参数解释: 是否已授权 取值范围: true-是,false-否 |
| scan_detail | ScanDetail object | 参数解释: 扫描详情 取值范围: 不涉及 |
| security_strategy | SecurityStrategy object | 参数解释: 安全策略 取值范围: 不涉及 |
| threat_analysis | ThreatAnalysis object | 参数解释: 威胁分析 取值范围: 不涉及 |
| vpc_id | String | 参数解释: 虚拟私有云ID 取值范围: 不涉及 |
| create_time | Long | 参数解释: 创建时间 取值范围: 不涉及 |
| is_ignored | Boolean | 参数解释: 是否已忽略 取值范围: true-是,false-否 |
| asset_score | Double | 参数解释: 资产评分 取值范围: 不涉及 |
| owner_account_id | String | 参数解释: 拥有者账号ID 取值范围: 不涉及 |
| owner_project_id | String | 参数解释: 拥有者项目ID,标识资源所属的项目 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| object_num | Integer | 参数解释: 扫描对象数量,表示扫描作业处理的对象个数 取值范围: 不涉及 |
| sensitive_object_num | Integer | 参数解释: 敏感对象数量 取值范围: 不涉及 |
| security_level_name | String | 参数解释: 安全等级名称 取值范围: 不涉及 |
| security_level_id | String | 参数解释: 安全等级ID,标识一个安全等级 取值范围: 不涉及 |
| security_level_color | Integer | 参数解释: 安全等级颜色,标识安全等级对应的展示颜色,格式为RGB颜色值 取值范围: 不涉及 |
| scan_template_id | String | 参数解释: 扫描模板ID,标识一个扫描模板 取值范围: 不涉及 |
| scan_template_name | String | 参数解释: 扫描模板名称 取值范围: 不涉及 |
| last_scan_time | Long | 参数解释: 最近扫描时间 取值范围: 不涉及 |
| job_id | String | 参数解释: 扫描任务ID,标识一个扫描作业,可通过创建扫描作业接口获取 取值范围: 不涉及 |
| scan_risk | String | 参数解释: 扫描风险等级 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| is_encrypt | Boolean | 参数解释: 是否加密 取值范围: true-是,false-否 |
| encrypt_level | String | 参数解释: 加密等级 取值范围: |
| access_strategy | String | 参数解释: 访问策略 取值范围: 不涉及 |
| access_strategy_level | String | 参数解释: 访问策略等级 取值范围: |
| https_enable | Boolean | 参数解释: 是否启用HTTPS 取值范围: true-是,false-否 |
| https_level | String | 参数解释: HTTPS安全等级,标识该资源HTTPS安全策略的评估等级 取值范围: |
| disk_encrypted_enable | Boolean | 参数解释: 是否启用磁盘加密 取值范围: true-是,false-否 |
| disk_encrypted | String | 参数解释: 磁盘加密等级 取值范围: |
| authority_enable | Boolean | 参数解释: 是否启用鉴权 取值范围: true-是,false-否 |
| authority_level | String | 参数解释: 鉴权等级 取值范围: |
| backup_enable | Boolean | 参数解释: 是否启用备份 取值范围: true-是,false-否 |
| backup_level | String | 参数解释: 备份等级 取值范围: |
| public_network_enable | Boolean | 参数解释: 是否启用公网访问 取值范围: true-是,false-否 |
| public_network_access | String | 参数解释: 公网访问风险等级 取值范围: |
| ik_enable | String | 参数解释: IK密钥等级,标识IK(Internet Key Exchange)密钥安全策略的评估等级 取值范围: |
| security_group_level | String | 参数解释: 安全组等级 取值范围: |
| working_mode | String | 参数解释: 工作模式等级 取值范围: |
| working_type | String | 参数解释: 工作模式类型,标识资源所采用的工作模式 取值范围: 不涉及 |
| ssl_status | Boolean | 参数解释: SSL状态,用于标识是否开启SSL加密 取值范围: true-开启,false-关闭 |
| ssl_enabled | String | 参数解释: SSL启用等级 取值范围: |
| backup_and_restore | String | 参数解释: 备份恢复等级,标识该资源备份恢复安全策略的评估等级 取值范围: |
| data_volume_encrypt_enable | Boolean | 参数解释: 是否启用数据卷加密 取值范围: true-是,false-否 |
| data_volume_encrypt_level | String | 参数解释: 数据卷加密等级 取值范围: |
| obs_audit_status | Boolean | 参数解释: OBS审计状态,用于标识是否开启OBS审计 取值范围: true-开启,false-关闭 |
| obs_audit_level | String | 参数解释: OBS审计等级 取值范围: |
| dbss_audit_status | Boolean | 参数解释: DBSS审计状态 取值范围: true-开启,false-关闭 |
| dbss_audit_security_level | String | 参数解释: 数据库审计风险等级 取值范围: |
| total_risk | String | 参数解释: 总体风险等级 取值范围: |
| sslEnabled | Boolean | 参数解释: 是否启用SSL 取值范围: true-是,false-否 |
请求示例
获取左侧菜单栏各风险等级的资产
/v2/2b31ed5200000ebedb6e570000000000/data-map/risk-level
响应示例
状态码:200
{
"data_level" : [ {
"level_id" : "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"level_name" : "level-resource-01",
"level_color_number" : 1,
"total" : 1,
"risk_list" : [ {
"type" : "DATABASE",
"total" : 1,
"detail_list" : [ {
"id" : "f7e6d5c4-b3a2-1908-7f6e-5d4c3b2a1908",
"asset_name" : "asset-db-01",
"asset_type" : "DATABASE",
"ins_type" : "RDS",
"is_scaned" : true,
"is_authorized" : true,
"scan_detail" : {
"object_num" : 2,
"sensitive_object_num" : 2,
"security_level_name" : "security_level-resource-01",
"security_level_id" : "3a7b8c9d-0e1f-2a3b-4c5d-6e7f8a9b0c1d",
"security_level_color" : 1,
"scan_template_id" : "826314dd-1b5b-4037-b976-5f9b7a17df46",
"scan_template_name" : "scan_template-resource-01",
"last_scan_time" : 1700000000000,
"job_id" : "0cfd1d3e-2c4a-4d1f-8e2b-9a3c4d5e6f70",
"scan_risk" : "HIGH"
},
"security_strategy" : {
"is_encrypt" : true,
"encrypt_level" : "HIGH",
"access_strategy" : "asset-value-01",
"access_strategy_level" : "HIGH",
"https_enable" : true,
"https_level" : "HIGH",
"disk_encrypted_enable" : true,
"disk_encrypted" : true,
"authority_enable" : true,
"authority_level" : "HIGH",
"backup_enable" : true,
"backup_level" : "HIGH",
"public_network_enable" : true,
"public_network_access" : "HIGH",
"ik_enable" : true,
"security_group_level" : "HIGH",
"working_mode" : "HIGH",
"working_type" : "DATABASE",
"ssl_status" : true,
"ssl_enabled" : "HIGH",
"backup_and_restore" : "HIGH",
"data_volume_encrypt_enable" : true,
"data_volume_encrypt_level" : "HIGH",
"obs_audit_status" : true,
"obs_audit_level" : "HIGH",
"dbss_audit_status" : true,
"dbss_audit_security_level" : "HIGH",
"total_risk" : "HIGH"
},
"threat_analysis" : {
"sql_inject_level" : "HIGH",
"risky_operation_level" : "HIGH",
"abnormal_login_level" : "HIGH"
},
"vpc_id" : "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"create_time" : 1700000000000,
"is_ignored" : true,
"asset_score" : 95.5,
"owner_account_id" : "f7e6d5c4-b3a2-1908-7f6e-5d4c3b2a1908",
"owner_project_id" : "3a7b8c9d-0e1f-2a3b-4c5d-6e7f8a9b0c1d"
} ]
} ]
} ],
"total" : 1
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功 |
错误码
请参见错误码。