调用GetOpRiskData,获取租户下所有DataWorks工作空间指定日期中有风险的敏感数据访问记录。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetOpRiskData

要执行的操作。

Date String 20210221

获取访问记录的日期。格式为:yyyyMMdd。

PageNo Integer 1

页码数,最小值为1。

PageSize Integer 100

每页返回的数据量,最大值为1000。

RegionId String cn-shenzhen

地域信息,通常为服务所在的地域。例如,华东2(上海)为cn-shanghai,华北3(张家口)为cn-zhangjiakou。您无需填写RegionId,会根据调用的Endpoint自动解析。

Name String [ {"dbType":"hologres","instanceName":"ABC","databaseName":"abc"}, {"dbType":"odps","projectName":"adbc"} ]

获取访问记录的条件设置。可选的参数如下:

  • dbType:数据类型。
  • instanceName:实例名称。
  • databaseName:数据库名称。
  • projectName:项目名称。
  • clusterName:集群名称。

示例获取Hologres中ABC实例的abc数据库的敏感数据访问记录:

{"dbType":"hologres","instanceName":"ABC","databaseName":"abc"}

实际使用时,您需要根据业务使用的引擎进行配置。

RiskType String 手工识别

指通过什么方式识别风险类型。取值如下:

  • 手工识别。
  • 风险规则名称,您可以进入DataWorks的数据保护伞,在风险识别管理页面获取。

返回数据

名称 类型 示例值 描述
RequestId String 0000-ABCD-EFG****

请求ID,一次请求的唯一标识。

RiskData String { "opRiskDatas": [ { "riskType": "分级维度,EMR引擎维度and项目维度,EMR引擎项目维度的操作数据,导出方式维度,EMR引擎", "opTime": "2021-01-04 23:39:13", "opType": "SQL_SELECT", "opAccount": "user", "sensType": "邮箱/姓名/手机号", "sql": "SELECT * FROM default.jiade_1219_test_create LIMIT 20" } ], "totalCount": 499 }

返回的有风险的敏感数据信息。包括totalCount(敏感数据总条数)和opRiskDatas(风险数据列表)。

其中opRiskDatas(风险数据列表)包括:

  • sensType:敏感类型。
  • sensLevel:敏感级别。
  • opType:操作类型。
  • sql:操作执行的sql语句。
  • opAccount:执行操作的账号。
  • opTime:执行操作的时间。

示例

请求示例

http(s)://[Endpoint]/?Action=GetOpRiskData
&Date=20210221
&PageNo=1
&PageSize=100
&RegionId=cn-shenzhen
&<公共请求参数>

正常返回示例

XML格式

<RequestId>0000-ABCD-EFG****</RequestId>
<RiskData>{     "opRiskDatas": [       {         "riskType": "分级维度,EMR引擎维度and项目维度,EMR引擎项目维度的操作数据,导出方式维度,EMR引擎",         "opTime": "2021-01-04 23:39:13",         "opType": "SQL_SELECT",         "opAccount": "user",         "sensType": "邮箱/姓名/手机号",         "sql": "SELECT * FROM default.jiade_1219_test_create LIMIT 20"       }     ],     "totalCount": 499   }</RiskData>

JSON格式

{
    "RequestId": "0000-ABCD-EFG****",
    "RiskData": "{     \"opRiskDatas\": [       {         \"riskType\": \"分级维度,EMR引擎维度and项目维度,EMR引擎项目维度的操作数据,导出方式维度,EMR引擎\",         \"opTime\": \"2021-01-04 23:39:13\",         \"opType\": \"SQL_SELECT\",         \"opAccount\": \"user\",         \"sensType\": \"邮箱/姓名/手机号\",         \"sql\": \"SELECT * FROM default.jiade_1219_test_create LIMIT 20\"       }     ],     \"totalCount\": 499   }"
}

错误码

HttpCode 错误码 错误信息 描述
403 Forbidden.NoTenant The tenant information cannot be obtained using user ID. 无法获取租户的信息。
400 Invalid.Param The request parameter is invalid. 请求参数错误。
500 InternalError.DQC.BizError An internal error occurred. 内部服务错误。

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