Amazon Athena에 사용되는 작업, 리소스 및 조건 키

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

참조:

• 이 서비스의 구성 방법을 알아봅니다.

• 이 서비스에 사용 가능한 API 작업 목록을 봅니다.

• IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

Amazon Athena에서 정의한 작업

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

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

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

참고

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

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

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키	종속 작업
BatchGetNamedQuery	하나 이상의 명명된 쿼리에 대한 정보를 가져올 권한을 부여합니다.	읽기	workgroup*
BatchGetPreparedStatement	하나 이상의 준비된 설명에 대한 정보를 가져오는 권한을 부여합니다.	읽기	workgroup*
BatchGetQueryExecution	하나 이상의 쿼리 실행에 대한 정보를 가져올 권한을 부여합니다.	읽기	workgroup*
CancelCapacityReservation	용량 예약을 취소하는 권한을 부여합니다.	쓰기	capacity-reservation*
CancelQueryExecution	쿼리 실행을 취소할 수 있는 권한을 부여합니다. 사용되지 않음. 1.1.0 이전의 Athena JDBC 드라이버를 사용하는 AWS 서비스 및 보안 주체에만 적용합니다. 그렇지 않을 경우 StopQueryExecution 사용	쓰기	workgroup*
CreateCapacityReservation	용량 예약을 생성하는 권한을 부여합니다.	쓰기	capacity-reservation*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDataCatalog	데이터 카탈로그를 생성할 권한을 부여합니다.	쓰기	datacatalog*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateNamedQuery	명명된 쿼리를 생성할 권한을 부여합니다.	쓰기	workgroup*
CreateNotebook	노트북을 생성할 수 있는 권한을 부여합니다.	쓰기	workgroup*
CreatePreparedStatement	준비된 문을 생성할 수 있는 권한을 부여합니다.	쓰기	workgroup*
CreatePresignedNotebookUrl	미리 서명된 노트북 URL을 생성할 수 있는 권한을 부여합니다.	쓰기	workgroup*
CreateWorkGroup	작업 그룹을 생성할 권한을 부여합니다.	쓰기	workgroup*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteCapacityReservation	용량 예약을 삭제할 수 있는 권한을 부여합니다.	쓰기	capacity-reservation*
DeleteDataCatalog	데이터 카탈로그를 삭제할 권한을 부여합니다.	쓰기	datacatalog*
DeleteNamedQuery	지정한 명명된 쿼리를 삭제할 권한을 부여합니다.	쓰기	workgroup*
DeleteNotebook	노트북을 삭제할 수 있는 권한을 부여합니다.	쓰기	workgroup*
DeletePreparedStatement	지정된 준비된 문을 삭제할 수 있는 권한을 부여합니다.	쓰기	workgroup*
DeleteWorkGroup	작업 그룹을 삭제할 권한을 부여합니다.	쓰기	workgroup*
ExportNotebook	노트북을 내보낼 수 있는 권한을 부여합니다.	쓰기	workgroup*
GetCalculationExecution	계산 실행을 가져올 수 있는 권한을 부여합니다.	읽기	workgroup*
GetCalculationExecutionCode	계산 실행 코드를 가져올 수 있는 권한을 부여합니다.	읽기	workgroup*
GetCalculationExecutionStatus	계산 실행 상태를 가져올 수 있는 권한을 부여합니다.	읽기	workgroup*
GetCapacityAssignmentConfiguration	용량 예약을 위한 용량 할당 정보를 가져오는 권한을 부여합니다.	읽기	capacity-reservation*
GetCapacityReservation	용량 예약을 가져오는 권한을 부여합니다.	읽기	capacity-reservation*
GetCatalogs	데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용	읽기
GetDataCatalog	데이터 카탈로그를 가져올 권한을 부여합니다.	읽기	datacatalog*
GetDatabase	지정된 데이터 카탈로그에 대한 데이터베이스를 가져올 권한을 부여합니다.	읽기	datacatalog*
GetExecutionEngine	지정된 데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용	읽기
GetExecutionEngines	데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용	읽기
GetNamedQuery	지정된 명명된 쿼리에 대한 정보를 가져올 권한을 부여합니다.	읽기	workgroup*
GetNamespace	지정된 데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용	읽기
GetNamespaces	데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용	읽기
GetNotebookMetadata	노트북 메타데이터를 가져올 수 있는 권한을 부여합니다.	읽기	workgroup*
GetPreparedStatement	지정된 준비된 문에 대한 정보를 가져올 수 있는 권한을 부여합니다.	읽기	workgroup*
GetQueryExecution	지정된 쿼리 실행에 대한 정보를 가져올 권한을 부여합니다.	읽기	workgroup*
GetQueryExecutions	쿼리 실행을 가져올 수 있는 권한을 부여합니다. 사용되지 않음. 1.1.0 이전의 Athena JDBC 드라이버를 사용하는 AWS 서비스 및 보안 주체에만 적용합니다. 그렇지 않을 경우 ListQueryExecutions 사용	읽기
GetQueryResults	쿼리 결과를 가져올 권한을 부여합니다.	읽기	workgroup*
GetQueryResultsStream	쿼리 결과 스트림을 가져올 권한을 부여합니다.	읽기	workgroup*
GetQueryRuntimeStatistics	지정한 쿼리 실행의 런타임 통계를 가져오는 권한을 부여합니다.	읽기	workgroup*
GetSession	세션을 가져올 수 있는 권한을 부여합니다.	읽기	workgroup*
GetSessionStatus	세션 상태를 가져올 수 있는 권한을 부여합니다.	읽기	workgroup*
GetTable	지정된 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용	읽기
GetTableMetadata	지정된 데이터 카탈로그의 테이블에 대한 메타데이터를 가져올 권한을 부여합니다.	읽기	datacatalog*
GetTables	테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용	읽기
GetWorkGroup	작업 그룹을 가져올 권한을 부여합니다.	읽기	workgroup*
ImportNotebook	노트북을 가져올 수 있는 권한을 부여합니다.	쓰기	workgroup*
ListApplicationDPUSizes	ApplicationRuntimeIds 목록을 반환할 수 있는 권한을 부여합니다.	목록
ListCalculationExecutions	계산 실행 목록을 반환할 수 있는 권한을 부여합니다.	목록	workgroup*
ListCapacityReservations	지정된 AWS 계정에 대한 용량 예약의 목록을 반환하는 권한을 부여합니다.	목록
ListDataCatalogs	지정된 AWS 계정에 대한 데이터 카탈로그 목록을 반환할 권한을 부여합니다.	목록
ListDatabases	지정된 데이터 카탈로그에 대한 데이터베이스 목록을 반환할 권한을 부여합니다.	목록	datacatalog*
ListEngineVersions	지정된 AWS 계정에 대한 Athena 엔진 버전 목록을 반환할 권한을 부여합니다.	읽기
ListExecutors	실행기 목록을 반환할 수 있는 권한을 부여합니다.	목록
ListNamedQueries	지정된 AWS 계정에 대한 Amazon Athena의 명명된 쿼리 목록을 반환할 권한을 부여합니다.	목록	workgroup*
ListNotebookMetadata	지정된 작업 그룹에 대한 노트북 목록을 반환할 수 있는 권한을 부여합니다.	목록	workgroup*
ListNotebookSessions	지정된 노트북에 대한 세션 목록을 반환할 수 있는 권한을 부여합니다.	목록	workgroup*
ListPreparedStatements	지정된 작업 그룹에 대해 준비된 문 목록을 반환할 수 있는 권한을 부여합니다.	목록	workgroup*
ListQueryExecutions	지정된 AWS 계정에 대한 쿼리 실행 목록을 반환할 권한을 부여합니다.	읽기	workgroup*
ListSessions	지정된 작업 그룹에 대한 세션 목록을 반환할 수 있는 권한을 부여합니다.	목록	workgroup*
ListTableMetadata	지정된 데이터 카탈로그에 대한 데이터베이스의 테이블 메타데이터 목록을 반환할 권한을 부여합니다.	읽기	datacatalog*
ListTagsForResource	리소스에 대한 태그 목록을 반환할 수 있는 권한을 부여합니다.	읽기	capacity-reservation*
			datacatalog*
			workgroup*
