tencent cloud

云服务器

动态与公告
产品动态
公共镜像更新动态
操作系统官方停止维护计划
产品公告
产品简介
云服务器概述
产品优势
基本概念
地域和可用区
新手指引
Service Regions and Service Providers
产品计费
计费概述
计费方式
计费项
转换计费方式
购买实例
变配费用说明
欠费说明
快速入门
通过自定义配置购买 Linux 云服务器
通过自定义配置购买 Windows 云服务器
用户指南
操作指南总览
使用限制总览
实例
竞价实例
预留实例
镜像
存储
备份与恢复
网络
安全
密码/密钥
监控与告警
运维管理
便捷功能
迁移服务器
在线迁移
迁移咨询
故障处理
无法登录云服务器问题处理思路
Windows 实例登录相关故障
Linux 实例登录相关故障
其他实例登录相关故障
实例运行故障
Linux 实例内存故障
网络故障
实践教程
云服务器选型建议
搭建环境
搭建网站
搭建应用
搭建可视化界面
本地文件上传到云服务器
网络性能测试
其他实践教程
API 文档
History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
安全与合规
访问管理
网络
常见问题
地域和可用区相关
计费相关
实例相关
存储相关
镜像相关
服务器迁移相关
网络相关
安全相关
操作系统相关
运维和监控相关
访问管理相关
NTP 服务相关
应用场景相关
服务协议
CVM Service Level Agreements
Red Hat Enterprise Linux 镜像服务协议
Public IP Service Level Agreement
词汇表
文档云服务器安全与合规访问管理授权策略语法

授权策略语法

PDF
聚焦模式
字号
最后更新时间： 2024-03-21 20:08:19

策略语法

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

CVM 的操作

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

CVM 的资源路径

每个 CAM 策略语句都有适用于自己的资源。 资源路径的一般形式如下：
qcs:project_id:service_type:region:account:resource
project_id：描述项目信息，仅为了兼容 CAM 早期逻辑，无需填写。 service_type：产品简称，如 CVM。 region：地域信息，如 bj。 account：资源拥有者的根账号信息，如 uin/164256472。 resource：各产品的具体资源详情，如 instance/instance_id1 或者 instance/*。
例如，您可以使用特定实例 (i-15931881scv4) 在语句中指定它，如下所示：
"resource":[ "qcs::cvm:bj:uin/164256472:instance/i-15931881scv4"]
您还可以使用 * 通配符指定属于特定账户的所有实例，如下所示：
"resource":[ "qcs::cvm:bj:uin/164256472:instance/*"]
您要指定所有资源，或者如果特定 API 操作不支持资源级权限，请在 Resource 元素中使用 * 通配符，如下所示：
"resource": ["*"]
如果您想要在一条指令中同时指定多个资源，请使用逗号将它们隔开，如下所示为指定两个资源的例子：
"resource":["resource1","resource2"]
下表描述了 CVM 能够使用的资源和对应的资源描述方法。
在下表中，$为前缀的单词均为代称。
其中，project 指代的是项目 ID。
其中，region 指代的是地域。
其中，account 指代的是账户 ID。
资源
授权策略中的资源描述方法
实例
qcs::cvm:$region:$account:instance/$instanceId
密钥
qcs::cvm:$region:$account:keypair/$keyId
VPC
qcs::vpc:$region:$account:vpc/$vpcId
子网
qcs::vpc:$region:$account:subnet/$subnetId
镜像
qcs::cvm:$region:$account:image/*
CBS
qcs::cvm:$region:$account:volume/$diskid
安全组
qcs::cvm:$region:$account:sg/$sgId
EIP
qcs::cvm:$region:$account:eip/*

CVM 的条件密钥

在策略语句中，您可以选择性指定控制策略生效时间的条件。每个条件都包含一个或多个密钥值对。条件密钥不区分大小写。
如果您指定了多个条件或在单一条件中指定了多个密钥，我们将通过逻辑 AND 操作对其进行评估。
如果您在单一条件中指定了一个具有多个值的密钥，我们将通过逻辑 OR 操作对其进行评估。必须匹配所有条件才能授予权限。 下表描述了 CVM 用于特定于服务的条件键。
条件键
参考类型
键值对

cvm:instance_type


String

cvm:instance_type=instance_type
其中 instance_type 指代的是实例类型（例如 S1.SMALL1）。

cvm:image_type


String

cvm:image_type=image_type
其中 image_type 指代的是镜像类型（例如 IMAGE_PUBLIC）。

vpc:region


String

vpc:region=region
其中 region 指代的是地域（例如 ap-guangzhou）。

cvm:disk_size


Integer

cvm:disk_size=disk_size
其中 disk_size 指代的是磁盘大小（例如 500）。

cvm:disk_type


String

cvm_disk_type=disk_type
其中 disk_type 指代的是磁盘类型（例如 CLOUD_BASIC）。

cvm:region


String

cvm:region=region
其中 region 指代的是地域（例如 ap-guangzhou）。

上一篇: 可授权的资源类型下一篇: 支持访问管理的 CVM API 接口

帮助和支持

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

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

文档反馈