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

策略授权参考

本章节介绍CSS策略授权场景下支持的策略授权项。

支持的授权项

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

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

CSS的支持自定义策略授权项如下所示：

  • 管理集群：包含CSS集群管理对应的授权项，如创建集群、扩容集群、查看集群详情、获取实例规格列表等接口。
  • 自定义词库：包括CSS自定义词库功能对应的授权项，如加载自定义库、查询词库状态或删除自定义词库。
  • Kibana公网访问：包括Kibana公网访问对应的授权项，如开启Kibana公网访问、关闭Kibana公网访问、修改Kibana公网访问等接口。
  • 日志管理：包括CSS日志管理对应的授权项，如开启日志、关闭日志、修改日志、查询日志等接口。
  • 公网访问：包括CSS公网访问对应的授权项，如开启公网访问、关闭公网访问、修改公网访问等接口。
  • 快照管理：包括CSS快照功能对应的授权项，如数据备份与恢复，可以通过接口创建快照、恢复快照或者删除快照等接口。
  • 终端节点：包括CSS终端节点服务对应的授权项，如开启终端节点服务、关闭终端节点服务、获取连接终端节点服务、更新终端节点服务连接等接口。
  • 参数配置：包括CSS参数配置对应的授权项，如修改集群参数配置等接口。

管理集群

表1 集群管理接口

权限

对应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}/cluster/{cluster_id}/period

css:cluster:create

√

√

修改集群名称

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

css:cluster:modifyName

√

√

修改密码

POST /v1.0/{project_id}/clusters/{cluster_id}/password/reset

css:cluster:modifyPassword

√

√

重启集群

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

√

√

变更规格

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

css:cluster:modifySpecifications

√

√

获取实例规格列表

GET /v1.0/{project_id}/es-flavors

css:cluster:listFlavors

√

√

查询所有标签

GET /v1.0/{project_id}/{resource_type}/tags

css:tag:list

√

√

查询指定集群的标签

GET /v1.0/{project_id}/{resource_type}/{cluster_id}/tags

css:tag:get

√

√

添加指定集群标签

POST /v1.0/{project_id}/{resource_type}/{cluster_id}/tags

css:tag:edit

√

√

删除集群标签

DELETE /v1.0/{project_id}/{resource_type}/{cluster_id}/tags/{key}

css:tag:delete

√

√

批量添加或删除集群标签

POST /v1.0/{project_id}/{resource_type}/{cluster_id}/tags/action

css:tag:addOrDelete

√

√

指定节点类型规格变更

POST /v1.0/{project_id}/clusters/{cluster_id}/{types}/flavor

css:cluster:modifySpecifications

√

√

指定节点缩容

POST /v1.0/{project_id}/clusters/{cluster_id}/node/offline

css:cluster:shrinkNodes

√

√

指定节点类型缩容

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

css:cluster:scaleIn

√

√

下载安全证书

GET /v1.0/{project_id}/cer/download

css:cluster:downloadCert

√

√

节点替换

PUT /v1.0/{project_id}/clusters/{cluster_id}/instance/{instance_id}/replace

css:cluster:upgradeCluster

√

√

安全模式修改

POST /v1.0/{project_id}/clusters/{cluster_id}/mode/change

css:cluster:changeMode

√

√

添加独立master、client

POST /v1.0/{project_id}/clusters/{cluster_id}/type/{type}/independent

css:cluster:addIndependenceNodes

√

√

切换安全组

POST /v1.0/{project_id}/clusters/{cluster_id}/sg/change

css:cluster:modifySecurityGroup

√

√

创建集群V2

POST /v2.0/{project_id}/clusters

css:cluster:create

√

√

重启集群V2

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

css:cluster:restart

√

√

滚动重启

POST /v2.0/{project_id}/clusters/{cluster_id}/rolling_restart

css:cluster:rollingReboot

√

√

自定义词库

表2 词库管理接口

权限

对应API接口

授权项（Action）

IAM项目

(Project)

企业项目

(Enterprise Project)

加载自定义词库

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

√

√

Kibana公网访问

表3 Kibana公网访问接口

权限

对应API接口

授权项（Action）

IAM项目

(Project)

企业项目

(Enterprise Project)

开启Kibana公网访问

POST /v1.0/{project_id}/clusters/{cluster_id}/publickibana/open

css:publicKibana:open

√

√

关闭Kibana公网访问

PUT /v1.0/{project_id}/clusters/{cluster_id}/publickibana/close

css:publicKibana:close

√

√

修改Kibana公网带宽

POST /v1.0/{project_id}/clusters/{cluster_id}/publickibana/bandwidth

css:publicIPAddress:modifyBandwidth

√

√

修改Kibana公网访问控制

