更新时间:2025-10-29 GMT+08:00
分享

身份策略授权参考

云服务在IAM预置了常用授权项,称为系统身份策略。如果IAM系统身份策略无法满足授权要求,管理员可以根据各服务支持的授权项,创建IAM自定义身份策略来进行精细的访问控制,IAM自定义身份策略是对系统身份策略的扩展和补充。

除IAM服务外,Organizations服务中的服务控制策略(Service Control Policies,以下简称SCP)也可以使用这些授权项元素设置访问控制策略。

SCP不直接进行授权,只划定权限边界。将SCP绑定到组织单元或者成员账号时,并没有直接对组织单元或成员账号授予操作权限,而是规定了成员账号或组织单元包含的成员账号的授权范围。IAM身份策略授予权限的有效性受SCP限制,只有在SCP允许范围内的权限才能生效。

IAM服务与Organizations服务在使用这些元素进行访问控制时,存在着一些区别,详情请参见:IAM服务与Organizations服务权限访问控制的区别

本章节介绍IAM服务身份策略授权场景中自定义身份策略和组织服务中SCP使用的元素,这些元素包含了操作(Action)、资源(Resource)和条件(Condition)。

操作(Action)

操作(Action)即为身份策略中支持的授权项。

  • “访问级别”列描述如何对操作进行分类(list、read和write等)。此分类可帮助您了解在身份策略中相应操作对应的访问级别。
  • “资源类型”列指每个操作是否支持资源级权限。
    • 资源类型支持通配符号*表示所有。如果此列没有值(-),则必须在身份策略语句的Resource元素中指定所有资源类型(“*”)。
    • 如果该列包含资源类型,则必须在具有该操作的语句中指定该资源的URN。
    • 资源类型列中必需资源在表中用星号(*)标识,表示使用此操作必须指定该资源类型。

    关于CES定义的资源类型的详细信息请参见资源类型(Resource)

  • “条件键”列包括了可以在身份策略语句的Condition元素中支持指定的键值。
    • 如果该授权项资源类型列存在值,则表示条件键仅对列举的资源类型生效。
    • 如果该授权项资源类型列没有值(-),则表示条件键对整个授权项生效。
    • 如果此列条件键没有值(-),表示此操作不支持指定条件键。

    关于CES定义的条件键的详细信息请参见条件(Condition)

  • 别名”列包括了可以在身份策略中配置的策略授权项。通过这些授权项,可以控制支持策略授权的API访问。详细信息请参见身份策略兼容性说明

您可以在身份策略语句的Action元素中指定以下CES的相关操作。

表1 ces支持的授权项

授权项

描述

访问级别

资源类型(*为必须)

条件键

别名

ces:alarms:create

授予创建告警规则的权限。

Write

-

-

ces:alarms:put

授予更新告警规则的权限。

Write

alarm *

  • ces:alarmsonoff:put

-

ces:alarms:get

授予查询指定告警规则的权限。

Read

alarm *

g:EnterpriseProjectId

  • ces:alarms:list

ces:alarmHistory:list

授予查询告警历史列表的权限。

List

-

g:EnterpriseProjectId

-

ces:events:post

授予上报事件的权限。

Write

-

-

-

ces:events:list

授予查询事件列表的权限。

List

-

-

-

ces:events:get

授予查询指定事件详情的权限。

Read

-

-

-

ces:metrics:list

授予查询指标列表的权限。

List

-

-

-

ces:metricData:list

授予批量查询指标数据的权限。

List

-

-

-

ces:eventData:get

授予查询主机配置的权限。

Read

-

-

  • ces:sapEventData:list

ces:metricData:get

授予查询单条指标数据的权限。

Read

-

-

  • ces:metricData:list

ces:metricData:create

授予上报指标数据的权限。

Write

-

-

-

ces:quotas:get

授予查询配额的权限。

Read

-

-

-

ces:alarms:create

授予创建告警规则的权限。

Write

-

-

ces:alarms:delete

授予删除指定告警规则的权限。

Write

alarm *

-

ces:alarms:putAction

授予启停告警规则的权限。

Write

alarm *

  • ces:alarms:put

ces:alarms:list

授予查询告警规则列表的权限。

List

-

g:EnterpriseProjectId

-

ces:alarms:addResources

