对象存储服务 OBS-获取对象ACL(Python SDK):返回结果
下载对象存储服务 OBS用户手册完整版
返回结果
|
类型 |
说明 |
|---|---|
|
参数解释： SDK公共结果对象。 |
|
参数名称 |
参数类型 |
描述 |
|---|---|---|
|
status |
int |
参数解释： HTTP状态码。 取值范围： 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 默认取值： 无 |
|
reason |
str |
参数解释： HTTP文本描述。 默认取值： 无 |
|
errorCode |
str |
参数解释： OBS服务端错误码，当status参数小于300时为空。 默认取值： 无 |
|
errorMessage |
str |
参数解释： OBS服务端错误描述，当status参数小于300时为空。 默认取值： 无 |
|
requestId |
str |
参数解释： OBS服务端返回的请求ID。 默认取值： 无 |
|
indicator |
str |
参数解释： OBS服务端返回的错误定位码。 默认取值： 无 |
|
hostId |
str |
参数解释： 请求的服务端ID，当status参数小于300时为空。 默认取值： 无 |
|
resource |
str |
参数解释： 发生错误时相关的桶或对象，当status参数小于300时为空。 默认取值： 无 |
|
header |
list |
参数解释： 响应消息头列表，由多个元组构成。每个元组均包含两个元素，代表响应头的键值对。 默认取值： 无 |
|
body |
object |
参数解释： 操作成功后的结果数据，当status大于300时为空。该值根据调用接口的不同而不同，参见“桶相关接口”章节和“对象相关接口”章节的详细描述。 默认取值： 无 |
|
参数名称 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
owner |
作为请求参数时必选 |
参数解释： 所有者信息。详见Owner。 约束限制： owner和grants必须配套使用，且与ACL互斥。 默认取值： 无 |
|
|
grants |
list of Grant |
作为请求参数时必选 |
参数解释： 被授权用户权限信息列表。详见Grant。 默认取值： 无 |
|
delivered |
bool |
作为请求参数时可选 |
参数解释： 桶的ACL是否向桶内对象传递。作用于桶内所有对象。 取值范围： True：是，桶ACL向桶内对象传递。 False：否，桶ACL不向桶内对象传递，仅作用于桶。 默认取值： False |
|
参数名称 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
owner_id |
str |
作为请求参数时必选 |
参数解释： 所有者的账号ID，即domain_id。 取值范围： 如何获取账号ID请参见如何获取账号ID和用户ID? 默认取值： 无 |
|
owner_name |
str |
作为请求参数时可选 |
参数解释： 所有者的账号用户名。 取值范围： 如何获取账号用户名请参见如何获取用户名? 默认取值： 无 |
|
参数名称 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
grantee |
作为请求参数时必选 |
参数解释： 被授权用户相关信息，详见Grantee。 默认取值： 无 |
|
|
permission |
str |
作为请求参数时必选 |
参数解释： 被授予的权限。 取值范围： 权限取值范围详见权限。 默认取值： 无 |
|
delivered |
bool |
作为请求参数时可选 |
参数解释： 桶的ACL是否向桶内对象传递。作用于桶内所有对象。 取值范围： True：是，桶ACL向桶内对象传递。 False：否，桶ACL不向桶内对象传递，仅作用于桶。 默认取值： False |
|
常量值 |
说明 |
|---|---|
|
READ |
读权限。 如果有桶的读权限，则可以获取该桶内对象列表、桶内多段任务、桶的元数据、桶的多版本。 如果有对象的读权限，则可以获取该对象内容和元数据。 |
|
WRITE |
写权限。 如果有桶的写权限，则可以上传、覆盖和删除该桶内任何对象和段。 此权限在对象上不适用。 |
|
READ_ACP |
读取ACL配置的权限。 如果有读ACP的权限，则可以获取对应的桶或对象的权限控制列表（ACL）。 桶或对象的所有者永远拥有读对应桶或对象ACP的权限。 |
|
WRITE_ACP |
修改ACL配置的权限。 如果有写ACP的权限，则可以更新对应桶或对象的权限控制列表（ACL）。 桶或对象的所有者永远拥有写对应桶或对象的ACP的权限。 拥有了写ACP的权限，由于可以更改权限控制策略，实际上意味着拥有了完全访问的权限。 |
|
FULL_CONTROL |
完全控制权限，包括对桶或对象的读写权限，以及对桶或对象ACL配置的读写权限。 如果有桶的完全控制权限意味着拥有READ、WRITE、READ_ACP和WRITE_ACP的权限。 如果有对象的完全控制权限意味着拥有READ、READ_ACP和WRITE_ACP的权限。 |
|
参数名称 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
grantee_id |
str |
作为请求参数时，如果group为空则必选。 |
参数解释： 被授权用户的账号ID，即domain_id。 取值范围： 如何获取账号ID请参见获取账号ID。 默认取值： 无 |
|
grantee_name |
str |
作为请求参数时可选 |
参数解释： 被授权用户的账号名。 约束限制：
默认取值： 无 |
|
group |
str |
作为请求参数时，如果grantee_id为空则必选。 |
参数解释： 被授权的用户组。 取值范围： 授权用户组取值范围详见用户组。 默认取值： 无 |
