# 修改对象的列信息（列映射、列过滤） - ModifyColumnInfos #### 功能介绍 修改对象的列信息（列映射、列过滤） #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /v5/{project_id}/job/{job_id}/column-info-modification 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 | | job_id | 是 | String | 任务ID。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 否 | String | 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 | | X-Auth-Token | 是 | String | 从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。 | | X-Language | 否 | String | 请求语言类型。 枚举值： - **en-us** - **zh-cn** | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | column_map_infos | 是 | Array of objects | 列信息 详情请见[表 ColumnMappingInfo] | 表4ColumnMappingInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | object_id | 是 | String | 对象id | | column_info_lists | 是 | Array of objects | 列信息 详情请见[表 ColumnInfo] | 表5ColumnInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | column_name | 是 | String | 列名 | | column_type | 否 | String | 列类型 | | key_type | 否 | String | 列的键类型。 | | column_mapped_name | 否 | String | 列映射后的名称，映射列名不能重复。 | | status | 否 | Boolean | 该列是否过滤，主键列或唯一键列不能被过滤。 | | partition | 否 | Boolean | 该列是否partitionKey | | desensitization_algorithm | 否 | String | 列脱敏类型。 支持版本：内核版本26.4.0及以上 适用场景：目前仅支持Mysql-\>Mysql同步、Oracle-\>GaussDB集中式同步、Oracle-\>GaussDB分布式同步场景。此外，不支持对主键和唯一键脱敏。 取值范围： - **NAME**：姓名中间遮盖。 - **PHONE**：电话中间遮盖。 - **IDENTITY_CARD**：证件号码中间遮盖。 - **BANK_CARD**：银行卡号中间遮盖。 - **EMAIL**：邮箱前缀首字母后遮盖。 - **ADDRESS**：地址后缀遮盖。 - **DATE**：仅保留年代日期替换为1月1日。 - **NUMERIC**：数字变0。 - **SECRET_CONTENT**：大段文本全替换。 | #### 响应参数 **状态码：200** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | modify_result | Boolean | 修改结果 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | #### 请求示例 修改对象的列信息 ``` https://{endpoint}/v5/5237e10fe9aa4ad5b16b6a5245248314/jobs/fc77e18b-21c8-4040-96b5-ae599d3jb201/column-info-modification { "column_map_infos" : [ { "column_info_lists" : [ { "status" : true, "partition" : false, "column_name" : "id1", "column_type" : "int(11)", "key_type" : "PRI", "column_mapped_name" : "id1-new" }, { "status" : true, "partition" : false, "column_name" : "id2", "column_type" : "int(11)", "key_type" : "", "column_mapped_name" : "" } ], "object_id" : "db1-*-*-tt1" } ] } ``` #### 响应示例 **状态码：200** OK ``` { "modify_result" : true } ``` **状态码：400** Bad Request ``` { "error_code" : "DRS.10000001", "error_msg" : "Failed." } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | 其他状态请参见[状态码](https://support.huaweicloud.com/api-drs/drs_api_0108.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-drs/drs_05_0004.html)。