文档首页/ 数据安全中心 DSC/ API参考/ API说明/ 数据静态脱敏/ 创建加密脱敏配置 - AddEncryptConfig
更新时间：2026-01-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建加密脱敏配置 - AddEncryptConfig

功能介绍

添加新的加密脱敏配置信息

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/sdg/server/mask/algorithms/encryption-configurations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目唯一标识符

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

algorithm_name

否

String

加密脱敏算法的名称

algorithm_type

否

String

加密脱敏算法的类型，可选值：SHA256、SHA512、PRESNM、MASKNM、PRESXY、MASKXY、SYMBOL、KEYWORD、NULL、EMPTY、DATE、NUMERIC、AES、EMBED、SM4、DECRYPT。

encrypt_mode

否

String

加密模式，长度1-256。

filling_method

否

String

填充方法，用于加密脱敏处理

key_len

否

Integer

密钥长度

kms_context

否

KmsContext object

密钥管理服务（KMS）上下文信息

rotate_period

否

Integer

密钥轮换周期（天）
表3 KmsContext

参数

是否必选

参数类型

描述

kms_key_alias

否

String

KMS密钥的别名

kms_key_id

否

String

KMS密钥的唯一ID

kms_region

否

String

KMS服务所在的区域

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

msg

String

返回的消息内容，用于描述操作结果

status

String

返回的状态码，如'200'表示成功，'400'表示错误

状态码：201

资源创建

请求示例

POST /v1/{project_id}/sdg/server/mask/algorithms/encryption-configurations

{
  "algorithm_name" : "AES256",
  "algorithm_type" : "AES",
  "encrypt_mode" : "GCM",
  "filling_method" : "PKCS7",
  "key_len" : 128,
  "kms_context" : {
    "kms_region" : "cn-north-4",
    "kms_key_alias" : "KMS-a8af",
    "kms_key_id" : "a7187d26-xxxxxxxx-a6d68ccc202c"
  },
  "rotate_period" : 0
}

响应示例

无

状态码

状态码

描述

200

创建成功

201

资源创建

401

未授权

403

禁止访问

404

资源未找到

错误码

请参见错误码。

父主题： 数据静态脱敏