接口功能介绍
用户可在点播模式下通过本接口向云点播设置存储桶的ACL权限。
接口约束
本接口的单用户QPS限制为20次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
URI
POST /accessControl/acl/set
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionCode | 否 | String | 可选参数,资源池编码。如不传入则设置默认资源池的acl。 | xs-cn-guangzhou-1 | |
acl | 是 | String | 必填参数,设置存储桶的权限,可选为 PRIVATE(私有)/PUBLIC-READ(公有读)/PUBLIC-READ-WRITE(公共读写)。 | PUBLIC-READ |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
code | 是 | Integer | 本次请求的结果码。 | 0 | |
message | 是 | String | 错误文本信息,创建成功时,为空字符串。 | "" |
请求示例
请求体body
{
"regionCode": "xs-cn-guangzhou-1",
"acl": "PUBLIC-READ"
}
响应示例
{
"code": 0,
"message": ""
}
状态码
Http 状态码 | 状态码信息 | 状态码描述 |
---|---|---|
0 | 表示业务成功 | 表示业务成功 |
400 | 请求参数有误 | 请求参数有误 |
403 | 用户鉴权失败,用户无操作权限 | 用户鉴权失败,用户无操作权限 |
404 | 请求的资源不存在,输入错误的URL | 请求的资源不存在,输入错误的URL |
500 | 业务执行异常 | 业务执行异常 |
错误码
OpenAPI错误码请参考 错误码说明。