

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

# 的操作、资源和条件键 Amazon X-Ray
<a name="list_xray"></a>

Amazon X-Ray （服务前缀： `xray`) 提供以下特定服务的操作、资源、操作和条件密钥，用于 IAM 权限策略。

参考：
+ 了解如何[配置该服务](https://docs.amazonaws.cn/xray/latest/devguide/)。
+ 查看[适用于该服务的 API 操作列表](https://docs.amazonaws.cn/xray/latest/api/)。
+ 了解如何[使用 IAM](https://docs.amazonaws.cn/xray/latest/devguide/security_iam_service-with-iam.html) 权限策略保护该服务及其资源。
+ 查看 [编程服务授权参考](https://servicereference.us-east-1.amazonaws.com/v1/xray/xray.json) 用于此服务。

**Topics**
+ [API 操作定义为 Amazon X-Ray](#list_xray-operations)
+ [动作定义为 Amazon X-Ray](#list_xray-actions-as-permissions)
+ [Permission-only 的操作 Amazon X-Ray](#list_xray-permission-only-actions)
+ [资源类型定义为 Amazon X-Ray](#list_xray-resources-for-iam-policies)
+ [的条件密钥 Amazon X-Ray](#list_xray-policy-keys)

## API 操作定义为 Amazon X-Ray
<a name="list_xray-operations"></a>

下表将 API 操作映射到它们授权的 IAM 操作。仅列出具有给定 API 和操作静态值的条件密钥；有关每个操作支持的全套条件密钥，请参阅 [操作表](#list_xray-actions-as-permissions)。




- **   BatchGetTraces  **
  - **IAM 操作:**  [xray:BatchGetTraces](#list_xray-action-BatchGetTraces) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 列表

- **   CancelTraceRetrieval  **
  - **IAM 操作:**  [xray:CancelTraceRetrieval](#list_xray-action-CancelTraceRetrieval) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   CreateGroup  **
  - **IAM 操作:**  [xray:CreateGroup](#list_xray-action-CreateGroup)  / **条件键:**  / **可能的值:**  / **访问级别:** 写入
  - **IAM 操作:**  [xray:TagResource](#list_xray-action-TagResource)  / **条件键:**  / **可能的值:**  / **访问级别:** 标记、写入

- **   CreateSamplingRule  **
  - **IAM 操作:**  [xray:CreateSamplingRule](#list_xray-action-CreateSamplingRule)  / **条件键:**  / **可能的值:**  / **访问级别:** 写入
  - **IAM 操作:**  [xray:TagResource](#list_xray-action-TagResource)  / **条件键:**  / **可能的值:**  / **访问级别:** 标记、写入

- **   DeleteGroup  **
  - **IAM 操作:**  [xray:DeleteGroup](#list_xray-action-DeleteGroup) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   DeleteResourcePolicy  **
  - **IAM 操作:**  [xray:DeleteResourcePolicy](#list_xray-action-DeleteResourcePolicy) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   DeleteSamplingRule  **
  - **IAM 操作:**  [xray:DeleteSamplingRule](#list_xray-action-DeleteSamplingRule) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   GetEncryptionConfig  **
  - **IAM 操作:**  [xray:GetEncryptionConfig](#list_xray-action-GetEncryptionConfig) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetGroup  **
  - **IAM 操作:**  [xray:GetGroup](#list_xray-action-GetGroup) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetGroups  **
  - **IAM 操作:**  [xray:GetGroups](#list_xray-action-GetGroups) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetIndexingRules  **
  - **IAM 操作:**  [xray:GetIndexingRules](#list_xray-action-GetIndexingRules) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetInsight  **
  - **IAM 操作:**  [xray:GetInsight](#list_xray-action-GetInsight) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetInsightEvents  **
  - **IAM 操作:**  [xray:GetInsightEvents](#list_xray-action-GetInsightEvents) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetInsightImpactGraph  **
  - **IAM 操作:**  [xray:GetInsightImpactGraph](#list_xray-action-GetInsightImpactGraph) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetInsightSummaries  **
  - **IAM 操作:**  [xray:GetInsightSummaries](#list_xray-action-GetInsightSummaries) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetRetrievedTracesGraph  **
  - **IAM 操作:**  [xray:GetRetrievedTracesGraph](#list_xray-action-GetRetrievedTracesGraph) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetSamplingRules  **
  - **IAM 操作:**  [xray:GetSamplingRules](#list_xray-action-GetSamplingRules) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetSamplingStatisticSummaries  **
  - **IAM 操作:**  [xray:GetSamplingStatisticSummaries](#list_xray-action-GetSamplingStatisticSummaries) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetSamplingTargets  **
  - **IAM 操作:**  [xray:GetSamplingTargets](#list_xray-action-GetSamplingTargets) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetServiceGraph  **
  - **IAM 操作:**  [xray:GetServiceGraph](#list_xray-action-GetServiceGraph) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetTimeSeriesServiceStatistics  **
  - **IAM 操作:**  [xray:GetTimeSeriesServiceStatistics](#list_xray-action-GetTimeSeriesServiceStatistics) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetTraceGraph  **
  - **IAM 操作:**  [xray:GetTraceGraph](#list_xray-action-GetTraceGraph) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetTraceSegmentDestination  **
  - **IAM 操作:**  [xray:GetTraceSegmentDestination](#list_xray-action-GetTraceSegmentDestination) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetTraceSummaries  **
  - **IAM 操作:**  [xray:GetTraceSummaries](#list_xray-action-GetTraceSummaries) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   ListResourcePolicies  **
  - **IAM 操作:**  [xray:ListResourcePolicies](#list_xray-action-ListResourcePolicies) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 列表

- **   ListRetrievedTraces  **
  - **IAM 操作:**  [xray:ListRetrievedTraces](#list_xray-action-ListRetrievedTraces) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 列表

- **   ListTagsForResource  **
  - **IAM 操作:**  [xray:ListTagsForResource](#list_xray-action-ListTagsForResource) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 列表

- **   PutEncryptionConfig  **
  - **IAM 操作:**  [xray:PutEncryptionConfig](#list_xray-action-PutEncryptionConfig) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 权限管理，写入

- **   PutResourcePolicy  **
  - **IAM 操作:**  [xray:PutResourcePolicy](#list_xray-action-PutResourcePolicy) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   PutTelemetryRecords  **
  - **IAM 操作:**  [xray:PutTelemetryRecords](#list_xray-action-PutTelemetryRecords) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   PutTraceSegments  **
  - **IAM 操作:**  [xray:PutTraceSegments](#list_xray-action-PutTraceSegments) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   StartTraceRetrieval  **
  - **IAM 操作:**  [xray:StartTraceRetrieval](#list_xray-action-StartTraceRetrieval) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   TagResource  **
  - **IAM 操作:**  [xray:TagResource](#list_xray-action-TagResource) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 标记、写入

- **   UntagResource  **
  - **IAM 操作:**  [xray:UntagResource](#list_xray-action-UntagResource) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 标记、写入

- **   UpdateGroup  **
  - **IAM 操作:**  [xray:UpdateGroup](#list_xray-action-UpdateGroup) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   UpdateIndexingRule  **
  - **IAM 操作:**  [xray:UpdateIndexingRule](#list_xray-action-UpdateIndexingRule) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   UpdateSamplingRule  **
  - **IAM 操作:**  [xray:UpdateSamplingRule](#list_xray-action-UpdateSamplingRule) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   UpdateTraceSegmentDestination  **
  - **IAM 操作:**  [xray:UpdateTraceSegmentDestination](#list_xray-action-UpdateTraceSegmentDestination) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入



## 动作定义为 Amazon X-Ray
<a name="list_xray-actions-as-permissions"></a>

您可以在 IAM 策略语句的 `Action` 元素中指定以下操作。对于每个操作，该表列出了该操作支持的资源类型和条件键。可以使用策略授予在 Amazon中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。




- **   [BatchGetTraces](https://docs.amazonaws.cn/xray/latest/api/API_BatchGetTraces.html)  **
  - **说明:** 授予权限以检索按 ID 指定的跟踪列表。每个跟踪是一组分段文档，由单个请求生成。使用 GetTraceSummaries 获取跟踪 ID 列表
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 列表

- **   [CancelTraceRetrieval](API_CancelTraceRetrieval.html)  **
  - **说明:** 授予取消由发起的正在进行的跟踪检索任务的权限 StartTraceRetrieval 使用提供的 RetrievalToken。成功取消将返回 HTTP 200 响应
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [CreateGroup](https://docs.amazonaws.cn/xray/latest/api/API_CreateGroup.html)  **
  - **说明:** 授予权限以使用名称和筛选条件表达式创建组资源
  - **资源类型（\* 为必需）:** [group\*](#list_xray-resource-group)
  - **条件键:** [aws:RequestTag/${TagKey}](#list_xray-aws_RequestTag___TagKey_)<br />[aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_xray-aws_TagKeys)
  - **访问级别:** Write

- **   [CreateSamplingRule](https://docs.amazonaws.cn/xray/latest/api/API_CreateSamplingRule.html)  **
  - **说明:** 授予权限以创建规则，用于控制分析的应用程序的采样行为
  - **资源类型（\* 为必需）:** [sampling-rule\*](#list_xray-resource-sampling-rule)
  - **条件键:** [aws:RequestTag/${TagKey}](#list_xray-aws_RequestTag___TagKey_)<br />[aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_xray-aws_TagKeys)
  - **访问级别:** Write

- **   [DeleteGroup](https://docs.amazonaws.cn/xray/latest/api/API_DeleteGroup.html)  **
  - **说明:** 授予权限以删除组资源
  - **资源类型（\* 为必需）:** [group\*](#list_xray-resource-group)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [DeleteResourcePolicy](https://docs.amazonaws.cn/xray/latest/api/API_DeleteResourcePolicy.html)  **
  - **说明:** 授予权限以删除资源策略
  - **资源类型（\* 为必需）:** 
  - **条件键:** [xray:ResourcePolicyName](#list_xray-xray_ResourcePolicyName)
  - **访问级别:** 写入

- **   [DeleteSamplingRule](https://docs.amazonaws.cn/xray/latest/api/API_DeleteSamplingRule.html)  **
  - **说明:** 授予权限以删除采样规则
  - **资源类型（\* 为必需）:** [sampling-rule\*](#list_xray-resource-sampling-rule)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [GetEncryptionConfig](https://docs.amazonaws.cn/xray/latest/api/API_GetEncryptionConfig.html)  **
  - **说明:** 授予检索当前加密配置的权限 X-Ray 数据
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [GetGroup](https://docs.amazonaws.cn/xray/latest/api/API_GetGroup.html)  **
  - **说明:** 授予权限以检索组资源详细信息
  - **资源类型（\* 为必需）:** [group\*](#list_xray-resource-group)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)
  - **访问级别:** Read

- **   [GetGroups](https://docs.amazonaws.cn/xray/latest/api/API_GetGroups.html)  **
  - **说明:** 授予权限以检索所有活动组详细信息
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [GetIndexingRules](https://docs.amazonaws.cn/xray/latest/api/API_GetIndexingRules.html)  **
  - **说明:** 授予权限以检索所有索引规则。索引规则用于确定通过以下方式摄取的跨度的服务器端采样率 CloudWatchLogs 目标和索引依据 X-Ray
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [GetInsight](https://docs.amazonaws.cn/xray/latest/api/API_GetInsight.html)  **
  - **说明:** 授予权限以检索特定见解的详细信息
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetInsightEvents](https://docs.amazonaws.cn/xray/latest/api/API_GetInsightEvents.html)  **
  - **说明:** 授予权限以检索特定见解的事件
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetInsightImpactGraph](https://docs.amazonaws.cn/xray/latest/api/API_GetInsightImpactGraph.html)  **
  - **说明:** 授予权限以检索服务图中受特定见解影响的部分
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetInsightSummaries](https://docs.amazonaws.cn/xray/latest/api/API_GetInsightSummaries.html)  **
  - **说明:** 授予权限以使用可选筛选器，按照组和时间范围检索所有见解的摘要
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [GetRetrievedTracesGraph](API_GetRetrievedTracesGraph.html)  **
  - **说明:** 授予根据指定内容检索服务图以获取跟踪的权限 RetrievalToken 来自交易搜索 CloudWatch 日志组
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [GetSamplingRules](https://docs.amazonaws.cn/xray/latest/api/API_GetSamplingRules.html)  **
  - **说明:** 授予权限以检索所有采样规则
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetSamplingStatisticSummaries](https://docs.amazonaws.cn/xray/latest/api/API_GetSamplingStatisticSummaries.html)  **
  - **说明:** 授予权限以检索有关所有采样规则的最新采样结果的信息
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetSamplingTargets](https://docs.amazonaws.cn/xray/latest/api/API_GetSamplingTargets.html)  **
  - **说明:** 授予权限以请求服务用于采样请求的规则的采样配额
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetServiceGraph](https://docs.amazonaws.cn/xray/latest/api/API_GetServiceGraph.html)  **
  - **说明:** 授予权限以检索文档，其中包含处理传入请求的服务，以及这些请求作为结果调用的下游服务的介绍
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetTimeSeriesServiceStatistics](https://docs.amazonaws.cn/xray/latest/api/API_GetTimeSeriesServiceStatistics.html)  **
  - **说明:** 授予权限以获取按时间间隔划分的特定时间范围定义的服务统计数据的聚合
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** Read

- **   [GetTraceGraph](https://docs.amazonaws.cn/xray/latest/api/API_GetTraceGraph.html)  **
  - **说明:** 授予权限以检索一个或多个特定跟踪 ID 的服务图形
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [GetTraceSegmentDestination](https://docs.amazonaws.cn/xray/latest/api/API_GetTraceSegmentDestination.html)  **
  - **说明:** 授予权限以检索发送到的数据的当前目的地 PutTraceSegments 和 OpenTelemetry API
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [GetTraceSummaries](https://docs.amazonaws.cn/xray/latest/api/API_GetTraceSummaries.html)  **
  - **说明:** 授予权限以使用可选筛选条件，检索指定时间段内可用的跟踪 ID 和元数据。要获取完整跟踪，请将跟踪 ID 传递给 BatchGetTraces
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [ListResourcePolicies](https://docs.amazonaws.cn/xray/latest/api/API_ListResourcePolicies.html)  **
  - **说明:** 授予权限以列出资源策略
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 列表

- **   [ListRetrievedTraces](API_ListRetrievedTraces.html)  **
  - **说明:** 授予检索给定跟踪列表的权限 RetrievalToken 来自交易搜索 CloudWatch 日志组
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 列表

- **   [ListTagsForResource](https://docs.amazonaws.cn/xray/latest/api/API_ListTagsForResource.html)  **
  - **说明:** 授予列出标签的权限 X-Ray 资源
  - **资源类型（\* 为必需）:** [group](#list_xray-resource-group) / **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)
  - **资源类型（\* 为必需）:** [sampling-rule](#list_xray-resource-sampling-rule) / **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)
  - **访问级别:** 列表

- **   [PutEncryptionConfig](https://docs.amazonaws.cn/xray/latest/api/API_PutEncryptionConfig.html)  **
  - **说明:** 授予更新加密配置的权限 X-Ray 数据
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 权限管理，写入

- **   [PutResourcePolicy](https://docs.amazonaws.cn/xray/latest/api/API_PutResourcePolicy.html)  **
  - **说明:** 授予权限以创建或更新资源策略
  - **资源类型（\* 为必需）:** 
  - **条件键:** [xray:ResourcePolicyName](#list_xray-xray_ResourcePolicyName)
  - **访问级别:** 写入

- **   [PutSpans](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html)  **
  - **说明:** 授予上传权限 OpenTelemetry 跨度到 Amazon X-Ray
  - **资源类型（\* 为必需）:** 
  - **条件键:** [logs:LogGeneratingResourceArns](#list_xray-logs_LogGeneratingResourceArns)
  - **访问级别:** 写入

- **   [PutTelemetryRecords](https://docs.amazonaws.cn/xray/latest/api/API_PutTelemetryRecords.html)  **
  - **说明:** 授予发送权限 Amazon X-Ray 守护程序对服务进行遥测
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 写入

- **   [PutTraceSegments](https://docs.amazonaws.cn/xray/latest/api/API_PutTraceSegments.html)  **
  - **说明:** 授予将区段文档上传到的权限 Amazon X-Ray。这个 X-Ray SDK 生成区段文档并将其发送到 X-Ray 守护程序，它会批量上传它们
  - **资源类型（\* 为必需）:** 
  - **条件键:** [logs:LogGeneratingResourceArns](#list_xray-logs_LogGeneratingResourceArns)
  - **访问级别:** 写入

- **   [StartTraceRetrieval](API_StartTraceRetrieval)  **
  - **说明:** 授予使用指定时间范围和交易搜索上给定跟踪 ID 启动跟踪检索过程的权限 CloudWatch 日志组
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 读取

- **   [TagResource](https://docs.amazonaws.cn/xray/latest/api/API_TagResource.html)  **
  - **说明:** 授予向添加标签的权限 X-Ray 资源
  - **资源类型（\* 为必需）:** [group](#list_xray-resource-group) / **条件键:** [aws:RequestTag/${TagKey}](#list_xray-aws_RequestTag___TagKey_)<br />[aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_xray-aws_TagKeys)
  - **资源类型（\* 为必需）:** [sampling-rule](#list_xray-resource-sampling-rule) / **条件键:** [aws:RequestTag/${TagKey}](#list_xray-aws_RequestTag___TagKey_)<br />[aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_xray-aws_TagKeys)
  - **访问级别:** 标记、写入

- **   [UntagResource](https://docs.amazonaws.cn/xray/latest/api/API_UntagResource.html)  **
  - **说明:** 授予从中移除标签的权限 X-Ray 资源
  - **资源类型（\* 为必需）:** [group](#list_xray-resource-group) / **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_xray-aws_TagKeys)
  - **资源类型（\* 为必需）:** [sampling-rule](#list_xray-resource-sampling-rule) / **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_xray-aws_TagKeys)
  - **访问级别:** 标记、写入

- **   [UpdateGroup](https://docs.amazonaws.cn/xray/latest/api/API_UpdateGroup.html)  **
  - **说明:** 授予权限以更新组资源
  - **资源类型（\* 为必需）:** [group\*](#list_xray-resource-group)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [UpdateIndexingRule](https://docs.amazonaws.cn/xray/latest/api/API_UpdateIndexingRule.html)  **
  - **说明:** 授予权限以修改索引规则的配置
  - **资源类型（\* 为必需）:** 
  - **条件键:**  
  - **访问级别:** 写入

- **   [UpdateSamplingRule](https://docs.amazonaws.cn/xray/latest/api/API_UpdateSamplingRule.html)  **
  - **说明:** 授予权限以修改采样规则的配置
  - **资源类型（\* 为必需）:** [sampling-rule\*](#list_xray-resource-sampling-rule)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [UpdateTraceSegmentDestination](https://docs.amazonaws.cn/xray/latest/api/API_UpdateTraceSegmentDestination.html)  **
  - **说明:** 授予修改发送到的数据目的地的权限 PutTraceSegments 和 OpenTelemetry API
  - **资源类型（\* 为必需）:** 
  - **条件键:** [xray:TraceSegmentDestination](#list_xray-xray_TraceSegmentDestination)
  - **访问级别:** 写入



## Permission-only 的操作 Amazon X-Ray
<a name="list_xray-permission-only-actions"></a>

以下操作定义为 Amazon X-Ray 但不能通过任何 API 操作直接调用。它们只能在 IAM 政策声明中用于授予或拒绝权限。



| 操作 | 说明 | 资源类型（\* 为必需） | 条件键 | 访问级别 | 
| --- | --- | --- | --- | --- | 
|   [BatchGetTraceSummaryById](https://docs.amazonaws.cn/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console)  | 授予权限以检索 ID 指定的跟踪列表的元数据 |  |   | 读取 | 
|   [CallWithBearerToken](https://docs.amazonaws.cn/xray/latest/devguide/security_iam_service-with-iam.html)  | 授予对请求进行身份验证的权限 Amazon X-Ray 使用不记名代币 |  |   | 写入 | 
|   [GetDistinctTraceGraphs](https://docs.amazonaws.cn/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console)  | 授予权限以检索一个或多个特定跟踪 ID 的不同服务图 |  |   | 读取 | 
|   [Link](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account-Setup.html#CloudWatch-Unified-Cross-Account-Setup-permissions)  | 授予共享权限 X-Ray 带有监控账户的资源 |  |   | 写入 | 
|   [PutSpansForIndexing](https://docs.amazonaws.cn/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console)  | 授予将跨度上传到的权限 Amazon X-Ray 待编入索引 |  |   | 写入 | 

## 资源类型定义为 Amazon X-Ray
<a name="list_xray-resources-for-iam-policies"></a>

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 `Resource` 元素中使用这些资源类型。



| 资源类型 | ARN | 条件键 | 
| --- | --- | --- | 
|  [group](https://docs.amazonaws.cn/xray/latest/devguide/xray-concepts.html#xray-concepts-groups)  | arn:${Partition}:xray:${Region}:${Account}:group/${GroupName}/${Id} | [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_) | 
|  [sampling-rule](https://docs.amazonaws.cn/xray/latest/devguide/xray-concepts.html#xray-concepts-sampling)  | arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName} | [aws:ResourceTag/${TagKey}](#list_xray-aws_ResourceTag___TagKey_) | 

## 的条件密钥 Amazon X-Ray
<a name="list_xray-policy-keys"></a>

Amazon X-Ray 定义了以下条件密钥，这些密钥可用于 `Condition` IAM 政策的元素。



| 条件键 | 描述 | 类型 | 
| --- | --- | --- | 
|   [aws:RequestTag/${TagKey}](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag)  | 按请求中传递的标签筛选访问权限 | String | 
|   [aws:ResourceTag/${TagKey}](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag)  | 按与资源关联的标签筛选访问权限 | String | 
|   [aws:TagKeys](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys)  | 按请求中传递的标签键筛选访问权限 | ArrayOfString | 
|   [logs:LogGeneratingResourceArns](https://docs.amazonaws.cn/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions)  | 筛选访问依据 LogGeneratingResourceArn 在请求中 | ArrayOfARN | 
|   [xray:ResourcePolicyName](https://docs.amazonaws.cn/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions)  | 按以下条件筛选访问权限 PolicyName 在请求中 | String | 
|   [xray:TraceSegmentDestination](https://docs.amazonaws.cn/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions)  | 按以下条件筛选访问权限 TraceSegmentDestination 键入请求 | String | 