
# 创建加密脱敏配置 - AddEncryptConfig
#### 功能介绍
添加新的加密脱敏配置信息
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前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                                                    | 密钥轮换周期（天）                                                                                                             |
   
 表3KmsContext 
| 参数            | 是否必选 | 参数类型   | 描述         |
|:---|:---|:---|:---|
| 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 | 资源未找到 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。
