AWS X-Ray에 사용되는 작업, 리소스 및 조건 키

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

참조:

이 서비스의 구성 방법을 알아봅니다.
이 서비스에 사용 가능한 API 작업 목록을 봅니다.
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

주제

AWS X-Ray에서 정의한 작업
AWS X-Ray에서 정의한 리소스 유형
AWS X-Ray에 사용되는 조건 키

AWS X-Ray에서 정의한 작업

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

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

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

참고

리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키
BatchGetTraceSummaryById [권한만 해당]	ID로 지정된 추적 목록에 대한 메타데이터를 검색할 수 있는 권한을 부여합니다.	읽기
BatchGetTraces	ID로 지정된 트레이스 목록을 검색할 수 있는 권한을 부여합니다. 각 트레이스는 단일 요청에서 시작되는 세그먼트 문서의 모음입니다. 추적 ID 목록을 가져오는 GetTraceSummaries 데 사용합니다.	나열
CreateGroup	이름 및 필터 표현식으로 그룹 리소스를 생성할 수 있는 권한을 부여합니다.	Write	group*
CreateGroup	이름 및 필터 표현식으로 그룹 리소스를 생성할 수 있는 권한을 부여합니다.	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateSamplingRule	계측된 애플리케이션에 대한 샘플링 동작을 제어하는 규칙을 생성할 수 있는 권한을 부여합니다.	Write	sampling-rule*
CreateSamplingRule	계측된 애플리케이션에 대한 샘플링 동작을 제어하는 규칙을 생성할 수 있는 권한을 부여합니다.	Write		aws:RequestTag/${TagKey} aws:TagKeys
DeleteGroup	그룹 리소스를 삭제할 수 있는 권한을 부여합니다.	쓰기	group*
DeleteGroup	그룹 리소스를 삭제할 수 있는 권한을 부여합니다.	쓰기		aws:ResourceTag/${TagKey}
DeleteResourcePolicy	리소스 정책을 삭제할 수 있는 권한을 부여합니다.	쓰기
DeleteSamplingRule	샘플링 규칙을 삭제할 수 있는 권한을 부여합니다.	쓰기	sampling-rule*
DeleteSamplingRule	샘플링 규칙을 삭제할 수 있는 권한을 부여합니다.	쓰기		aws:ResourceTag/${TagKey}
GetDistinctTraceGraphs [권한만 해당]	하나 이상의 특정 추적 ID에 대한 고유한 서비스 그래프를 검색할 수 있는 권한을 부여합니다.	읽기
GetEncryptionConfig	X-Ray 데이터에 대한 현재 암호화 구성을 검색할 수 있는 권한을 부여합니다.	Read
GetGroup	그룹 리소스 세부 정보를 검색할 수 있는 권한을 부여합니다.	Read	group*
GetGroup	그룹 리소스 세부 정보를 검색할 수 있는 권한을 부여합니다.	Read		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	읽기
Link [권한만 해당]	X-Ray 리소스를 모니터링 계정과 공유할 수 있는 권한을 부여합니다.	쓰기
ListResourcePolicies	리소스 정책을 나열할 수 있는 권한을 부여합니다.	나열
ListTagsForResource	X-Ray 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다.	나열	group
ListTagsForResource	X-Ray 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다.	나열	sampling-rule
PutEncryptionConfig	X-Ray 데이터에 대한 암호화 구성을 업데이트할 수 있는 권한을 부여합니다.	권한 관리
PutResourcePolicy	리소스 정책을 생성하거나 업데이트할 수 있는 권한을 부여합니다.	쓰기
PutTelemetryRecords	서비스에 AWS X-Ray 데몬 원격 측정을 전송할 수 있는 권한을 부여합니다.	쓰기
PutTraceSegments	세그먼트 문서를 AWS X-Ray에 업로드할 권한을 부여합니다. X-Ray SDK는 세그먼트 문서를 생성하고 이를 X-Ray 데몬으로 전송하여 일괄적으로 업로드합니다.	Write
TagResource	X-Ray 리소스에 태그를 추가할 수 있는 권한을 부여합니다.	태그 지정	group
			sampling-rule
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	X-Ray 리소스에서 태그를 제거할 수 있는 권한을 부여합니다.	태그 지정	group
			sampling-rule
				aws:TagKeys
UpdateGroup	그룹 리소스를 업데이트할 수 있는 권한을 부여합니다.	Write	group*
UpdateGroup	그룹 리소스를 업데이트할 수 있는 권한을 부여합니다.	Write		aws:ResourceTag/${TagKey}
UpdateSamplingRule	샘플링 규칙의 구성을 수정할 수 있는 권한을 부여합니다.	Write	sampling-rule*
UpdateSamplingRule	샘플링 규칙의 구성을 수정할 수 있는 권한을 부여합니다.	Write		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 요소에서 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.

조건 키	설명	Type
aws:RequestTag/${TagKey}	요청에서 전달되는 태그를 기준으로 액세스를 필터링합니다.	문자열
aws:ResourceTag/${TagKey}	리소스와 연결된 태그를 기준으로 액세스를 필터링합니다.	문자열
aws:TagKeys	요청에서 전달되는 태그 키를 기준으로 액세스를 필터링합니다.	ArrayOfString

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

아마존 WorkSpaces 씬 클라이언트