AWS X-Ray 的操作、资源和条件键 - 服务授权参考
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS X-Ray 的操作、资源和条件键

AWS X-Ray(服务前缀:xray)提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考:

AWS X-Ray 定义的操作

您可以在 Action 策略语句的 IAM 元素中指定以下操作。可以使用策略授予在 AWS 中执行操作的权限。您在策略中使用一项操作时,通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource 元素中指定所有资源(“*”)。如果该列包含一种资源类型,则可以在含有该操作的语句中指定该类型的 ARN。必需资源在表中以星号 (*) 表示。如果在使用该操作的语句中指定资源级权限 ARN,则它必须属于该类型。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种类型而不使用其他类型。

有关下表中各列的详细信息,请参阅 操作表

操作 描述 访问级别 资源类型(* 为必需) 条件键 相关操作
BatchGetTraces 授予权限以检索按 ID 指定的跟踪列表。每个跟踪是一组分段文档,由单个请求生成。使用 GetTraceSummaries 获取跟踪 ID 的列表 List
CreateGroup 授予权限以使用名称和筛选条件表达式创建组资源 写入

group*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSamplingRule 授予权限以创建规则,用于控制分析的应用程序的采样行为 写入

sampling-rule*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteGroup 授予权限以删除组资源 写入

group*

aws:ResourceTag/${TagKey}

DeleteSamplingRule 授予权限以删除采样规则 写入

sampling-rule*

aws:ResourceTag/${TagKey}

GetEncryptionConfig 授予权限以检索 X-Ray 数据的当前加密配置 Read
GetGroup 授予权限以检索组资源详细信息 Read

group*

aws:ResourceTag/${TagKey}

GetGroups 授予权限以检索所有活动组详细信息 Read
GetInsight 授予权限以检索特定见解的详细信息 Read
GetInsightEvents 授予权限以检索特定见解的事件 Read
GetInsightImpactGraph 授予权限以检索服务图中受特定见解影响的部分 Read
GetInsightSummaries 授予权限以使用可选筛选器,按照组和时间范围检索所有见解的摘要 Read
GetSamplingRules 授予权限以检索所有采样规则 Read
GetSamplingStatisticSummaries 授予权限以检索有关所有采样规则的最新采样结果的信息 Read
GetSamplingTargets 授予权限以请求服务用于采样请求的规则的采样配额 Read
GetServiceGraph 授予权限以检索文档,其中包含处理传入请求的服务,以及这些请求作为结果调用的下游服务的介绍 Read
GetTimeSeriesServiceStatistics 授予权限以获取按时间间隔划分的特定时间范围定义的服务统计数据的聚合 Read
GetTraceGraph 授予权限以检索一个或多个特定跟踪 ID 的服务图形 Read
GetTraceSummaries 授予权限以使用可选筛选条件,检索指定时间段内可用的跟踪 ID 和元数据。要获得完整跟踪,请将跟踪 ID 传递至 BatchGetTraces Read
ListTagsForResource 授予权限以列出 X-Ray 资源的标签 List

group

sampling-rule

PutEncryptionConfig 授予权限以更新 X-Ray 数据加密配置 权限管理
PutTelemetryRecords 授予权限以向服务发送 AWS X-Ray 守护程序遥测 写入
PutTraceSegments 授予权限以将分段文档发送到 AWS X-Ray。X-Ray 开发工具包生成分段文档并发送给 X-Ray 守护程序,再由守护程序批量上传 写入
TagResource 授予权限以将标签添加到 X-Ray 资源中 标记

group

sampling-rule

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource 授予权限以从 X-Ray 资源中删除标签 标记

group

sampling-rule

aws:TagKeys

UpdateGroup 授予权限以更新组资源 写入

group*

aws:ResourceTag/${TagKey}

UpdateSamplingRule 授予权限以修改采样规则的配置 写入

sampling-rule*

aws:ResourceTag/${TagKey}

AWS X-Ray 定义的资源类型

以下资源类型是由该服务定义的,可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键,从而定义资源类型。这些键显示在表的最后一列。有关下表中各列的详细信息,请参阅 资源类型表

资源类型 ARN 条件键
group arn:${Partition}:xray:${Region}:${Account}:group/${GroupName}/${Id}

aws:ResourceTag/${TagKey}

sampling-rule arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName}

aws:ResourceTag/${TagKey}

AWS X-Ray 的条件键

AWS X-Ray 定义以下可以在 IAM 策略的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息,请参阅 条件键表

要查看适用于所有服务的全局条件键,请参阅可用的全局条件键

条件键 描述 类型
aws:RequestTag/${TagKey} 根据在请求中传递的标签筛选操作 字符串
aws:ResourceTag/${TagKey} 根据与资源关联的标签筛选操作 字符串
aws:TagKeys 根据在请求中传递的标签键筛选操作 字符串