更新时间:2024-09-14 GMT+08:00

桶授权或取消授权

功能介绍

对OBS桶进行授权或取消授权,媒体处理服务仅拥有已授权桶的读写权限。(暂不支持KMS加密桶的授权)

调用方法

请参见如何调用API

URI

PUT /v1/{project_id}/authority

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Project_Id

String

使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

表3 请求Body参数

参数

是否必选

参数类型

描述

bucket

String

桶名

operation

String

操作标记

取值范围为 [0,1]

  • 0:表示取消授权

  • 1:表示授权

响应参数

状态码: 403

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

授权或取消授权OBS桶,媒体处理服务仅拥有已授权桶的读写权限。

PUT https://{endpoint}/v1/{project_id}/authority

{
  "bucket" : "example-bucket",
  "operation" : 1
}

响应示例

状态码: 403

修改桶授权状态失败。

{
  "error_code" : "MPC.10209",
  "error_msg" : "Invalid input or output OBS path."
}

状态码

状态码

描述

204

处理成功返回

403

修改桶授权状态失败。

错误码

请参见错误码