tencent cloud

数据万象

动态与公告
产品动态
产品公告
产品简介
产品概述
产品优势
应用场景
功能概览
地域与域名
使用限制
产品计费
计费概述
计费方式
计费项
免费额度
欠费说明
查看消费明细
常见问题
快速入门
注册与登录
绑定存储桶
上传和处理文件
下载和删除文件
解绑存储桶
通过 COS 使用数据万象
能力地图
图片处理
媒体处理
内容审核
AI 内容识别
文档处理
智能语音
文件处理
用户指南
概览
存储桶管理
智能工具箱
任务与工作流
数据监控
用量统计
实践教程
版权保护解决方案
图片处理实践
API 授权策略使用指引
工作流实践
API 文档
API 概览
结构体
公共请求头部
公共响应头部
开通万象服务
图片处理
AI 内容识别
智能语音
媒体处理
内容审核
文档处理
文件处理
任务与工作流
云查毒
错误码
请求签名
SDK 文档
SDK 概览
图片处理 Android SDK
图片处理 iOS SDK
COS Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Go SDK
COS iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
小程序 SDK
SDK 产品个人信息保护规则
安全与合规
权限管理
常见问题
基础设置
文档处理
媒体处理
内容识别
智能语音
服务协议
Service Level Agreement
联系我们
词汇表
文档数据万象实践教程API 授权策略使用指引

API 授权策略使用指引

PDF
聚焦模式
字号
最后更新时间: 2025-09-08 16:56:46
注意
在给子用户或协作者授予 API 操作权限时,请务必根据业务需要,按照最小权限原则进行授权。如果您直接授予子用户或者协作者所有资源(resource:*),或所有操作(action:*)权限,则存在由于权限范围过大导致数据安全风险。

概述

数据万象(Cloud Infinite,简称CI)使用临时密钥服务时,不同的 API 操作需要不同的操作权限,而且可以同时指定一个操作或一序列操作。
CI 的API 授权策略(policy)是一种 JSON 字符串。例如,授予 APPID 为1250000000,地域为 ap-beijing,存储桶为 examplebucket-1250000000 ,路径前缀为 doc 的媒体处理、文件压缩、文档预览任务创建操作的权限如下所示:
{
"version": "2.0",
"statement": [{
"action": [
//创建文件处理任务
"ci:CreateFileProcessJobs",
//创建文档预览任务
"ci:CreateDocProcessJobs",
//创建媒体任务
"ci:CreateMediaJobs",
],
"effect": "allow",
"resource": [
"qcs::ci:ap-beijing:uid/1250000000:bucket/examplebucket-1250000000/doc/*"
]
}
]
}

授权策略(policy)元素说明

名称
描述
version
策略语法版本,默认为2.0。
effect
有 allow (允许)和 deny (显式拒绝)两种情况。
resource
授权操作的具体数据,可以是任意资源、指定路径前缀的资源、指定绝对路径的资源或它们的组合。
规则为: qcs::ci:{region}:uid/{appid}:bucket/{bucket}/{path}
列举几种典型的授权场景: 1、允许访问所有对象:"*" 2、允许访问指定的对象:"a/a1.txt", "b/b1.txt" 3、允许访问指定前缀的对象:"a*", "a/*", "b/*"
注意:若路径为中文,则保持中文输入即可。例如examplebucket-1250000000/文件夹/文件名.txt
action
此处是指 CI 的 API,根据需求指定一个或者一序列操作的组合或所有操作(*),例如 action 为 ci:CreateMediaJobs请注意区分英文大小写
condition
约束条件,可以不填,具体说明请参见 condition 说明。
有关 CI 的 API 授权策略,请参见 数据万象全局访问管理

Service API

媒体处理任务

以媒体转码接口为例,API 接口为 CreateMediaJobs,若授予其操作权限,则策略的 action 为 ci:CreateMediaJobs
媒体任务中涉及到以下几种权限的接口 :
cos:GetObject 获取cos资源权限,
ci:CreateMediaJobs 创建任务,
ci:CreateMediaTemplate 创建模板,
ci:UpdateMediaTemplate 更新模板,
ci:DescribeMediaJob 任务查询,
ci:DescribeMediaJobs 任务列表查询,
ci:CancelMediaJob 任务取消。

示例

授予查询存储桶列表操作权限的策略详细内容如下:
{
"version": "2.0",
"statement": [
{
"action": [
"cos:GetObject",
"ci:CreateMediaJobs",
"ci:CreateMediaTemplate",
"ci:UpdateMediaTemplate",
"ci:DescribeMediaJob",
"ci:DescribeMediaJobs",
"ci:CancelMediaJob"
],
"effect": "allow",
"resource": [
"qcs::ci:ap-beijing:uid/1250000000:bucket/examplebucket-1250000000/*"
]
}
]
}

推荐使用 SDK

数据万象 SDK 提供了完整的临时密钥使用 Demo、集成服务接口、计算签名等能力。您可通过 SDK 方便快捷地调用接口,点此查看 SDK 文档


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