更新时间:2026-04-15 GMT+08:00
分享

身份策略授权参考

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

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

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

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

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

操作(Action)

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

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

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

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

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

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

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

表1 AgentArts支持的授权项

授权项

描述

访问级别

资源类型(*为必须)

条件键

别名

agentarts::showOpsAgentMetric

授予权限以查询时间范围内智能体的总数和草稿数和发布态数。

Read

-

-

-

agentarts::createOpsAgentObservation

授予权限以创建智能体可观测信息

Write

-

-

-

agentarts::deleteOpsAgentObservation

授予权限以删除创建的智能体可观测信息

Write

-

-

-

agentarts::listOpsAgentObservation

授予权限以查询智能体可观测列表

List

-

-

-

agentarts::updateOpsAgentObservation

授予权限以更新智能体可观测信息

Write

-

-

-

agentarts::showOpsAgentMetricTrend

授予权限以查询时间范围内的某个指标的趋势图

Read

-

-

-

agentarts::showOpsAgentMetricTopN

授予权限以查询时间范围内某个指标的topN

Read

-

-

-

agentarts::showOpsAgentMetricGauge

授予权限以查询时间范围内某个指标的仪表盘

Read

-

-

-

agentarts:opsAgent:showOpsAgentSpanMetric

授予权限以查询智能体某个调用链span指标集合

List

-

-

-

agentarts::tagOpsTraceLabel

授予权限以给trace数据打标签

Write

-

-

-

agentarts::updateOpsTraceFeedback

授予权限以给trace数据点赞点踩

Write

-

-

-

agentarts::listOpsTrace

授予权限以查询trace列表

List

-

-

-

agentarts::showOpsTrace

授予权限以查询调用链详细信息

Read

-

-

-

agentarts::showOpsTraceTopology

授予权限以查询trace拓扑信息

Read

-

-

-

agentarts::listOpsSession

授予权限以查询会话列表

List

-

-

-

agentarts::showOpsSession

授予权限以查询会话详情

Read

-

-

-

agentarts::subscribeOpsObservation

授予权限以开通可观测服务

Write

-

-

-

agentarts::unsubscribeOps

授予权限以退订可观测服务

Write

-

-

-

agentarts::showOpsSubscriptionInfo

授予权限以查询租户关联的AOM APM LTS信息

Read

-

-

-

agentarts::showOpsSubscriptionApmInfo

授予权限以查询租户关联的APM信息

Read

-

-

-

agentarts::showOpsSubscriptionAomInfo

授予权限以查询租户关联的AOM信息

Read

-

-

-

agentarts::showOpsSubscriptionLtsInfo

授予权限以查询租户关联的日志组日志流信息

Read

-

-

-

agentarts::listOpsAgentLog

授予权限以根据条件查询日志

List

-

-

-

agentarts::listOpsAgentRuntLog

授予权限以查询agentRun的日志

List

-

-

-

agentarts::listOpsAgentSpanMetric

授予权限以查询调用链span指标

Read

-

-

-

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

表2 API与授权项的关系

API

对应的授权项

依赖的授权项

GET /v1/ops/observation/agents/metric

agentarts::showOpsAgentMetric

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get
  • aom:metric:list

POST /v1/ops/observation/agents

agentarts::createOpsAgentObservation

-

DELETE /v1/ops/observation/agents/{agent_id}

agentarts::deleteOpsAgentObservation

-

GET /v1/ops/observation/agents

agentarts::listOpsAgentObservation

-

PUT /v1/ops/observation/agents/{agent_id}

agentarts::updateOpsAgentObservation

-

POST /v1/ops/observation/agents/metric/trend

agentarts::showOpsAgentMetricTrend

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get
  • aom:metric:list

POST /v1/ops/observation/agents/metric/topn

agentarts::showOpsAgentMetricTopN

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get
  • aom:metric:list
  • agentArts:studioModelProvider:listStudioModels

POST /v1/ops/observation/agents/metric/gauge

agentarts::showOpsAgentMetricGauge

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get
  • aom:metric:list

POST /v1/ops/observation/traces/{trace_id}/label

agentarts::tagOpsTraceLabel

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get

PUT /v1/ops/observation/traces/{trace_id}/feedback

agentarts::updateOpsTraceFeedback

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get

POST /v1/ops/observation/traces

agentarts::listOpsTrace

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get

GET /v1/ops/observation/traces/{trace_id}

agentarts::showOpsTrace

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get
  • agentArts:studioModelProvider:listStudioModels

-

agentarts::showOpsTraceTopology

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get

POST /v1/ops/observation/sessions

agentarts::listOpsSession

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get

GET /v1/ops/observation/sessions/{session_id}

agentarts::showOpsSession

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get

-

agentarts::subscribeOpsObservation

  • apm::createConf
  • apm::createAdminInfo
  • apm:application:list
  • aom:billing:set
  • aom:prometheusInstance:list
  • aom:prometheusInstance:create
  • aom:icmgr:get
  • aom:icmgr:update
  • lts:logGroup:createLogGroup
  • lts:logGroup:listLogGroup
  • lts:logStream:createLogStream
  • lts:logStream:listLogStream\

-

agentarts::unsubscribeOps

-

GET /v1/ops/observation/subscription

agentarts::showOpsSubscriptionInfo

-

GET /v1/ops/observation/subscription/apm

agentarts::showOpsSubscriptionApmInfo

-

GET /v1/ops/observation/subscription/aom

agentarts::showOpsSubscriptionAomInfo

-

GET /v1/ops/observation/agents/{agent_id}/subscription/lts

agentarts::showOpsSubscriptionLtsInfo

-

GET /v1/ops/observation/agent/{agent_id}/log

agentarts::listOpsAgentLog

  • lts:logStream:searchLog
  • lts:logStream:listLogStream

GET /v1/ops/observation/agent-run/{agent_run_id}/log

agentarts::listOpsAgentRuntLog

  • lts:logStream:searchLog
  • lts:logStream:listLogStream

GET /v1/ops/observation/agent/{agent_id}/span/{span_name}/metrics

agentarts::listOpsAgentSpanMetric

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get
  • aom:metric:list

资源类型(Resource)

AgentArts服务不支持在身份策略中的资源中指定资源进行权限控制。如需允许访问AgentArts服务,请在身份策略的Resource元素中使用通配符号*,表示身份策略将应用到所有资源。

条件(Condition)

AgentArts服务不支持在身份策略中的条件键中配置服务级的条件键。AgentArts可以使用适用于所有服务的全局条件键,请参考全局条件键

相关文档