

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS X-Ray에 사용되는 작업, 리소스 및 조건 키
<a name="list_awsx-ray"></a>

AWS X-Ray(서비스 접두사: `xray`)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.

참조:
+ [이 서비스를 구성](https://docs.aws.amazon.com/xray/latest/devguide/)하는 방법을 알아봅니다.
+ [이 서비스에 사용 가능한 API 작업](https://docs.aws.amazon.com/xray/latest/api/)의 목록을 봅니다.
+ IAM 권한 정책을 [사용](https://docs.aws.amazon.com/xray/latest/devguide/security_iam_service-with-iam.html)하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

**Topics**
+ [AWS X-Ray에서 정의한 작업](#awsx-ray-actions-as-permissions)
+ [AWS X-Ray에서 정의한 리소스 유형](#awsx-ray-resources-for-iam-policies)
+ [AWS X-Ray에 사용되는 조건 키](#awsx-ray-policy-keys)

## AWS X-Ray에서 정의한 작업
<a name="awsx-ray-actions-as-permissions"></a>

IAM 정책 설명의 `Action` 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.

작업 테이블의 **액세스 레벨** 열은 작업이 분류되는 방법(나열, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 레벨에 대한 자세한 내용은 [정책 요약의 액세스 레벨](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_understand-policy-summary-access-level-summaries.html)을 참조하세요.

작업 테이블의 **리소스 유형** 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 `Resource` 요소에서 정책이 적용되는 모든 리소스("\*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(\*)로 표시됩니다. IAM 정책의 `Resource` 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.

작업 테이블의 **조건 키** 열에는 정책 설명의 `Condition` 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 **조건 키** 열을 참조하세요.

작업 테이블의 **종속 작업** 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.

**참고**  
리소스 조건 키는 [리소스 유형](#awsx-ray-resources-for-iam-policies) 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 **리소스 유형(\*필수)** 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 **조건 키** 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 [작업 테이블](reference_policies_actions-resources-contextkeys.html#actions_table)을 참조하세요.


****  


- **  [https://docs.aws.amazon.com/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console](https://docs.aws.amazon.com/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console) [권한만 해당]**
  - **설명:** ID로 지정된 추적 목록에 대한 메타데이터를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html](https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html) **
  - **설명:** ID로 지정된 트레이스 목록을 검색할 수 있는 권한을 부여합니다. 각 트레이스는 단일 요청에서 시작되는 세그먼트 문서의 모음입니다. GetTraceSummaries를 사용하여 트레이스 ID의 목록을 가져옵니다.
  - **액세스 레벨:** List
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [API_CancelTraceRetrieval.html](API_CancelTraceRetrieval.html) **
  - **설명:** 제공된 RetrievalToken을 사용하여 StartTraceRetrieval에서 시작한 진행 중인 추적 검색 작업을 취소할 수 있는 권한을 부여합니다. 취소에 성공하면 HTTP 200 응답이 반환됩니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html) **
  - **설명:** 이름 및 필터 표현식으로 그룹 리소스를 생성할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Write
  - **리소스 유형(\*필수):**  [#awsx-ray-group](#awsx-ray-group)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_RequestTag___TagKey_](#awsx-ray-aws_RequestTag___TagKey_) <br /> [#awsx-ray-aws_TagKeys](#awsx-ray-aws_TagKeys)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_CreateSamplingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_CreateSamplingRule.html) **
  - **설명:** 계측된 애플리케이션에 대한 샘플링 동작을 제어하는 규칙을 생성할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Write
  - **리소스 유형(\*필수):**  [#awsx-ray-sampling-rule](#awsx-ray-sampling-rule)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_RequestTag___TagKey_](#awsx-ray-aws_RequestTag___TagKey_) <br /> [#awsx-ray-aws_TagKeys](#awsx-ray-aws_TagKeys)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_DeleteGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_DeleteGroup.html) **
  - **설명:** 그룹 리소스를 삭제할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):**  [#awsx-ray-group](#awsx-ray-group)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_ResourceTag___TagKey_](#awsx-ray-aws_ResourceTag___TagKey_)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_DeleteResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_DeleteResourcePolicy.html) **
  - **설명:** 리소스 정책을 삭제할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:**  [#awsx-ray-xray_ResourcePolicyName](#awsx-ray-xray_ResourcePolicyName) 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_DeleteSamplingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_DeleteSamplingRule.html) **
  - **설명:** 샘플링 규칙을 삭제할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):**  [#awsx-ray-sampling-rule](#awsx-ray-sampling-rule)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_ResourceTag___TagKey_](#awsx-ray-aws_ResourceTag___TagKey_)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console](https://docs.aws.amazon.com/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console) [권한만 해당]**
  - **설명:** 하나 이상의 특정 추적 ID에 대한 고유한 서비스 그래프를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetEncryptionConfig.html](https://docs.aws.amazon.com/xray/latest/api/API_GetEncryptionConfig.html) **
  - **설명:** X-Ray 데이터에 대한 현재 암호화 구성을 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_GetGroup.html) **
  - **설명:** 그룹 리소스 세부 정보를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):**  [#awsx-ray-group](#awsx-ray-group)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_ResourceTag___TagKey_](#awsx-ray-aws_ResourceTag___TagKey_)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetGroups.html](https://docs.aws.amazon.com/xray/latest/api/API_GetGroups.html) **
  - **설명:** 모든 활성 그룹 세부 정보를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetIndexingRules.html](https://docs.aws.amazon.com/xray/latest/api/API_GetIndexingRules.html) **
  - **설명:** 모든 인덱싱 규칙을 검색할 수 있는 권한을 부여합니다. 인덱싱 규칙은 CloudWatchLogs 대상을 통해 수집되고 X-Ray로 인덱싱된 스팬의 서버 측 샘플링 비율을 결정하는 데 사용됩니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetInsight.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsight.html) **
  - **설명:** 특정 분석의 세부 정보를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetInsightEvents.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsightEvents.html) **
  - **설명:** 특정 분석의 이벤트를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetInsightImpactGraph.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsightImpactGraph.html) **
  - **설명:** 특정 분석에 영향을 주는 서비스 그래프의 일부를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetInsightSummaries.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsightSummaries.html) **
  - **설명:** 선택적 필터를 사용하여 특정 그룹 및 시간 범위의 모든 분석에 대한 요약을 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [API_GetRetrievedTracesGraph.html](API_GetRetrievedTracesGraph.html) **
  - **설명:** 트랜잭션 검색 CloudWatch 로그 그룹에서 지정된 RetrievalToken을 기반으로 추적의 서비스 그래프를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingRules.html](https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingRules.html) **
  - **설명:** 모든 샘플링 규칙을 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingStatisticSummaries.html](https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingStatisticSummaries.html) **
  - **설명:** 모든 샘플링 규칙의 최근 샘플링 결과에 대한 정보를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html](https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html) **
  - **설명:** 서비스가 요청을 샘플링하기 위해 사용하는 규칙에 대한 샘플링 할당량을 요청할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetServiceGraph.html](https://docs.aws.amazon.com/xray/latest/api/API_GetServiceGraph.html) **
  - **설명:** 수신 요청을 처리하는 서비스와 결과로 호출되는 다운스트림 서비스를 설명하는 문서를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetTimeSeriesServiceStatistics.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTimeSeriesServiceStatistics.html) **
  - **설명:** 시간 간격으로 버킷팅된 특정 시간 범위에 의해 정의되는 서비스 통계의 집계를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** Read
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html) **
  - **설명:** 하나 이상의 특정 트레이스 ID에 대한 서비스 그래프를 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html) **
  - **설명:** PutTraceSegments 및 OpenTelemetry API로 전송된 데이터의 현재 대상을 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html) **
  - **설명:** 선택 사항인 필터를 사용하여 지정된 기간에 사용할 수 있는 트레이스에 대한 ID 및 메타데이터를 검색할 수 있는 권한을 부여합니다. 전체 트레이스를 가져오려면 트레이스 ID를 BatchGetTraces에 전달합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account-Setup.html#CloudWatch-Unified-Cross-Account-Setup-permissions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account-Setup.html#CloudWatch-Unified-Cross-Account-Setup-permissions) [권한만 해당]**
  - **설명:** X-Ray 리소스를 모니터링 계정과 공유할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_ListResourcePolicies.html](https://docs.aws.amazon.com/xray/latest/api/API_ListResourcePolicies.html) **
  - **설명:** 리소스 정책을 나열할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** List
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [API_ListRetrievedTraces.html](API_ListRetrievedTraces.html) **
  - **설명:** 트랜잭션 검색 CloudWatch 로그 그룹에서 지정된 RetrievalToken의 추적 목록을 검색할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** List
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html](https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html) **
  - **설명:** X-Ray 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 나열
  - **리소스 유형(\*필수):**  [#awsx-ray-group](#awsx-ray-group)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  [#awsx-ray-sampling-rule](#awsx-ray-sampling-rule)  / **조건 키:**  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html](https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html) **
  - **설명:** X-Ray 데이터에 대한 암호화 구성을 업데이트할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 권한 관리
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html) **
  - **설명:** 리소스 정책을 생성하거나 업데이트할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:**  [#awsx-ray-xray_ResourcePolicyName](#awsx-ray-xray_ResourcePolicyName) 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html) **
  - **설명:** OpenTelemetry 스팬을 AWS X-Ray에 업로드할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:**  [#awsx-ray-logs_LogGeneratingResourceArns](#awsx-ray-logs_LogGeneratingResourceArns) 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console](https://docs.aws.amazon.com/xray/latest/devguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console) [권한만 해당]**
  - **설명:** 인덱싱할 AWS X-Ray에 범위를 업로드할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_PutTelemetryRecords.html](https://docs.aws.amazon.com/xray/latest/api/API_PutTelemetryRecords.html) **
  - **설명:**  AWS X-Ray 데몬 원격 측정을 서비스로 전송할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html](https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html) **
  - **설명:** 세그먼트 문서를 AWS X-Ray에 업로드할 수 있는 권한을 부여합니다. X-Ray SDK는 세그먼트 문서를 생성하고 이를 X-Ray 데몬으로 전송하여 일괄적으로 업로드합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:**  [#awsx-ray-logs_LogGeneratingResourceArns](#awsx-ray-logs_LogGeneratingResourceArns) 
  - **종속 작업:** 

- **  [API_StartTraceRetrieval](API_StartTraceRetrieval) **
  - **설명:** 트랜잭션 검색 CloudWatch 로그 그룹의 지정된 추적 ID에 지정된 시간 범위를 사용하여 추적 검색 프로세스를 시작할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 읽기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html) **
  - **설명:** X-Ray 리소스에 태그를 추가할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 태그 지정
  - **리소스 유형(\*필수):**  [#awsx-ray-group](#awsx-ray-group)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  [#awsx-ray-sampling-rule](#awsx-ray-sampling-rule)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_TagKeys](#awsx-ray-aws_TagKeys) <br /> [#awsx-ray-aws_RequestTag___TagKey_](#awsx-ray-aws_RequestTag___TagKey_)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html) **
  - **설명:** X-Ray 리소스에서 태그를 제거할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 태그 지정
  - **리소스 유형(\*필수):**  [#awsx-ray-group](#awsx-ray-group)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  [#awsx-ray-sampling-rule](#awsx-ray-sampling-rule)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_TagKeys](#awsx-ray-aws_TagKeys)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_UpdateGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateGroup.html) **
  - **설명:** 그룹 리소스를 업데이트할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):**  [#awsx-ray-group](#awsx-ray-group)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_ResourceTag___TagKey_](#awsx-ray-aws_ResourceTag___TagKey_)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html) **
  - **설명:** 인덱싱 규칙의 구성을 수정할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:** 
  - **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_UpdateSamplingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateSamplingRule.html) **
  - **설명:** 샘플링 규칙의 구성을 수정할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):**  [#awsx-ray-sampling-rule](#awsx-ray-sampling-rule)  / **조건 키:**  / **종속 작업:** 
  - **리소스 유형(\*필수):**  / **조건 키:**  [#awsx-ray-aws_ResourceTag___TagKey_](#awsx-ray-aws_ResourceTag___TagKey_)  / **종속 작업:** 

- **  [https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html) **
  - **설명:** PutTraceSegments 및 OpenTelemetry API로 전송된 데이터의 대상을 수정할 수 있는 권한을 부여합니다.
  - **액세스 레벨:** 쓰기
  - **리소스 유형(\*필수):** 
  - **조건 키:**  [#awsx-ray-xray_TraceSegmentDestination](#awsx-ray-xray_TraceSegmentDestination) 
  - **종속 작업:** 



## AWS X-Ray에서 정의한 리소스 유형
<a name="awsx-ray-resources-for-iam-policies"></a>

이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 `Resource` 요소에서 사용할 수 있습니다. [작업 테이블](#awsx-ray-actions-as-permissions)의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 [리소스 유형 테이블](reference_policies_actions-resources-contextkeys.html#resources_table)을 참조하세요.


****  

| 조건 키 | ARN | 조건 키 | 
| --- | --- | --- | 
|   [https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-groups](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-groups)  |  arn:${Partition}:xray:${Region}:${Account}:group/${GroupName}/${Id}  |  [#awsx-ray-aws_ResourceTag___TagKey_](#awsx-ray-aws_ResourceTag___TagKey_)  | 
|   [https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-sampling](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-sampling)  |  arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName}  |  [#awsx-ray-aws_ResourceTag___TagKey_](#awsx-ray-aws_ResourceTag___TagKey_)  | 

## AWS X-Ray에 사용되는 조건 키
<a name="awsx-ray-policy-keys"></a>

AWS X-Ray는 IAM 정책의 `Condition` 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 [조건 키 테이블](reference_policies_actions-resources-contextkeys.html#context_keys_table)을 참조하세요.

모든 서비스에 사용할 수 있는 전역 조건 키를 보려면 [AWS 전역 조건 컨텍스트 키](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)를 참조하세요.


****  

| 조건 키 | 설명 | Type | 
| --- | --- | --- | 
|   [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag)  | 요청에서 전달되는 태그를 기준으로 액세스를 필터링합니다. | 문자열 | 
|   [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag)  | 리소스와 연결된 태그를 기준으로 액세스를 필터링합니다. | 문자열 | 
|   [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys)  | 요청에서 전달되는 태그 키를 기준으로 액세스를 필터링합니다. | ArrayOfString | 
|   [https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions)  | 요청의 LogGeneratingResourceArn을 기준으로 액세스를 필터링합니다. | ArrayOfARN | 
|   [https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions)  | 요청의 PolicyName을 기준으로 액세스를 필터링합니다. | 문자열 | 
|   [https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsx-ray.html#awsx-ray-actions-as-permissions)  | 요청의 TraceSegmentDestination 유형을 기준으로 액세스를 필터링합니다. | 문자열 | 