ListWorkGroups	지정된 AWS 계정에 대한 작업 그룹 목록을 반환할 권한을 부여합니다.	목록
PutCapacityAssignmentConfiguration	용량 예약의 용량을 쿼리에 할당하는 권한을 부여합니다.	쓰기	capacity-reservation*
			workgroup*
RunQuery	쿼리를 실행할 수 있는 권한을 부여합니다. 사용되지 않음. 1.1.0 이전의 Athena JDBC 드라이버를 사용하는 AWS 서비스 및 보안 주체에만 적용합니다. 그렇지 않을 경우 StartQueryExecution 사용	쓰기
StartCalculationExecution	계산 실행을 시작할 수 있는 권한을 부여합니다.	쓰기	workgroup*
StartQueryExecution	문자열로 제공된 SQL 쿼리를 사용하여 쿼리 실행을 시작할 권한을 부여합니다.	쓰기	workgroup*
StartSession	세션을 시작할 수 있는 권한을 부여합니다.	쓰기	workgroup*
StopCalculationExecution	계산 실행을 중지할 수 있는 권한을 부여합니다.	쓰기	workgroup*
StopQueryExecution	지정된 쿼리 실행을 중지할 권한을 부여합니다.	쓰기	workgroup*
TagResource	리소스에 태그를 추가할 수 있는 권한을 부여합니다.	태그 지정	capacity-reservation*
			datacatalog*
			workgroup*
				aws:RequestTag/${TagKey} aws:TagKeys
