授权策略语法

最近更新时间:2023-12-08 14:55:59

我的收藏

策略语法

CAM 策略:
{
"version":"2.0",
"statement":
[
{
"effect":"effect",
"action":["action"],
"resource":["resource"],
"condition": {"key":{"value"}}
}
]
}
版本 version: 必填,目前仅允许值为"2.0"。
语句 statement: 描述一条或多条权限的详细信息。该元素包括 effect、action、resource、condition 等多个其他元素的权限或权限集合。一条策略有且仅有一个 statement 元素。
操作 action:必填,描述允许或拒绝的操作。操作可以是 API(以 name 前缀描述)或者功能集(一组特定的 API,以 permid 前缀描述)。
资源 resource:必填,描述授权的具体数据。资源是用六段式描述。每款产品的资源定义详情会有所区别。有关如何指定资源的信息,请参阅您编写的资源声明所对应的产品文档。
生效条件 condition:非必填,描述策略生效的约束条件。条件由操作符、操作键和操作值组成。条件值可以是客户端 IP 地址。
影响 effect:必填,描述声明产生的结果是“允许”还是“显式拒绝”,即 allow(允许)和 deny(显式拒绝)两种情况。

ASR 的操作

在 CAM 策略语句中,您可以从支持 CAM 的任何服务中指定任意的 API 操作。对于 ASR,请使用以 name/asr: 为前缀的 API。例如:name/asr:CreateModel 或者 name/asr:CreateAsrVocab
如果您要在单个语句中指定多个操作的时候,请使用逗号将它们隔开,如下所示:
"action":["name/asr:action1","name/asr:action2"]
您也可以使用通配符指定多项操作。例如,您可以指定名字以单词"Describe"开头的所有操作,如下所示:
"action":["name/asr:Describe*"]
如果您要指定 ASR 中所有操作,请使用 * 通配符,如下所示:
"action"["name/asr:*"]

ASR 的资源路径

每个 CAM 策略语句都有适用于自己的资源。资源路径的一般形式如下:
qcs:project_id:service_type:region:account:resource
project_id:描述项目信息,仅为了兼容 CAM 早期逻辑,无需填写。
service_type:产品简称,填写 asr。
region:地域信息,ASR 无需填写。
account:资源拥有者的根账号信息,如 uin/164256472。
resource:各产品的具体资源详情,如subUin/1234567 或者 subUin/*
例如,如果您想要在限制某些子账号只可以访问自己创建的资源,您可以这样设置resource,其中164256472代表主账号,123456代表子账号(subUin):,如下所示:
"resource":[ "qcs::asr::uin/164256472:subUin/123456"]
如果您想要在限制某些子账号可以访问主账号下的所有资源,您可以这样设置resource:
"resource":[ "qcs::asr::uin/164256472:subUin/*"]
下表描述了 ASR 能够使用的资源和对应的资源描述方法。在下表中,$为前缀的单词均为代称。其中,account 指代的是账户 ID。
资源
授权策略中的资源描述方法
授权子账号可增删查改所有账号资源
qcs::asr::uin/${uin}:subUin/*
仅可增删查改子账号自己创建资源
qcs::asr::uin/${uin}:subUin/${uin}