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

# `AWS-QueryCloudTrailLogs`
<a name="aws-querycloudtraillogs"></a>

 **설명** 

 `AWS-QueryCloudTrailLogs` 실행서는 AWS CloudTrail (CloudTrail) 로그를 포함하는 선택한 Amazon Simple Storage Service(Amazon S3) 버킷에서 Amazon Athena 테이블을 생성합니다. 테이블을 생성한 후, 자동화는 사용자가 지정하는 SQL 쿼리를 실행한 다음 테이블을 삭제합니다.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-QueryCloudTrailLogs) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

데이터베이스 수

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ Query

  유형: 문자열

  설명: (필수) 실행하려는 SQL 쿼리입니다.
+ SourceBucketPath

  유형: 문자열

  설명: (필수) 쿼리하려는 CloudTrail 로그 파일이 포함된 Amazon S3 버킷의 이름입니다.
+ TableName

  유형: 문자열

  설명: (선택 사항) 자동화로 생성된 Athena 테이블의 이름입니다.

  기본값: cloudtrail\_logs

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `athena:GetQueryResults` 
+  `athena:GetQueryExecution` 
+  `athena:StartQueryExecution` 
+  `glue:CreateTable` 
+  `glue:DeleteTable` 
+  `glue:GetDatabase` 
+  `glue:GetPartitions` 
+  `glue:GetTable` 
+  `s3:AbortMultipartUpload` 
+  `s3:CreateBucket` 
+  `s3:GetBucketLocation` 
+  `s3:GetObject` 
+  `s3:ListBucket` 
+  `s3:ListBucketMultipartUploads` 
+  `s3:ListMultipartUploadParts` 
+  `s3:PutObject` 

 **문서 단계** 
+  `aws:executeAwsApi` - Athena 테이블을 생성합니다.
+  `aws:executeAwsApi` - `Query` 파라미터에 지정하는 쿼리 문자열을 실행합니다.
+  `aws:executeScript` - 폴링하고 쿼리가 완료될 때까지 기다립니다.
+  `aws:executeAwsApi` - 쿼리 결과를 가져옵니다.
+  `aws:executeAwsApi` - 자동화로 생성된 테이블을 삭제합니다.