授予为指定告警规则批量增加资源的权限。

Write

alarm *

  • ces:alarms:put

ces:alarms:deleteResources

授予为指定告警规则批量删除资源的权限。

Write

alarm *

  • ces:alarms:put

ces:alarms:getResources

授予查询指定告警规则的资源列表权限。

Read

alarm *

  • ces:alarms:list

ces:alarms:updatePolicies

授予更新指定告警规则的策略列表权限。

Write

alarm *

  • ces:alarms:put

ces:alarms:getPolicies

授予查询指定告警规则的策略列表权限。

Read

alarm *

  • ces:alarms:get

ces:alarms:putAlarmNotifications

授予修改告警通知信息的权限。

Write

alarm *

  • ces:alarms:put

ces:alarmHistory:list

授予查询告警历史列表的权限。

List

-

g:EnterpriseProjectId

-

ces:customAlarmTemplates:create

授予创建自定义告警模板的权限。

Write

-

g:EnterpriseProjectId

-

ces:customAlarmTemplates:delete

授予删除指定自定义告警模板的权限。

Write

-

g:EnterpriseProjectId

-

ces:customAlarmTemplates:put

授予更新指定自定义告警模板的权限。

Write

-

g:EnterpriseProjectId

-

ces:customAlarmTemplates:list

授予查询自定义告警模板列表的权限。

List

-

g:EnterpriseProjectId

-

ces:customAlarmTemplates:get

授予查询指定自定义告警模板的权限。

Read

-

g:EnterpriseProjectId

  • ces:customAlarmTemplates:list

ces:customAlarmTemplates:listAssociatedAlarms

授予查询指定自定义告警模板关联的告警规则列表的权限。

List

-

g:EnterpriseProjectId

-

ces:resourceGroups:create

授予创建资源分组的权限。

Write

-

g:EnterpriseProjectId

-

ces:resourceGroups:delete

授予删除资源分组的权限。

Write

-

g:EnterpriseProjectId

-

ces:resourceGroups:put

授予更新指定资源分组的权限。

Write

-

g:EnterpriseProjectId

-

ces:resourceGroups:get

授予查询指定资源分组的权限。

Read

-

g:EnterpriseProjectId

-

ces:resourceGroups:list

授予查询所有资源分组的权限。

List

-

g:EnterpriseProjectId

  • ces:resourceGroups:get

ces:resourceGroups:putAssociationAlarmTemplate

授予修改资源分组关联告警模板的权限。

Write

-

g:EnterpriseProjectId

  • ces:resourceGroups:put

ces:resourceGroups:addResources

授予为指定资源分组批量添加关联资源的权限。

Write

-

g:EnterpriseProjectId

  • ces:resourceGroups:put

ces:resourceGroups:deleteResources

授予为指定资源分组批量删除关联资源的权限。

Write

-

g:EnterpriseProjectId

  • ces:resourceGroups:put

ces:resourceGroups:getServiceResources

授予查询指定资源分组指定服务类别指定维度的的权限。

Read

-

g:EnterpriseProjectId

  • ces:resourceGroups:get

ces:alarms:createOneClickAlarms

授予创建一键告警的权限。

Write

-

g:EnterpriseProjectId

  • ces:oneClickAlarms:post

ces:alarms:listOneClickAlarms

授予查询一键告警列表的权限。

List

-

g:EnterpriseProjectId

  • ces:oneClickAlarms:list

ces:alarms:putOneClickAlarms

授予批量启停一键告警权限。

Write

-

g:EnterpriseProjectId

  • ces:oneClickAlarms:put

ces:alarms:deleteOneClickAlarms

授予批量删除一键告警的权限。

Write

-

g:EnterpriseProjectId

  • ces:oneClickAlarms:delete

ces:alarms:putOneClickAlarmNotifications

授予批量修改一键告警通知规则的权限。

Write

-

g:EnterpriseProjectId

  • ces:oneClickAlarms:updateNotifications

ces:alarms:putOneClickAlarmPolicies

授予批量启停一键告警策略权限。

Write

-

g:EnterpriseProjectId

  • ces:oneClickAlarms:put

ces:alarms:putNotificationMaskRules

授予设置告警通知屏蔽规则的权限。

Write

-

g:EnterpriseProjectId

  • ces:notificationMasks:update

