기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Athena에 사용되는 작업, 리소스 및 조건 키
Amazon Athena(서비스 접두사: athena)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
Amazon Athena에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| BatchGetNamedQuery | 하나 이상의 명명된 쿼리에 대한 정보를 가져올 권한을 부여합니다. | 읽기 | |||
| BatchGetPreparedStatement | 하나 이상의 준비된 설명에 대한 정보를 가져오는 권한을 부여합니다. | 읽기 | |||
| BatchGetQueryExecution | 하나 이상의 쿼리 실행에 대한 정보를 가져올 권한을 부여합니다. | 읽기 | |||
| CancelCapacityReservation | 용량 예약을 취소하는 권한을 부여합니다. | 쓰기 | |||
| CancelQueryExecution | 쿼리 실행을 취소할 수 있는 권한을 부여합니다. 사용되지 않음. 1.1.0 이전 버전의 Athena JDBC 드라이버를 사용하는 AWS 서비스 및 보안 주체에만 적용됩니다. 그렇지 않을 경우 StopQueryExecution 사용 | 쓰기 | |||
| CreateCapacityReservation | 용량 예약을 생성하는 권한을 부여합니다. | 쓰기 | |||
| CreateDataCatalog | 데이터 카탈로그를 생성할 권한을 부여합니다. | 쓰기 | |||
| CreateNamedQuery | 명명된 쿼리를 생성할 권한을 부여합니다. | 쓰기 | |||
| CreateNotebook | 노트북을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreatePreparedStatement | 준비된 문을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreatePresignedNotebookUrl | 미리 서명된 노트북 URL을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateWorkGroup | 작업 그룹을 생성할 권한을 부여합니다. | 쓰기 | |||
| DeleteCapacityReservation | 용량 예약을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDataCatalog | 데이터 카탈로그를 삭제할 권한을 부여합니다. | 쓰기 | |||
| DeleteNamedQuery | 지정한 명명된 쿼리를 삭제할 권한을 부여합니다. | 쓰기 | |||
| DeleteNotebook | 노트북을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeletePreparedStatement | 지정된 준비된 문을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteWorkGroup | 작업 그룹을 삭제할 권한을 부여합니다. | 쓰기 | |||
| ExportNotebook | 노트북을 내보낼 수 있는 권한을 부여합니다. | 쓰기 | |||
| GetCalculationExecution | 계산 실행을 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetCalculationExecutionCode | 계산 실행 코드를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetCalculationExecutionStatus | 계산 실행 상태를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetCapacityAssignmentConfiguration | 용량 예약을 위한 용량 할당 정보를 가져오는 권한을 부여합니다. | 읽기 | |||
| GetCapacityReservation | 용량 예약을 가져오는 권한을 부여합니다. | Read | |||
| GetCatalogs | 데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용됩니다. | Read | |||
| GetDataCatalog | 데이터 카탈로그를 가져올 권한을 부여합니다. | 읽기 | |||
| GetDatabase | 지정된 데이터 카탈로그에 대한 데이터베이스를 가져올 권한을 부여합니다. | Read | |||
| GetExecutionEngine | 지정된 데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용됩니다. | Read | |||
| GetExecutionEngines | 데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용됩니다. | Read | |||
| GetNamedQuery | 지정된 명명된 쿼리에 대한 정보를 가져올 권한을 부여합니다. | Read | |||
| GetNamespace | 지정된 데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용됩니다. | Read | |||
| GetNamespaces | 데이터베이스 및 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용됩니다. | Read | |||
| GetNotebookMetadata | 노트북 메타데이터를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetPreparedStatement | 지정된 준비된 문에 대한 정보를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetQueryExecution | 지정된 쿼리 실행에 대한 정보를 가져올 권한을 부여합니다. | Read | |||
| GetQueryExecutions | 쿼리 실행을 가져올 수 있는 권한을 부여합니다. 사용되지 않음. 1.1.0 이전 버전의 Athena JDBC 드라이버를 사용하는 AWS 서비스 및 보안 주체에만 적용됩니다. 그렇지 않을 경우 ListQueryExecutions 사용 | Read | |||
| GetQueryResults | 쿼리 결과를 가져올 권한을 부여합니다. | 읽기 | |||
| GetQueryResultsStream | 쿼리 결과 스트림을 가져올 권한을 부여합니다. | 읽기 | |||
| GetQueryRuntimeStatistics | 지정한 쿼리 실행의 런타임 통계를 가져오는 권한을 부여합니다. | 읽기 | |||
| GetSession | 세션을 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetSessionStatus | 세션 상태를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetTable | 지정된 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용됩니다. | Read | |||
| GetTableMetadata | 지정된 데이터 카탈로그의 테이블에 대한 메타데이터를 가져올 권한을 부여합니다. | Read | |||
| GetTables | 테이블에 대한 액세스를 활성화할 수 있는 권한을 부여합니다. Athena JDBC 드라이버 버전 1.1.0을 사용하는 AWS 서비스 관리형 정책 및 보안 주체에만 적용됩니다. | Read | |||
| GetWorkGroup | 작업 그룹을 가져올 권한을 부여합니다. | 읽기 | |||
| ImportNotebook | 노트북을 가져올 수 있는 권한을 부여합니다. | 쓰기 | |||
| ListApplicationDPUSizes | ApplicationRuntimeIds 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListCalculationExecutions | 계산 실행 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListCapacityReservations | 지정된에 대한 용량 예약 목록을 반환할 수 있는 권한을 부여합니다. AWS 계정 | List | |||
| ListDataCatalogs | 지정된에 대한 데이터 카탈로그 목록을 반환할 수 있는 권한을 부여합니다. AWS 계정 | List | |||
| ListDatabases | 지정된 데이터 카탈로그에 대한 데이터베이스 목록을 반환할 권한을 부여합니다. | List | |||
| ListEngineVersions | 지정된에 대한 athena 엔진 버전 목록을 반환할 수 있는 권한을 부여합니다. AWS 계정 | Read | |||
| ListExecutors | 실행기 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListNamedQueries | 지정된에 대해 Amazon Athena에서 명명된 쿼리 목록을 반환할 수 있는 권한을 부여합니다. AWS 계정 | List | |||
| ListNotebookMetadata | 지정된 작업 그룹에 대한 노트북 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListNotebookSessions | 지정된 노트북에 대한 세션 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListPreparedStatements | 지정된 작업 그룹에 대해 준비된 문 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListQueryExecutions | 지정된에 대한 쿼리 실행 목록을 반환할 수 있는 권한을 부여합니다. AWS 계정 | Read | |||
| ListSessions | 지정된 작업 그룹에 대한 세션 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListTableMetadata | 지정된 데이터 카탈로그에 대한 데이터베이스의 테이블 메타데이터 목록을 반환할 권한을 부여합니다. | 읽기 | |||
| ListTagsForResource | 리소스에 대한 태그 목록을 반환할 수 있는 권한을 부여합니다. | Read | |||
| ListWorkGroups | 지정된에 대한 작업 그룹 목록을 반환할 수 있는 권한을 부여합니다. AWS 계정 | List | |||
| PutCapacityAssignmentConfiguration | 용량 예약의 용량을 쿼리에 할당하는 권한을 부여합니다. | 쓰기 | |||
| RunQuery | 쿼리를 실행할 수 있는 권한을 부여합니다. 사용되지 않음. 1.1.0 이전 버전의 Athena JDBC 드라이버를 사용하는 AWS 서비스 및 보안 주체에만 적용됩니다. 그렇지 않을 경우 StartQueryExecution 사용 | 쓰기 | |||
| StartCalculationExecution | 계산 실행을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartQueryExecution | 문자열로 제공된 SQL 쿼리를 사용하여 쿼리 실행을 시작할 권한을 부여합니다. | 쓰기 | |||
| StartSession | 세션을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopCalculationExecution | 계산 실행을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopQueryExecution | 지정된 쿼리 실행을 중지할 권한을 부여합니다. | 쓰기 | |||
| TagResource | 리소스에 태그를 추가할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| TerminateSession | 세션을 종료할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UntagResource | 리소스에서 태그를 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateCapacityReservation | 용량 예약을 업데이트하는 권한을 부여합니다. | 쓰기 | |||
| UpdateDataCatalog | 데이터 카탈로그를 업데이트할 권한을 부여합니다. | 쓰기 | |||
| UpdateNamedQuery | 지정한 명명된 쿼리를 업데이트할 권한을 부여합니다. | 쓰기 | |||
| UpdateNotebook | 노트북을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateNotebookMetadata | 노트북 메타데이터를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdatePreparedStatement | 준비된 문을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateWorkGroup | 작업 그룹을 업데이트할 권한을 부여합니다. | 쓰기 |
Amazon Athena에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| datacatalog |
arn:${Partition}:athena:${Region}:${Account}:datacatalog/${DataCatalogName}
|
|
| workgroup |
arn:${Partition}:athena:${Region}:${Account}:workgroup/${WorkGroupName}
|
|
| capacity-reservation |
arn:${Partition}:athena:${Region}:${Account}:capacity-reservation/${CapacityReservationName}
|
Amazon Athena에 사용되는 조건 키
Amazon Athena 는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | 형식 |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청에 태그 키-값 페어가 있는지 여부를 기준으로 액세스를 필터링합니다. | String |
| aws:ResourceTag/${TagKey} | 리소스에 연결된 태그 키-값 페어를 기준으로 액세스를 필터링합니다. | String |
| aws:TagKeys | 요청에 태그 키가 있는지 여부를 기준으로 액세스 필터링 | ArrayOfString |