TerminateSession	세션을 종료할 수 있는 권한을 부여합니다.	쓰기	workgroup*
UntagResource	리소스에서 태그를 제거할 수 있는 권한을 부여합니다.	태그 지정	capacity-reservation*
			datacatalog*
			workgroup*
				aws:TagKeys
UpdateCapacityReservation	용량 예약을 업데이트하는 권한을 부여합니다.	쓰기	capacity-reservation*
UpdateDataCatalog	데이터 카탈로그를 업데이트할 권한을 부여합니다.	쓰기	datacatalog*
UpdateNamedQuery	지정한 명명된 쿼리를 업데이트할 권한을 부여합니다.	쓰기	workgroup*
UpdateNotebook	노트북을 업데이트할 수 있는 권한을 부여합니다.	쓰기	workgroup*
UpdateNotebookMetadata	노트북 메타데이터를 업데이트할 수 있는 권한을 부여합니다.	쓰기	workgroup*
UpdatePreparedStatement	준비된 문을 업데이트할 수 있는 권한을 부여합니다.	쓰기	workgroup*
UpdateWorkGroup	작업 그룹을 업데이트할 권한을 부여합니다.	쓰기	workgroup*

Amazon Athena에서 정의한 리소스 유형

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

리소스 유형	ARN	조건 키
datacatalog	arn:${Partition}:athena:${Region}:${Account}:datacatalog/${DataCatalogName}	aws:ResourceTag/${TagKey}
workgroup	arn:${Partition}:athena:${Region}:${Account}:workgroup/${WorkGroupName}	aws:ResourceTag/${TagKey}
capacity-reservation	arn:${Partition}:athena:${Region}:${Account}:capacity-reservation/${CapacityReservationName}	aws:ResourceTag/${TagKey}

Amazon Athena에 사용되는 조건 키

Amazon Athena 는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

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

조건 키	설명	Type
aws:RequestTag/${TagKey}	요청에 태그 키-값 페어가 있는지 여부를 기준으로 액세스를 필터링합니다.	문자열
aws:ResourceTag/${TagKey}	리소스에 연결된 태그 키-값 페어를 기준으로 액세스를 필터링합니다.	문자열
aws:TagKeys	요청에 태그 키가 있는지 여부를 기준으로 액세스 필터링	ArrayOfString