# 批量设置definer - BatchSetDefiner
#### 功能介绍
批量设置Definer迁移是否迁移到该用户下。
- 选择是：迁移后，所有源数据库对象的Definer都会迁移至该用户下，其他用户需要授权后才具有数据库对象权限。
- 选择否：迁移后，将保持源数据库对象Definer定义不变，选择此选项，需要配合下一步用户权限迁移功能，将源数据库的用户全部迁移，这样才能保持源数据库的权限体系完全不变。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DRS&api=BatchSetDefiner)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 接口约束
任务状态为CONFIGURATION才能调用。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。
#### URI
POST /v3/{project_id}/jobs/batch-replace-definer
表1路径参数 
| **参数**     | **是否必选** | **参数类型** | **描述**                                                                                                                                              |
|:---|:---|:---|:---|
| project_id | 是        | String   | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 |
   
#### 请求参数
表2请求Header参数 
| **参数**       | **是否必选** | **参数类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| Content-Type | 是        | String   | 指定类型为application/json。 缺省值：**application/json**                                                                                                                                                                                                                                                                                                                                                      |
| X-Auth-Token | 是        | String   | 从IAM服务获取的用户Token。                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| X-Language   | 否        | String   | 请求语言类型。 缺省值：**en-us** 取值： - **en-us**  - **zh-cn**   |
   
表3请求Body参数 
| **参数** | **是否必选** | **参数类型**         | **描述**                                                                                                                                      |
|:---|:---|:---|:---|
| jobs   | 是        | Array of objects | 批量设置replaceDefiner请求列表。 详情请参见[表4]。 |
   
 表4jobs字段数据结构说明 
| **参数**          | **是否必选** | **参数类型** | **描述**                |
|:---|:---|:---|:---|
| job_id          | 是        | String   | 任务ID。                 |
| replace_definer | 是        | Boolean  | 是否使用目标库的用户替换掉definer。 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| **参数**  | **参数类型**         | **描述**                                                                                                                      |
|:---|:---|:---|
| count   | Integer          | 总数。                                                                                                                         |
| results | Array of objects | 批量修改任务返回列表。 详情请参见[表6]。 |
   
 表6results字段数据结构说明 
| **参数**     | **参数类型** | **描述**                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| id         | String   | 任务ID。                                                                                                                                                                                                                                                                                                                                  |
| status     | String   | 状态。取值： - **success**：成功。  - **failed**：失败。   |
| error_code | String   | 错误码。                                                                                                                                                                                                                                                                                                                                   |
| error_msg  | String   | 错误信息。                                                                                                                                                                                                                                                                                                                                  |
   
#### 请求示例
批量设置指定任务的definer
```
https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-replace-definer
{
  "jobs" : [ {
    "job_id" : "7c685701-bfb5-4bb9-89f1-d0567f5jb502",
    "replace_definer" : true
  } ]
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "count" : 1,
  "results" : [ {
    "id" : "7c685701-bfb5-4bb9-89f1-d0567f5jb502",
    "status" : "success"
  } ]
}
```
#### 状态码
| **状态码** | **描述**      |
|:---|:---|
| 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)。