文档首页/ 云搜索服务 CSS/ API参考/ 权限策略和授权项
更新时间：2024-10-17 GMT+08:00
查看PDF
分享

权限策略和授权项

如果您需要对您所拥有的CSS（Cloud Search Service）进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用CSS服务的其它功能。

默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使用户组中的用户获得相应的权限，这一过程称为授权。授权后，用户就可以基于已有权限对云服务进行操作。

权限根据授权的精细程度，分为角色和策略。角色以服务为粒度，是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作、资源和条件，能够满足企业对权限最小化的安全管控要求。

如果您要允许或是禁止某个接口的操作权限，请使用策略。

账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。

支持的授权项

策略包含系统策略和自定义策略，如果系统策略不满足授权要求，CSS服务管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下：

  • 权限：允许或拒绝对指定资源在特定条件下进行某项操作。
  • 对应API接口：自定义策略实际调用的API接口。
  • 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。
  • 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。
  • IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。

    “√”表示支持，“x”表示暂不支持。

    表1 API授权项列表

    权限

    对应API接口

    授权项

    （Action）

    IAM项目

    (Project)

    企业项目

    (Enterprise Project)

    创建集群

    POST /v1.0/{project_id}/clusters

    css:cluster:create

    √

    √

    查询集群列表

    GET /v1.0/{project_id}/clusters

    css:cluster:list

    √

    √

    查询集群详情

    GET /v1.0/{project_id}/clusters/{cluster_id}

    css:cluster:get

    √

    √

    删除集群

    DELETE /v1.0/{project_id}/clusters/{cluster_id}

    css:cluster:delete

    √

    √

    重启集群

    POST /v1.0/{project_id}/clusters/{cluster_id}/restart

    css:cluster:restart

    √

    √

    扩容集群

    POST /v1.0/{project_id}/clusters/{cluster_id}/extend

    css:cluster:scaleOut

    √

    √

    扩容实例的数量和存储容量

    POST /v1.0/{project_id}/clusters/{cluster_id}/role_extend

    css:cluster:expand

    √

    √

    查询指定集群的标签

    GET /v1.0/{project_id}/css-cluster/{cluster_id}/tags

    css:tag:get

    √

    √

    加载自定义词库

    POST /v1.0/{project_id}/clusters/{cluster_id}/thesaurus

    css:IKThesaurus:load

    √

    √

    查询自定义词库状态

    GET /v1.0/{project_id}/clusters/{cluster_id}/thesaurus

    css:IKThesaurus:get

    √

    √

    删除自定义词库

    DELETE /v1.0/{project_id}/clusters/{cluster_id}/thesaurus

    css:IKThesaurus:delete

    √

    √

    自动设置集群快照的基础配置

    POST /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot/auto_setting

    css:snapshot:enableAtomaticSnapsot

    √

    √

    修改集群快照的基础配置

    POST /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot/setting

    css:snapshot:setSnapshotContiguration

    √

    √

    设置自动创建快照策略

    POST /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot/policy

    css:snapshot:setSnapshotPolicy

    √

    √

    查询集群的自动创建快照策略

    GET /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot/policy

    css:snapshot:getSnapshotPolicy

    √

    √

    手动创建快照

    POST /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot

    css:snapshot:create

    √

    √

    查询快照列表

    GET /v1.0/{project_id}/clusters/{cluster_id}/index_snapshots

    css:snapshot:list

    √

    √

    恢复快照

    POST /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot/{snapshot_id}/restore

    css:snapshot:restore

    √

    √

    删除快照

    DELETE /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot/{snapshot_id}

    css:snapshot:delete

    √

    √

    停用快照功能

    DELETE /v1.0/{project_id}/clusters/{cluster_id}/index_snapshots

    css:snapshot:disableSnapshotFuction

    √

    √