POST /v1.0/{project_id}/clusters/{cluster_id}/publickibana/whitelist/update

ss:publicIPAddress:setAccessControl

√

√

关闭Kibana公网访问控制

PUT /v1.0/{project_id}/clusters/{cluster_id}/publickibana/whitelist/close

css:publicIPAddress:setAccessControl

√

√

日志管理

表4 日志管理接口

权限

对应API接口

授权项（Action）

IAM项目

(Project)

企业项目

(Enterprise Project)

开启日志功能

POST /v1.0/{project_id}/clusters/{cluster_id}/logs/open

css:cluster:openLogSetting

√

√

关闭日志功能

PUT /v1.0/{project_id}/clusters/{cluster_id}/logs/close

css:log:enableOrDisableLogFunction

√

√

查询作业列表

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

css:log:listJob

√

√

查询日志基础配置

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

css:log:getBasicConfigurations

√

√

修改日志基础配置

POST /v1.0/{project_id}/clusters/{cluster_id}/logs/settings

css:log:setBasicConfigurations

√

√

开启日志自动备份策略

POST /v1.0/{project_id}/clusters/{cluster_id}/logs/policy/update

css:log:updateBackupPolicy

√

√

关闭日志自动备份策略

PUT /v1.0/{project_id}/clusters/{cluster_id}/logs/policy/close

css:log:updateBackupPolicy

√

√

备份日志

POST /v1.0/{project_id}/clusters/{cluster_id}/logs/collect

css:log:backup

√

√

查询日志

POST /v1.0/{project_id}/clusters/{cluster_id}/logs/search

css:log:list

√

√

公网访问

表5 公网访问接口

权限

对应API接口

授权项（Action）

IAM项目

(Project)

企业项目

(Enterprise Project)

开启公网访问

POST /v1.0/{project_id}/clusters/{cluster_id}/public/open

css:publicIPAddress:associates

√

√

关闭公网访问

PUT /v1.0/{project_id}/clusters/{cluster_id}/public/close

css:publicIPAddress:disassociates

√

√

修改公网访问带宽

POST /v1.0/{project_id}/clusters/{cluster_id}/public/bandwidth

css:publicIPAddress:modifyBandwidth

√

√

开启公网访问控制白名单

POST /v1.0/{project_id}/clusters/{cluster_id}/public/whitelist/update

css:publicIPAddress:setAccessControl

√

√

关闭公网访问控制白名单

PUT /v1.0/{project_id}/clusters/{cluster_id}/public/whitelist/close

css:publicIPAddress:setAccessControl

√

√

快照管理

表6 快照管理接口

权限

对应API接口

授权项（Action）

IAM项目

(Project)

企业项目

(Enterprise Project)

自动设置集群快照的基础配置（不推荐使用）

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

css:snapshot:create

√

√

恢复快照

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

√

√

设置自动创建快照策略

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

√

√

查询快照列表

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

css:snapshot:list

√

√

停用快照功能

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

css:snapshot:disableSnapshotFuction

√

√

开启自动创建快照功能

POST /v2.0/{project_id}/clusters/{cluster_id}/snapshots/policy/open

css:snapshot:setSnapshotPolicy

√

√

关闭自动创建快照功能

PUT /v2.0/{project_id}/clusters/{cluster_id}/snapshots/policy/close

css:snapshot:setSnapshotPolicy

√

√

终端节点

表7 终端节点接口

权限

对应API接口

授权项（Action）

IAM项目

(Project)

企业项目

(Enterprise Project)

开启终端节点服务

POST /v1.0/{project_id}/clusters/{cluster_id}/vpcepservice/open

css:VPCEndpoint:enableOrDisable

√

√

关闭终端节点服务

PUT /v1.0/{project_id}/clusters/{cluster_id}/vpcepservice/close

css:VPCEndpoint:enableOrDisable

√

√

获取终端节点连接

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

css:VPCEndpoint:listConnection

√

√

更新终端节点连接

POST /v1.0/{project_id}/clusters/{cluster_id}/vpcepservice/connections

css:VPCEndpoint:manageConnection

√

√

修改终端节点服务白名单

POST /v1.0/{project_id}/clusters/{cluster_id}/vpcepservice/permissions

css:VPCEndpoint:updateWhitelist

√

√

参数配置

表8 参数配置接口

权限

对应API接口

授权项（Action）

IAM项目

(Project)

企业项目

(Enterprise Project)

修改参数配置

POST /v1.0/{project_id}/clusters/{cluster_id}/ymls/update

css:configurations:modify

√

√

获取参数配置任务列表

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

css:configurations:list

√

√

获取参数配置列表

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

css:configurations:get

√

√

父主题：权限和授权项