# obs_acl_grant
 表1obs_acl_grant 
| **参数名称**                  | **参数类型**                                                 | **是否必选** | **描述**                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| grantee_type              | [obs_grantee_type]     | 必选       | **参数解释：** 授权者类型描述。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                                              |
| grantee.canonical_user.id | char\[\]                                                 | 可选       | **参数解释：** 被授权用户的ID，即user_id。 **约束限制：** 无 **取值范围：** 如何获取被授权用户的ID请参见[如何获取账号ID和用户ID？](https://support.huaweicloud.com/sdk-c-devg-obs/obs_23_1712.html) **默认取值：** 无        |
| permission                | [obs_permission]            | 必选       | **参数解释：** 桶ACL。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                                            |
| bucket_delivered          | [obs_bucket_delivered] | 必选       | **参数解释：** 桶的ACL是否向桶内对象传递。 **约束限制：** 无 **取值范围：** 可详见[obs_bucket_delivered]。 **默认取值：** BUCKET_DELIVERED_FALSE（指对象ACL不继承桶的ACL） |
   
 表2obs_grantee_type 
| **枚举值**                         | **说明**                                                                                       |
|:---|:---|
| OBS_GRANTEE_TYPE_CANONICAL_USER | OBS用户，桶或对象的权限可以授予任何拥有OBS 账户的用户，被授权后对应的 OBS 用户可以使用AK和SK访问OBS。 |
| OBS_GRANTEE_TYPE_ALL_USERS      | 所有OBS用户（已认证用户），所有OBS用户都可以访问对应的桶或对象，包括匿名用户。                                                   |
   
 表3obs_permission 
| **常量名**                     | **原始值**      | **说明**                                                                                                         |
|:---|:---|:---|
| OBS_PERMISSION_READ         | READ         | 读权限，如果有桶的读权限，则可以获取该桶内对象列表和桶的元数据。如果有对象的读权限，则可以获取该对象内容和元数据。                                                      |
| OBS_PERMISSION_WRITE        | WRITE        | 写权限，如果有桶的写权限，则可以上传、覆盖和删除该桶内任何对象。此权限在对象上不适用。                                                                    |
| OBS_PERMISSION_READ_ACP     | READ_ACP     | 读ACP权限，如果有读ACP的权限，则可以获取对应的桶或对象的权限控制列表（ACL）。桶或对象的所有者永远拥有读对应桶或对象ACP的权限。                                          |
| OBS_PERMISSION_WRITE_ACP    | WRITE_ACP    | 写ACP权限，如果有写ACP的权限，则可以更新对应桶或对象的权限控制列表（ACL）。桶或对象的所有者永远拥有写对应桶或对象的ACP的权限。拥有了写ACP的权限，由于可以更改权限控制策略，实际上意味着拥有了完全访问的权限。 |
| OBS_PERMISSION_FULL_CONTROL | FULL_CONTROL | 完全控制权限，如果有桶的完全控制权限意味着拥有READ、WRITE、READ_ACP和WRITE_ACP的权限。如果有对象的完全控制权限意味着拥有READ、READ_ACP和WRITE_ACP的权限。           |
   
 表4obs_bucket_delivered 
| **常量名**                | **原始值** | **说明**         |
|:---|:---|:---|
| BUCKET_DELIVERED_FALSE | false   | 桶的ACL不向桶内对象传递。 |
| BUCKET_DELIVERED_TRUE  | true    | 桶的ACL向桶内对象传递。  |