权限和授权项
如果您需要对您所拥有的云容器引擎（CCE）进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用CCE服务的其它功能。
默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使用户组中的用户获得相应的权限，这一过程称为授权。授权后，用户就可以基于已有的权限对云服务进行操作。关于策略的语法结构及示例，请参见IAM权限管理说明。
权限根据授权的精细程度，分为角色和策略。角色以服务为粒度，是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作、资源和条件，能够满足企业对权限最小化的安全管控要求。
说明：
如果您要允许或是禁止某个接口的操作权限，请使用策略。
账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询云服务器列表，那么这个IAM用户被授予的策略中必须包含允许“ecs:servers:list”的授权项，该接口才能调用成功。
IAM支持的授权项
策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下：
- 权限：允许或拒绝某项操作。
- 对应API接口：自定义策略实际调用的API接口。
- 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。
- 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。
- IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。
说明：
CCE权限管理相关策略适用于所有CCE产品，包括CCE Standard/Turbo/Autopilot集群。CCE Autopilot集群产品形态导致的差异，将特殊标注说明。
“√”表示支持，“x”表示暂不支持。
云容器引擎（CCE）支持的自定义策略授权项如下所示：
|
权限 |
对应API接口 |
授权项（Action） |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
获取指定项目下的集群 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters |
cce:cluster:list |
√ |
√ |
|
获取指定的集群 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id} [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id} |
cce:cluster:get |
√ |
√ |
|
创建集群 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters |
cce:cluster:create |
√ |
√ |
|
更新指定的集群 |
[Standard/Turbo] PUT /api/v3/projects/{project_id}/clusters/{cluster_id} [Autopilot] PUT /autopilot/v3/projects/{project_id}/clusters/{cluster_id} |
cce:cluster:update |
√ |
√ |
|
删除集群 |
[Standard/Turbo] DELETE /api/v3/projects/{project_id}/clusters/{cluster_id} [Autopilot] DELETE /autopilot/v3/projects/{project_id}/clusters/{cluster_id} |
cce:cluster:delete |
√ |
√ |
|
升级集群 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade |
cce:cluster:upgrade |
√ |
√ |
|
唤醒集群 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/awake [Autopilot] 不涉及 |
cce:cluster:start |
√ |
√ |
|
休眠集群 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/hibernate [Autopilot] 不涉及 |
cce:cluster:stop |
√ |
√ |
|
变更集群规格 |
[Standard/Turbo] POST /api/v2/projects/{project_id}/clusters/:clusterid/resize [Autopilot] 不涉及 |
cce:cluster:resize |
√ |
√ |
|
绑定、解绑集群公网APIServer地址 |
[Standard/Turbo] PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/mastereip [Autopilot] PUT /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/mastereip |
cce:cluster:update |
√ |
√ |
|
获取集群证书 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/clustercert [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/clustercert |
cce:cluster:get |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
获取集群下所有节点 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes [Autopilot] 不涉及 |
cce:node:list |
√ |
√ |
|
获取指定的节点 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/{node_id} [Autopilot] 不涉及 |
cce:node:get |
√ |
√ |
|
创建节点 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes [Autopilot] 不涉及 |
cce:node:create |
√ |
√ 说明：
使用企业项目授权创建节点需额外添加evs:quota:get的全局权限。 |
|
更新指定的节点 |
[Standard/Turbo] PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/{node_id} [Autopilot] 不涉及 |
cce:node:update |
√ |
√ |
|
删除节点 |
[Standard/Turbo] DELETE /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/{node_id} [Autopilot] 不涉及 |
cce:node:delete |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
获取任务信息 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/jobs/{job_id} [Autopilot] GET /autopilot/v3/projects/{project_id}/jobs/{job_id} |
cce:job:get |
√ |
√ |
|
列出所有任务 |
[Standard/Turbo] GET /api/v2/projects/{project_id}/jobs [Autopilot] GET /autopilot/v2/projects/{project_id}/jobs |
cce:job:list |
√ |
√ |
|
删除所有任务或删除单个任务 |
[Standard/Turbo] DELETE /api/v2/projects/{project_id}/jobs DELETE /api/v2/projects/{project_id}/jobs/{job_id} [Autopilot] DELETE /autopilot/v2/projects/{project_id}/jobs DELETE /autopilot/v2/projects/{project_id}/jobs/{job_id} |
cce:job:delete |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
获取集群下所有节点池 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools [Autopilot] 不涉及 |
cce:nodepool:list |
√ |
√ |
|
获取节点池 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id} [Autopilot] 不涉及 |
cce:nodepool:get |
√ |
√ |
|
创建节点池 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools [Autopilot] 不涉及 |
cce:nodepool:create |
√ |
√ |
|
更新节点池信息 |
[Standard/Turbo] PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id} [Autopilot] 不涉及 |
cce:nodepool:update |
√ |
√ |
|
删除节点池 |
[Standard/Turbo] DELETE /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id} [Autopilot] 不涉及 |
cce:nodepool:delete |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
更新模板 |
[Standard/Turbo] PUT /v2/charts/{id} [Autopilot] POST /autopilot/v2/charts |
cce:chart:update |
√ |
× |
|
上传模板 |
[Standard/Turbo] POST /v2/charts [Autopilot] POST /autopilot/v2/charts |
cce:chart:upload |
√ |
× |
|
下载模板 |
[Standard/Turbo] GET /v2/charts/{id}/archive [Autopilot] GET /autopilot/v2/charts/{id}/archive |
cce:chart:get |
√ |
× |
|
列出所有模板 |
[Standard/Turbo] GET /v2/charts [Autopilot] GET /autopilot/v2/charts |
cce:chart:list |
√ |
× |
|
获取模板信息 |
[Standard/Turbo] GET /v2/charts/{id} [Autopilot] GET /autopilot/v2/charts/{id} |
cce:chart:get |
√ |
× |
|
获取模板Values |
[Standard/Turbo] GET /v2/charts/{id}/values [Autopilot] GET /autopilot/v2/charts/{id}/values |
cce:chart:get |
√ |
× |
|
删除模板 |
[Standard/Turbo] DELETE /v2/charts/{id} [Autopilot] DELETE /autopilot/v2/charts/{id} |
cce:chart:delete |
√ |
× |
|
获取用户模板配额 |
[Standard/Turbo] GET /v2/charts/{project_id}/quotas [Autopilot] GET /autopilot/v2/charts/{project_id}/quotas |
cce:chart:list |
√ |
× |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
更新升级模板实例 |
[Standard/Turbo] PUT /cce/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name} PUT /v2/releases/{name}（已废弃） [Autopilot] PUT /autopilot/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name} |
cce:release:update |
√ |
√ |
|
列出所有模板实例 |
[Standard/Turbo] GET /cce/cam/v3/clusters/{cluster_id}/releases GET /v2/releases（已废弃） [Autopilot] GET /autopilot/cam/v3/clusters/{cluster_id}/releases |
cce:release:list |
√ |
√ |
|
创建模板实例 |
[Standard/Turbo] POST /cce/cam/v3/clusters/{cluster_id}/releases POST /v2/releases（已废弃） [Autopilot] POST /autopilot/cam/v3/clusters/{cluster_id}/releases |
cce:release:create |
√ |
√ |
|
获取模板实例信息 |
[Standard/Turbo] GET /cce/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name} GET /v2/releases/{name}（已废弃） [Autopilot] GET /autopilot/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name} |
cce:release:get |
√ |
√ |
|
查询指定模板实例历史记录 |
[Standard/Turbo] GET /cce/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name}/history GET /v2/releases/{name}/history（已废弃） [Autopilot] GET /autopilot/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name} |
cce:release:get |
√ |
√ |
|
删除模板实例 |
[Standard/Turbo] DELETE /cce/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name} DELETE /v2/releases/{name}（已废弃） [Autopilot] DELETE /autopilot/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name} |
cce:release:delete |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
创建PersistentVolumeClaim（待废弃） |
[Standard/Turbo] POST /api/v1/namespaces/{namespace}/cloudpersistentvolumeclaims [Autopilot] 不涉及 |
cce:storage:create |
√ |
√ |
|
删除PersistentVolumeClaim（待废弃） |
[Standard/Turbo] DELETE /api/v1/namespaces/{namespace}/cloudpersistentvolumeclaims/{name} [Autopilot] 不涉及 |
cce:storage:delete |
√ |
√ |
|
列出所有磁盘 |
[Standard/Turbo] GET /storage/api/v1/namespaces/{namespace}/listvolumes [Autopilot] 不涉及 |
cce:storage:list |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
列出所有插件模板 |
[Standard/Turbo] GET /api/v3/addontemplate [Autopilot] GET /autopilot/v3/addontemplates |
cce:addonTemplate:get |
√ |
x |
|
创建插件实例 |
[Standard/Turbo] POST /api/v3/addons [Autopilot] POST /autopilot/v3/addons |
cce:addonInstance:create |
√ |
√ |
|
获取插件实例 |
[Standard/Turbo] GET /api/v3/addons/{id}?cluster_id={cluster_id} [Autopilot] GET /autopilot/v3/addons/{id} |
cce:addonInstance:get |
√ |
√ |
|
列出所有插件实例 |
[Standard/Turbo] GET /api/v3/addons?cluster_id={cluster_id} [Autopilot] GET /autopilot/v3/addons?cluster_id={cluster_id} |
cce:addonInstance:list |
√ |
√ |
|
删除插件实例 |
[Standard/Turbo] DELETE /api/v3/addons/{id} [Autopilot] DELETE /autopilot/v3/addons/{id} |
cce:addonInstance:delete |
√ |
√ |
|
更新升级插件实例 |
[Standard/Turbo] PUT /api/v3/addons/{id} [Autopilot] PUT /autopilot/v3/addons/{id} |
cce:addonInstance:update |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
查询配额详情 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/quotas [Autopilot] GET /autopilot/v3/projects/{project_id}/quotas |
cce:quota:get |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
批量添加指定集群的资源标签 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/create [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/tags/create |
cce:tag:operate |
√ |
√ |
|
批量删除指定集群的资源标签 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/delete [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/tags/delete |
cce:tag:operate |
√ |
√ |
|
权限 |
对应API接口 |
授权项 |
IAM项目(Project) |
企业项目 (Enterprise Project) |
|---|---|---|---|---|
|
获取集群升级任务详情 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade/tasks/{task_id} [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade/tasks/{task_id} |
cce:cluster:get |
√ |
√ |
|
获取集群升级任务详情列表 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade/tasks [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade/tasks |
cce:cluster:get |
√ |
√ |
|
重试集群升级任务 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade/retry [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade/retry |
cce:cluster:upgrade |
√ |
√ |
|
集群升级前检查 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck |
cce:cluster:upgrade |
√ |
√ |
|
获取集群升级前检查任务详情 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck/tasks/{task_id} [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck/tasks/{task_id} |
cce:cluster:get |
√ |
√ |
|
获取集群升级前检查任务详情列表 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck/tasks [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck/tasks |
cce:cluster:get |
√ |
√ |
|
集群升级后确认 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/postcheck [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/postcheck |
cce:cluster:upgrade |
√ |
√ |
|
集群备份 |
[Standard/Turbo] POST /api/v3.1/projects/{project_id}/clusters/{cluster_id}/operation/snapshot [Autopilot] POST /autopilot/v3.1/projects/{project_id}/clusters/{cluster_id}/operation/snapshot |
cce:cluster:upgrade |
√ |
√ |
|
获取集群备份任务详情列表 |
[Standard/Turbo] GET /api/v3.1/projects/{project_id}/clusters/{cluster_id}/operation/snapshot/tasks [Autopilot] GET /autopilot/v3.1/projects/{project_id}/clusters/{cluster_id}/operation/snapshot/tasks |
cce:cluster:get |
√ |
√ |
|
获取集群升级相关信息 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/upgradeinfo [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/upgradeinfo |
cce:cluster:get |
√ |
√ |
|
开启集群升级流程引导任务 |
[Standard/Turbo] POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows [Autopilot] POST /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows |
cce:cluster:upgrade |
√ |
√ |
|
获取历史集群升级引导任务列表 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows |
cce:cluster:get |
√ |
√ |
|
获取指定集群升级引导任务详情 |
[Standard/Turbo] GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows/{upgrade_workflow_id} [Autopilot] GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows/{upgrade_workflow_id} |
cce:cluster:get |
√ |
√ |
|
更新指定集群升级引导任务状态 |
[Standard/Turbo] PATCH /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows/{upgrade_workflow_id} [Autopilot] PATCH /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgradeworkflows/{upgrade_workflow_id} |
cce:cluster:upgrade |
√ |
√ |
