tencent cloud

文档反馈

授权策略语法

最后更新时间:2023-12-15 16:57:36

    策略语法

    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(显式拒绝)两种情况。该元素是必填项。

    CBS 的操作

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

    CBS 的资源路径

    每个 CAM 策略语句都有适用于自己的资源。资源路径的一般形式如下:
    qcs:project_id:service_type:region:account:resource
    project_id:描述项目信息,仅为了兼容 CAM 早期逻辑,无需填写。
    service_type:产品简称,如 CVM。
    region:地域信息,如 bj。
    account:资源拥有者的根账号信息,如 uin/164256472。
    resource:各产品的具体资源详情,如 volume/diskid1 或者 volume/*。
    例如,您可以使用特定 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 操作对其进行评估。必须匹配所有条件才能授予权限。 下表描述了 CBS 用于特定于服务的条件键:
    条件键
    参考类型
    键值对
    
    cvm:region
    
    
    String
    
    cvm:region=region
    其中 region 指代的是地域(例如 ap-guangzhou)
    
    cvm:disk_type
    
    
    String
    
    cvm_disk_type=disk_type
    其中 disk_type 指代的是磁盘类型(例如 CLOUD_PREMIUM)
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持