ces:alarms:deleteNotificationMaskRules

授予批量删除告警通知屏蔽规则的权限。

Write

-

g:EnterpriseProjectId

  • ces:notificationMasks:delete

ces:alarms:listNotificationMaskRules

授予查询告警通知屏蔽列表的权限。

List

-

g:EnterpriseProjectId

  • ces:notificationMasks:list

ces:alarms:listNotificationMaskResources

授予查询告警通知屏蔽资源列表的权限。

List

-

g:EnterpriseProjectId

  • ces:notificationMasks:list

ces:dashboards:create

授予创建dashboard的权限。

Write

dashboard *

-

-

-

g:EnterpriseProjectId

ces:dashboards:list

授予批量查询dashboard列表的权限。

List

dashboard *

-

-

-

g:EnterpriseProjectId

ces:dashboards:put

授予更新指定dashboard的权限。

Write

dashboard *

g:EnterpriseProjectId

-

ces:dashboards:delete

授予批量删除dashboard的权限。

Write

dashboard *

g:EnterpriseProjectId

-

ces:widgets:create

授予创建视图的权限。

Write

-

ces:namespace

-

ces:widgets:list

授予批量查询指定dashboard的视图列表权限。

List

-

-

-

ces:widgets:get

授予查询指定视图的权限。

Read

-

-

-

ces:widgets:delete

授予删除指定视图的权限。

Write

-

-

-

ces:widgets:put

授予批量更新视图的权限。

Write

-

ces:namespace

-

ces:tags:list

授予批量查询CES标签列表的权限。

List

-

-

  • ces:projecttags:list

ces:namespacesDimensions:listAgentDimensions

授予查询指定实例下agent维度指标信息的权限。

List

-

-

  • ces:namespacesDimensions:list

ces:metricData:list

授予批量查询指标数据的权限。

List

-

-

-

ces:agent:listStatuses

授予批量查询实例下agent状态列表的权限。

List

-

-

  • ces:agentStatus:get
  • ces:agentStatus:list

ces:agent:listTaskInvocations

授予批量查询指定服务器的agent任务的权限。

List

-

-

  • ces:taskInvocation:get

ces:agent:createAgentInvocations

授予批量创建agent任务的权限。

Write

-

-

  • ces:taskInvocation:post

CES的API通常对应着一个或多个授权项。表2展示了API与授权项的关系,以及该API需要依赖的授权项。

表2 API与授权项的关系

API

对应的授权项

依赖的授权项

POST /V1.0/{project_id}/alarms

ces:alarms:create

-

PUT /V1.0/{project_id}/alarms/{alarm_id}

ces:alarms:put

-

PUT /V1.0/{project_id}/alarms/{alarm_id}/action

ces:alarms:putAction

-

DELETE /V1.0/{project_id}/alarms/{alarm_id}

ces:alarms:delete

-

GET /V1.0/{project_id}/alarms/{alarm_id}

ces:alarms:get

-

GET /V1.0/{project_id}/alarms

ces:alarms:list

-

GET /V1.0/{project_id}/alarm-histories

ces:alarmHistory:list

-

POST /V1.0/{project_id}/events

ces:events:post

-

GET /V1.0/{project_id}/events

ces:events:list

-

GET /V1.0/{project_id}/event/{event_name}

ces:events:get

-

GET /V1.0/{project_id}/metrics

ces:metrics:list

-

POST /V1.0/{project_id}/batch-query-metric-data

ces:metricData:list

-

GET /V1.0/{project_id}/event-data

ces:eventData:get

-

GET /V1.0/{project_id}/metric-data

ces:metricData:get

-

POST /V1.0/{project_id}/metric-data

ces:metricData:create

-

GET /V1.0/{project_id}/quotas

ces:quotas:get

-

GET /V1.0/{project_id}/resource-groups/{group_id}

ces:resourceGroups:get

-

PUT /V1.0/{project_id}/resource-groups/{group_id}

ces:resourceGroups:put

-

DELETE /V1.0/{project_id}/resource-groups/{group_id}

ces:resourceGroups:delete

-

POST /V1.0/{project_id}/resource-groups

ces:resourceGroups:create

-

GET /V1.0/{project_id}/resource-groups

ces:resourceGroups:list

-

POST /V1.0/{project_id}/alarm-template

