文档首页/实时音视频 SparkRTC/API参考/OBS桶管理/OBS桶授权及取消授权 - UpdateObsBucketAuthority
更新时间：2025-11-04 GMT+08:00
查看PDF
分享

OBS桶授权及取消授权 - UpdateObsBucketAuthority

功能介绍

OBS桶授权及取消授权。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /v2/rtc-ops/buckets/authentication

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

表2 请求Body参数

参数

是否必选

参数类型

描述

bucket

是

String

OBS桶名

operation

是

Integer

操作，1-授权；0-取消授权

location

是

String

查询bucket所在的region

  • cn-north-4

  • cn-north-1

  • cn-north-5

  • cn-north-6

  • cn-south-1

  • cn-east-2

project_id

否

String

租户华为云账号projectid

响应参数

状态码：200

表3 响应Header参数

参数

参数类型

描述

X-request-Id

String

此字段携带请求ID号，以便任务跟踪。

状态码：400

表4 响应Header参数

参数

参数类型

描述

X-request-Id

String

此字段携带请求ID号，以便任务跟踪。

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：401

表6 响应Header参数

参数

参数类型

描述

X-request-Id

String

此字段携带请求ID号，以便任务跟踪。

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：500

表8 响应Header参数

参数

参数类型

描述

X-request-Id

String

此字段携带请求ID号，以便任务跟踪。

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

桶权限授权，桶：bucket001，位置：cn-north-4

POST https://rtc-api.myhuaweicloud.com/rtc-ops/buckets/authentication

{
  "bucket" : "bucket001",
  "operation" : 1,
  "location" : "cn-north-4"
}

响应示例

状态码：400

操作失败

{
  "error_code" : "RTC.00001003",
  "error_msg" : "InvalidParameterValue"
}

状态码：401

请求失败，携带的X-Auth-Token错误

{
  "error_code" : "RTC.00001003",
  "error_msg" : "InvalidParameterValue"
}

状态码：500

查询失败，服务器端错误

{
  "error_code" : "RTC.00002xxx",
  "error_msg" : "InternalError"
}

状态码

状态码

描述

200

操作成功

400

操作失败

401

请求失败，携带的X-Auth-Token错误

500

查询失败，服务器端错误

错误码

请参见错误码。

父主题：OBS桶管理