AWS X-Ray 的動作、資源和條件索引鍵 - 服務授權參考
動作資源類型條件索引鍵

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS X-Ray 的動作、資源和條件索引鍵

AWS X-Ray （服務字首：xray) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

AWS X-Ray 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作 描述 存取層級 資源類型 (*必填項目) 條件索引鍵 相依動作
BatchGetTraceSummaryById [僅限許可] 准許擷取 ID 所指定的追蹤清單中繼資料 讀取
BatchGetTraces 准許擷取 ID 所指定的追蹤清單。每個追蹤是從單一請求發出的區段文件集合。使用 GetTraceSummaries 取得追蹤 ID 的清單。 清單
CancelTraceRetrieval 准許使用提供的 RetrievalToken 取消 StartTraceRetrieval 啟動的持續追蹤擷取任務。成功取消將傳回 HTTP 200 回應 讀取
CreateGroup 准許使用名稱和篩選運算式建立群組資源 寫入

group*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSamplingRule 准許建立規則來控制儀器應用程式取樣行為 寫入

sampling-rule*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteGroup 准許刪除資源政策 寫入

group*

aws:ResourceTag/${TagKey}

DeleteResourcePolicy 准許刪除資源政策 寫入
DeleteSamplingRule 授予刪除抽樣規則的許可 寫入

sampling-rule*

aws:ResourceTag/${TagKey}

GetDistinctTraceGraphs [僅限許可] 准許擷取一或多個特定追蹤 ID 的不同服務圖形 讀取
GetEncryptionConfig 准許擷取 X-Ray 資料目前的加密組態 讀取
GetGroup 准許擷取群組資源詳細資料 讀取

group*

aws:ResourceTag/${TagKey}

GetGroups 准許擷取所有使用中群組詳細資料 讀取
GetIndexingRules 准許擷取所有索引規則。索引規則用於判斷透過 CloudWatchLogs 目的地擷取並由 X-Ray 編製索引之範圍的伺服器端取樣率 讀取
GetInsight 准許擷取特定洞見詳細資料 讀取
GetInsightEvents 准許擷取特定洞見事件 讀取
GetInsightImpactGraph 准許擷取受特定洞見影響的服務圖形部分 讀取
GetInsightSummaries 准許使用選用篩選器擷取群組和時間範圍的所有洞見摘要 讀取
GetRetrievedTracesGraph 准許從交易搜尋 CloudWatch 日誌群組，根據指定的 RetrievalToken 擷取追蹤的服務圖表 讀取
GetSamplingRules 准許擷取所有抽樣規則 讀取
GetSamplingStatisticSummaries 授予擷取有關所有抽樣規則之最近抽樣結果的許可 讀取
GetSamplingTargets 准許要求抽樣配額的許可來抽樣服務用於抽樣要求的規則 讀取
GetServiceGraph 准許擷取描述服務的文件，那些服務會處理他們呼叫作為結果的傳入請求和下游服務。 讀取
GetTimeSeriesServiceStatistics 准許取得服務統計資料彙總，這些統計資料是透過在時間間隔歸納的特定時間範圍儲存貯體所定義。 讀取
GetTraceGraph 准許擷取一或多個特定追蹤識別碼之服務圖形 讀取
GetTraceSegmentDestination 准許擷取傳送至 PutTraceSegments 和 OpenTelemetry API 的資料目前目的地 讀取
GetTraceSummaries 准許使用選用篩選條件擷取可供指定時間範圍使用追蹤的 ID 和中繼資料。若要取得完整的追蹤，請將追蹤 ID 傳遞至 BatchGetTraces。 讀取
准許與監控帳戶共用 X-Ray 資源 寫入
ListResourcePolicies 准許列出資源政策 清單
ListRetrievedTraces 准許從交易搜尋 CloudWatch 日誌群組擷取指定 RetrievalToken 的追蹤清單 清單
ListTagsForResource 准許列出 X-Ray 資源的標籤 列出

group

sampling-rule

PutEncryptionConfig 准許更新 X-Ray 資料加密組態 許可管理
PutResourcePolicy 准許建立或更新資源政策 寫入
PutSpans 准許將 OpenTelemetry 範圍上傳至 AWS X-Ray 寫入
PutSpansForIndexing [僅限許可] 准許上傳範圍到要編製索引的 AWS X-Ray 寫入
PutTelemetryRecords 准許將 AWS X-Ray 協助程式遙測傳送至 服務 寫入
PutTraceSegments 准許將區段文件上傳至 AWS X-Ray。X-Ray SDK 會產生區段文件，並將這些文件傳送至 X-Ray 協助程式，此協助程式會批次上傳這些文件 寫入
StartTraceRetrieval 准許使用指定的時間範圍和交易搜尋 CloudWatch 日誌群組上指定的追蹤 IDs來啟動追蹤擷取程序 讀取
TagResource 准許將標籤新增至 X-Ray 資源 標記

group

sampling-rule

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource 准許將 X-Ray 資源移除標籤 標記

group

sampling-rule

aws:TagKeys

UpdateGroup 准許更新群組資源 寫入

group*

aws:ResourceTag/${TagKey}

UpdateIndexingRule 准許修改索引規則的組態 寫入
UpdateSamplingRule 准許修改抽樣規則組態 寫入

sampling-rule*

aws:ResourceTag/${TagKey}

UpdateTraceSegmentDestination 准許修改傳送至 PutTraceSegments 和 OpenTelemetry API 的資料目的地 寫入

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 依要求中傳遞的標籤索引鍵來篩選存取權 ArrayOfString