调用DescribeRiskLevels接口获取数据识别的风险等级列表。

使用说明

本接口用于获取当前使用模板的数据识别风险等级列表,便于掌握当前模板各风险等级的规则引用数量及最大风险等级。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用将会被限流,这可能影响您的业务,请合理调用。

调试

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

请求参数

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

系统规定参数。取值:DescribeRiskLevels。

Lang String zh_cn

指定请求和接收消息的语言类型。取值:

  • zh_cn:默认值,中文。
  • en_us:英文。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RequestId String 136082B3-B21F-5E9D-B68E-991FFD205D24

返回结果的请求ID。

RiskLevelList Array of RiskLevel

风险等级列表。

Description String 1级敏感数据

风险等级描述,您可以自定义描述。

风险等级名称和默认风险等级描述的映射关系如下:

  • NA:未识别到敏感数据
  • S1:1级敏感数据
  • S2:2级敏感数据
  • S3:3级敏感数据
  • S4:4级敏感数据
  • S5:5级敏感数据
  • S6:6级敏感数据
  • S7:7级敏感数据
  • S8:8级敏感数据
  • S9:9级敏感数据
  • S10:10级敏感数据
Id Long 2

风险等级的唯一标志ID,取值范围1~11。每个风险等级ID都有对应的风险等级名称,例如,风险等级ID为2对应风险等级S1。

具体映射关系,请参见Name参数的描述。

Name String S1

识别出的敏感数据风险等级名称。最大风险等级与分类分级模板有关,最大风险等级为S10。

内置阿里巴巴及蚂蚁集团数据安全分类分级模版的最大风险等级为S4,内置金融分类分级模版(参考JRT 0197-2020 金融数据安全数据安全分级指南)内置能源分类分级标准的最大风险等级为S5。如果为复制出来的模板,则最大风险等级为S10。

风险等级名称和ID的映射关系如下:

  • NA:1
  • S1:2
  • S2:3
  • S3:4
  • S4:5
  • S5:6
  • S6:7
  • S7:8
  • S8:9
  • S9:10
  • S10:11
ReferenceNum Integer 20

风险等级在模板中的引用次数,默认值为0。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeRiskLevels
&<公共请求参数>

正常返回示例

XML格式

<DescribeRiskLevelsResponse>
  <RequestId>136082B3-B21F-5E9D-B68E-991FFD205D24</RequestId>
  <RiskLevelList>
        <Description>未识别到敏感数据</Description>
        <Id>1</Id>
        <ReferenceNum>0</ReferenceNum>
        <Name>N/A</Name>
  </RiskLevelList>
  <RiskLevelList>
        <Description>1级敏感数据</Description>
        <Id>2</Id>
        <ReferenceNum>9</ReferenceNum>
        <Name>S1</Name>
  </RiskLevelList>
  <RiskLevelList>
        <Description>2级敏感数据</Description>
        <Id>3</Id>
        <ReferenceNum>22</ReferenceNum>
        <Name>S2</Name>
  </RiskLevelList>
  <RiskLevelList>
        <Description>3级敏感数据</Description>
        <Id>4</Id>
        <ReferenceNum>18</ReferenceNum>
        <Name>S3</Name>
  </RiskLevelList>
  <RiskLevelList>
        <Description>4级敏感数据</Description>
        <Id>5</Id>
        <ReferenceNum>0</ReferenceNum>
        <Name>S4</Name>
  </RiskLevelList>
</DescribeRiskLevelsResponse>

JSON格式

{
    "DescribeRiskLevelsResponse": {
        "RequestId": "136082B3-B21F-5E9D-B68E-991FFD205D24",
        "RiskLevelList": [
            {
                "Description": "未识别到敏感数据",
                "Id": 1,
                "ReferenceNum": 0,
                "Name": "N/A"
            },
            {
                "Description": "1级敏感数据",
                "Id": 2,
                "ReferenceNum": 9,
                "Name": "S1"
            },
            {
                "Description": "2级敏感数据",
                "Id": 3,
                "ReferenceNum": 22,
                "Name": "S2"
            },
            {
                "Description": "3级敏感数据",
                "Id": 4,
                "ReferenceNum": 18,
                "Name": "S3"
            },
            {
                "Description": "4级敏感数据",
                "Id": 5,
                "ReferenceNum": 0,
                "Name": "S4"
            }
        ]
    }
}

错误码

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