# 队列赋权（废弃）
#### 功能介绍
该API用于与其他用户共享指定的队列，可以给用户赋使用指定的队列的权限或者收回使用权限。
用户所属的用户组需要在所属区域内具有Tenant Guest权限。
关于Tenant Guest权限的介绍和开通方法，详细参见[权限策略](https://support.huaweicloud.com/usermanual-permissions/iam_01_0001.html)和《统一身份认证服务 用户指南》中的[创建用户组](https://support.huaweicloud.com/usermanual-iam/iam_03_0001.html)。
![](https://support.huaweicloud.com/api-dli/public_sys-resources/note_3.0-zh-cn.png)
当前接口已废弃，不推荐使用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DLI&api=RegisterAuthorizedQueue)中调试该接口。
#### URI
- URI格式： PUT /v1.0/{project_id}/queues/user-authorization
  
- 参数说明
  表1URI参数 
  | 参数名称       | 是否必选 | 参数类型   | 说明                                                                                     |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 |
     
  
 
#### 请求消息
表2请求参数 
| 参数名称       | 是否必选 | 参数类型             | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| queue_name | 是    | String           | 队列名称。示例值：queue1。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| user_name  | 是    | String           | 被赋权用户名称。给该用户赋使用队列的权限，回收其使用权限，或者更新其使用权限。示例值：tenant2。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| action     | 是    | String           | 指定赋权或回收。值为：grant，revoke或update。当用户同时拥有grant和revoke权限的时候才有权限使用update操作。示例值：grant。 - grant：赋权。  - revoke：回收权限。  - update：清空原来的所有权限，赋予本次提供的权限数组中的权限。                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| privileges | 是    | Array of Strings | 待赋权、回收或更新的权限列表。可操作的权限可以是以下权限中的一种或多种。示例值：\["DROP_QUEUE", "SUBMIT_JOB"\]。 - SUBMIT_JOB：提交作业  - CANCEL_JOB ：取消作业  - DROP_QUEUE ：删除队列  - GRANT_PRIVILEGE： 赋权  - REVOKE_PRIVILEGE：权限回收  - SHOW_PRIVILEGES：查看其它用户具备的权限  - RESTART：重启队列  - SCALE_QUEUE：规格变更 说明： 若需更新的权限列表为空，则表示回收用户在该队列的所有权限。    |
   
#### 响应消息
表3响应参数 
| 参数名称       | 是否必选 | 参数类型    | 说明                                |
|:---|:---|:---|:---|
| is_success | 否    | Boolean | 执行请求是否成功。"true"表示请求执行成功。示例值：true。 |
| message    | 否    | String  | 系统提示信息，执行成功时，信息可能为空。示例值：空         |
   
#### 请求示例
给用户赋予队列queue1提交作业、删除队列的权限。
```
{
    "queue_name": "queue1",
    "user_name": "tenant2",
    "action": "grant",
    "privileges" : ["DROP_QUEUE", "SUBMIT_JOB"]
}
```
#### 响应示例
```
{
  "is_success": true,
  "message": ""
}
```
#### 状态码
状态码如[表4]所示。
 表4状态码 
| 状态码 | 描述       |
|:---|:---|
| 200 | 授权成功。    |
| 400 | 请求错误。    |
| 500 | 内部服务器错误。 |
   
#### 错误码
调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。