更新时间:2024-11-29 GMT+08:00
分享

权限和授权项

如果您需要对您所拥有的容器镜像服务(SWR)进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),如果账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用SWR服务的其它功能。

默认情况下,新建的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与企业管理的区别
  • SWR共享版目前仅支持IAM项目,不支持企业项目。
  • 下表中的“√”表示支持,“x”表示暂不支持。
表1 容器镜像服务(SWR)支持的自定义策略授权项

权限

对应API接口

授权项(Action)

IAM项目(Project)

创建组织

POST /v2/manage/namespaces

swr:namespace:createNamespace

删除组织

DELETE /v2/manage/namespaces/{namespace}

swr:namespace:deleteNamespace

查询组织列表

GET /v2/manage/namespaces

swr:namespace:listNamespaces

查询指定组织的详情信息

GET /v2/manage/namespaces/{namespace}

swr:namespace:getNamespace

创建镜像

POST /v2/manage/namespaces/{namespace}/repos

swr:repo:createRepo

删除镜像

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}

swr:repo:deleteRepo

更新镜像的信息

PATCH /v2/manage/namespaces/{namespace}/repos/{repository}

swr:repo:updateRepo

查询镜像列表

GET /v2/manage/repos

swr:repo:listRepos

查询指定镜像的详情信息

GET /v2/manage/namespaces/{namespace}/repos/{repository}

swr:repo:getRepo

查询共享镜像列表

GET /v2/manage/shared-repositories

swr:repo:listSharedRepos

删除镜像Tag

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/tags/{tag}

swr:repo:deleteRepoTag

查询镜像Tag列表

GET /v2/manage/namespaces/{namespace}/repos/{repository}/tags

swr:repo:listRepoTags

创建镜像共享账号

POST /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains

swr:repo:createRepoDomain

删除镜像共享账号

DELETE /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain}

swr:repo:deleteRepoDomain

更新镜像共享账号

PATCH /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain}

swr:repo:updateRepoDomain

查询镜像共享账号列表

GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains

swr:repo:listRepoDomains

查询镜像共享账号详情

GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain}

swr:repo:getRepoDomain

把镜像共享给某个租户

POST /v2/manage/namespaces/{namespace}/repos/{repository}/shares

swr:repo:createRepoShare

删除镜像共享某个租户

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/shares/{share_id}

swr:repo:deleteRepoShare

更新镜像共享信息

PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/shares/{share_id}

swr:repo:updateRepoShare

查询镜像共享列表

GET /v2/manage/namespaces/{namespace}/repos/{repository}/shares

swr:repo:listRepoShares

创建镜像自动同步任务

POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo

swr:repo:createAutoSyncRepoJob

删除镜像自动同步任务

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo

swr:repo:deleteAutoSyncRepoJob

查询镜像自动同步任务列表

GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo

swr:repo:listAutoSyncRepoJobs

创建镜像手动同步任务

POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_images

swr:repo:createManualSyncRepoJob

查询镜像手动同步任务

GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_job

swr:repo:getSyncRepoJobInfo

创建触发器

POST /v2/manage/namespaces/{namespace}/repos/{repository}/triggers

swr:repo:createTrigger

删除触发器

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}

swr:repo:deleteTrigger

更新触发器

PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}

swr:repo:updateTrigger

查询触发器列表

GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers

swr:repo:listTriggers

查询触发器详情

GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}

swr:repo:getTrigger

创建镜像老化规则

POST /v2/manage/namespaces/{namespace}/repos/{repository}/retentions

swr:repo:createRetention

删除镜像老化规则

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}

swr:repo:deleteRetention

更新镜像老化规则

PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}

swr:repo:updateRetention

查询镜像老化历史

GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories

swr:repo:listRetentionHistories

查询镜像老化规则列表

GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions

swr:repo:listRetentions

查询镜像老化规则详情

GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}

swr:repo:getRetention

获取登录指令

POST /v2/manage/utils/secret

swr::createLoginSecret

查询配额

GET /v2/manage/projects/{project_id}/quotas

swr::listQuotas

添加组织授权

POST /v2/manage/namespaces/{namespace}/access

swr:namespace:createNamespaceAccess

删除组织授权

DELETE /v2/manage/namespaces/{namespace}/access

swr:namespace:deleteNamespaceAccess

更新组织授权

PATCH /v2/manage/namespaces/{namespace}/access

swr:namespace:updateNamespaceAccess

查询组织授权列表

GET /v2/manage/namespaces/{namespace}/access

swr:namespace:getNamespaceAccess

创建镜像授权

POST /v2/manage/namespaces/{namespace}/repos/{repository}/access

swr:repo:createRepoAccess

删除镜像授权

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/access

swr:repo:deleteRepoAccess

更新镜像授权

PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/access

swr:repo:updateRepoAccess

查询镜像授权列表

GET /v2/manage/namespaces/{namespace}/repos/{repository}/access

swr:repo:getRepoAccess

相关文档