ces:customAlarmTemplates:create

-

PUT /V1.0/{project_id}/alarm-template/{template_id}

ces:customAlarmTemplates:put

-

DELETE /V1.0/{project_id}/alarm-template/{template_id}

ces:customAlarmTemplates:delete

-

GET /V1.0/{project_id}/alarm-template

ces:customAlarmTemplates:list

-

POST /v2/{project_id}/alarms

ces:alarms:create

-

POST /v2/{project_id}/alarms/batch-delete

ces:alarms:delete

-

POST /v2/{project_id}/alarms/action

ces:alarms:putAction

-

GET /v2/{project_id}/alarms

ces:alarms:list

-

POST /v2/{project_id}/alarms/{alarm_id}/resources/batch-create

ces:alarms:addResources

-

POST /v2/{project_id}/alarms/{alarm_id}/resources/batch-delete

ces:alarms:deleteResources

-

GET /v2/{project_id}/alarms/{alarm_id}/resources

ces:alarms:getResources

-

PUT /v2/{project_id}/alarms/{alarm_id}/policies

ces:alarms:updatePolicies

-

GET /v2/{project_id}/alarms/{alarm_id}/policies

ces:alarms:getPolicies

-

PUT /v2/{project_id}/alarms/{alarm_id}/notifications

ces:alarms:putAlarmNotifications

-

GET /v2/{project_id}/alarm-histories

ces:alarmHistory:list

-

POST /v2/{project_id}/alarm-templates

ces:customAlarmTemplates:create

-

POST /v2/{project_id}/alarm-templates/batch-delete

ces:customAlarmTemplates:delete

-

PUT /v2/{project_id}/alarm-templates/{template_id}

ces:customAlarmTemplates:put

-

GET /v2/{project_id}/alarm-templates

ces:customAlarmTemplates:list

-

GET /v2/{project_id}/alarm-templates/{template_id}

ces:customAlarmTemplates:get

-

GET /v2/{project_id}/alarm-templates/{template_id}/association-alarms

ces:customAlarmTemplates:listAssociatedAlarms

-

POST /v2/{project_id}/resource-groups

ces:resourceGroups:create

-

POST /v2/{project_id}/resource-groups/batch-delete

ces:resourceGroups:delete

-

PUT /v2/{project_id}/resource-groups/{group_id}

ces:resourceGroups:put

-

GET /v2/{project_id}/resource-groups/{group_id}

ces:resourceGroups:get

-

GET /v2/{project_id}/resource-groups

ces:resourceGroups:list

-

PUT /v2/{project_id}/resource-groups/{group_id}/alarm-templates/async-association

ces:resourceGroups:putAssociationAlarmTemplate

-

POST /v2/{project_id}/resource-groups/{group_id}/resources/batch-create

ces:resourceGroups:addResources

-

POST /v2/{project_id}/resource-groups/{group_id}/resources/batch-delete

ces:resourceGroups:deleteResources

-

GET /v2/{project_id}/resource-groups/{group_id}/services/{service}/resources

ces:resourceGroups:getServiceResources

-

POST /v2/{project_id}/one-click-alarms

ces:alarms:createOneClickAlarms

-

GET /v2/{project_id}/one-click-alarms

ces:alarms:listOneClickAlarms

-

GET /v2/{project_id}/one-click-alarms/{one_click_alarm_id}/alarms

ces:alarms:listOneClickAlarms

-

PUT /v2/{project_id}/one-click-alarms/{one_click_alarm_id}/alarm-rules/action

ces:alarms:putOneClickAlarms

-

POST /v2/{project_id}/one-click-alarms/batch-delete

ces:alarms:deleteOneClickAlarms

-

PUT /v2/{project_id}/one-click-alarms/{one_click_alarm_id}/notifications

ces:alarms:putOneClickAlarmNotifications

-

PUT /v2/{project_id}/one-click-alarms/{one_click_alarm_id}/alarms/{alarm_id}/policies/action

ces:alarms:putOneClickAlarmPolicies

-

PUT /v2/{project_id}/notification-masks

ces:alarms:putNotificationMaskRules

-

POST /v2/{project_id}/notification-masks/batch-update

ces:alarms:putNotificationMaskRules

-

PUT /v2/{project_id}/notification-masks/{notification_mask_id}

