Skip to main content

授权策略语法

策略语法

CAM 策略的基本结构如下:

{
"version": "2.0",
"statement": [
{
"effect": "effect",
"action": ["action"],
"resource": ["resource"],
"condition": {"key": {"value"}}
}
]
}
  • 版本 (version):必填项,目前仅允许值为 "2.0"
  • 语句 (statement):描述一条或多条权限的详细信息。每条策略必须包含且仅包含一个 statement 元素。

语句元素

  1. 操作 (action):描述允许或拒绝的操作。操作可以是 API(以 name 前缀描述)或者功能集(一组特定的 API,以 permid 前缀描述)。该元素是必填项。

  2. 资源 (resource):描述授权的具体数据。资源是用六段式描述,每款产品的资源定义详情会有所区别。该元素是必填项。

  3. 生效条件 (condition):描述策略生效的约束条件。条件包括操作符、操作键和操作值组成。条件值可包括时间、IP 地址等信息。该元素是非必填项。

  4. 影响 (effect):描述声明产生的结果是“允许”还是“显式拒绝”。包括 allow(允许)和 deny(显式拒绝)两种情况。该元素是必填项。

CBS 的资源路径

资源路径的一般形式如下:

qcs:project_id:service_type:region:account:resource
  • project_id:描述项目信息,仅为了兼容 CAM 早期逻辑,无需填写。
  • service_type:产品简称,如 cvm
  • region:地域信息,如 bj
  • account:资源拥有者的根帐号信息,如 uin/164256472
  • resource:各产品的具体资源详情,如 volume/diskid1volume/*

例如,您可以使用特定 CBS 资源(disk-abcdefg)在语句中指定它,如下所示:

"resource":[ "qcs::cvm:bj:uin/164256472:volume/disk-abcdefg"]

您还可以使用 * 通配符指定属于特定账户的所有 CBS 资源,如下所示:

"resource": ["qcs::cvm:bj:uin/164256472:volume/*"]

您要指定所有资源,或者如果特定 API 操作不支持资源级权限,请在 Resource 元素中使用 * 通配符,如下所示:

"resource": ["*"]

如果您想要在一条指令中同时指定多个资源,请使用逗号将它们隔开,如下所示为指定两个资源的例子:

"resource":["resource1","resource2"]

CBS 的条件密钥

在策略语句中,您可以选择性指定控制策略生效时间的条件。每个条件都包含一个或多个密钥值对。条件密钥不区分大小写。

  • 如果您指定了多个条件或在单一条件中指定了多个密钥,将通过逻辑 AND 操作进行评估。
  • 如果您在单一条件中指定了一个具有多个值的密钥,将通过逻辑 OR 操作进行评估。必须匹配所有条件才能授予权限。
条件键参考类型键值对
cvm:regionStringcvm:region=region
其中 region 指代的是地域(例如 ap-guangzhou
cvm:disk_typeStringcvm:disk_type=disk_type
其中 disk_type 指代的是磁盘类型(例如 CLOUD_PREMIUM