ces:alarms:putNotificationMaskRules

-

POST /v2/{project_id}/notification-masks/batch-delete

ces:alarms:deleteNotificationMaskRules

-

POST /v2/{project_id}/notification-masks/batch-query

ces:alarms:listNotificationMaskRules

-

GET /v2/{project_id}/notification-masks/{notification_mask_id}/resources

ces:alarms:listNotificationMaskResources

-

POST /v2/{project_id}/dashboards

ces:dashboards:create

-

GET /v2/{project_id}/dashboards

ces:dashboards:list

-

PUT /v2/{project_id}/dashboards/{dashboard_id}

ces:dashboards:put

-

POST /v2/{project_id}/dashboards/batch-delete

ces:dashboards:delete

-

POST /v2/{project_id}/dashboards/{dashboard_id}/widgets

ces:widgets:create

-

GET /v2/{project_id}/dashboards/{dashboard_id}/widgets

ces:widgets:list

-

GET /v2/{project_id}/widgets/{widget_id}

ces:widgets:get

-

DELETE /v2/{project_id}/widgets/{widget_id}

ces:widgets:delete

-

POST /v2/{project_id}/widgets/batch-update

ces:widgets:put

-

GET /v2/{project_id}/{resource_type}/tags

ces:tags:list

-

GET /v2/{project_id}/instances/{instance_id}/agent-dimensions

ces:namespacesDimensions:listAgentDimensions

-

POST /v2/{project_id}/batch-query-metric-data

ces:metricData:list

-

POST /v3/{project_id}/agent-status/batch-query

ces:agent:listStatuses

-

GET /v3/{project_id}/agent-invocations

ces:agent:listTaskInvocations

-

POST /v3/{project_id}/agent-invocations/batch-create

ces:agent:createAgentInvocations

-

资源类型(Resource)

资源类型(Resource)表示身份策略所作用的资源。如表3中的某些操作指定了可以在该操作指定的资源类型,则必须在具有该操作的身份策略语句中指定该资源的URN,身份策略仅作用于此资源;如未指定,Resource默认为“*”,则身份策略将应用到所有资源。您也可以在身份策略中设置条件,从而指定资源类型。

CES定义了以下可以在身份策略的Resource元素中使用的资源类型。

表3 CES支持的资源类型

资源类型

URN

alarm

ces:<region>:<account-id>:alarm:<alarm-id>

dashboard

ces:<region>:<account-id>:dashboard:<dashboard-id>

条件(Condition)

条件键概述

条件(Condition)是身份策略生效的特定条件,包括条件键运算符

  • 条件键表示身份策略语句的Condition元素中的键值。根据适用范围,分为全局级条件键和服务级条件键。
    • 全局级条件键(前缀为g:)适用于所有操作,在鉴权过程中,云服务不需要提供用户身份信息,系统将自动获取并鉴权。CES服务适用除g:requetedRegion条件键外所有服务的全局条件键,详情请参见:全局条件键

      CES有提供全局服务的能力(例如:告警通知、任务中心),所以按全局级服务处理,不支持g:RequetedRegion全局条件键。

    • 服务级条件键(前缀通常为服务缩写,如ces:)仅适用于对应服务的操作,详情请参见表4
    • 单值/多值表示API调用时请求中与条件关联的值数。单值条件键在API调用时的请求中最多包含一个值,多值条件键在API调用时请求可以包含多个值。例如:g:SourceVpce是单值条件键,表示仅允许通过某个VPC终端节点发起请求访问某资源,一个请求最多包含一个VPC终端节点ID值。g:TagKeys是多值条件键,表示请求中携带的所有标签的key组成的列表,当用户在调用API请求时传入标签可以传入多个值。
  • 运算符与条件键、条件值一起构成完整的条件判断语句,当请求信息满足该条件时,身份策略才能生效。支持的运算符请参见:运算符

ces支持的服务级条件键

ces定义了以下可以在自定义身份策略的Condition元素中使用的条件键,您可以使用这些条件键进一步细化身份策略语句应用的条件。

表4 ces支持的服务级条件键

服务级条件键

类型

单值/多值

说明

ces:namespace

string

多值

根据请求参数中指定的命名空间过滤访问。具体操作请参见按云服务粒度给用户授权

相关文档