Amazon CloudWatch Logs에 사용되는 작업, 리소스 및 조건 키
Amazon CloudWatch Logs(서비스 접두사: logs)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
주제
Amazon CloudWatch Logs에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| AssociateKmsKey | 지정된 AWS Key Management Service(AWS KMS) 고객 마스터 키(CMK)를 지정된 로그 그룹에 연결할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CancelExportTask | 내보내기 작업이 보류 중 또는 실행 중 상태에 있을 경우 이를 취소할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateDelivery | 배송 출발지를 배송지에 연결하는 배송을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateExportTask | 로그 그룹의 데이터를 Amazon S3 버킷으로 효율적으로 내보낼 수 있는 ExportTask를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateLogAnomalyDetector | 로그 이상 탐지기를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateLogDelivery [권한만 해당] | 로그 전송을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateLogGroup | 지정된 이름으로 새 로그 그룹을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateLogStream | 지정된 이름으로 새 로그 스트림을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAccountPolicy | 계정에 연결된 데이터 보호 정책을 삭제하는 권한을 부여합니다. | 쓰기 | |||
| DeleteDataProtectionPolicy | 로그 그룹에 연결된 데이터 보호 정책을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDelivery | 배송을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDeliveryDestination | 연관된 모든 배송을 삭제한 후 배송지를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDeliveryDestinationPolicy | 배송지와 연결된 배송지 정책을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDeliverySource | 연관된 모든 배송을 삭제한 후 배송 출발지를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDestination | 지정된 이름의 대상을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteLogAnomalyDetector | 로그 이상 탐지기를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteLogDelivery [권한만 해당] | 지정된 로그 전송의 로그 전송 정보를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteLogGroup | 지정된 이름의 로그 그룹을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteLogStream | 로그 스트림을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteMetricFilter | 지정된 로그 그룹과 연결된 지표 필터를 삭제할 수 있는 권한을 부여합니다 | 쓰기 | |||
| DeleteQueryDefinition | 저장된 CloudWatch Logs Insights 쿼리 정의를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteResourcePolicy | 이 계정에서 리소스 정책을 삭제할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| DeleteRetentionPolicy | 지정된 로그 그룹의 보존 정책을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteSubscriptionFilter | 지정된 로그 그룹과 연결된 구독 필터를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DescribeAccountPolicies | 계정에 연결된 데이터 보호 정책을 검색하는 권한을 부여합니다. | 나열 | |||
| DescribeConfigurationTemplates | 사용 가능한 로그 유형의 구성 템플릿 목록을 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeDeliveries | 계정에서 배송 목록을 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeDeliveryDestinations | 계정에서 배송지 목록을 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeDeliverySources | 계정에서 배송 출발지 목록을 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeDestinations | AWS 계정의 요청과 연결된 모든 대상을 반환하는 권한을 부여합니다. | 나열 | |||
| DescribeExportTasks | 요청한 AWS 계정과 연결된 모든 내보내기 태스크를 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeLogGroups | 요청한 AWS 계정과 연결된 모든 로그 그룹을 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeLogStreams | 지정된 로그 그룹과 연결된 모든 로그 스트림을 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeMetricFilters | 지정된 로그 그룹과 연결된 모든 지표 필터를 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeQueries | 이 계정에서 예약되었거나 실행 중이거나 최근에 실행된 CloudWatch Logs Insights 쿼리의 목록을 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeQueryDefinitions | 저장된 CloudWatch Logs Insights 쿼리 정의의 페이지가 매겨진 목록을 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeResourcePolicies | 이 계정의 모든 리소스 정책을 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DescribeSubscriptionFilters | 지정된 로그 그룹과 연결된 모든 구독 필터를 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| DisassociateKmsKey | 지정된 로그 그룹에서 연결된 AWS Key Management Service(AWS KMS) 고객 마스터 키(CMK)의 연결을 해제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| FilterLogEvents | 지정된 로그 그룹에서 필터 패턴을 기준으로 필터링된 로그 이벤트를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDataProtectionPolicy | 로그 그룹에 연결된 데이터 보호 정책을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDelivery | 단일 배송을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDeliveryDestination | 단일 배송지를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDeliveryDestinationPolicy | 배송지에 연결된 배송지 정책을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDeliverySource | 단일 배송 출발지를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetLogAnomalyDetector | 로그 이상 탐지기를 생성할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetLogDelivery [권한만 해당] | 지정된 로그 전송의 로그 전송 정보를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetLogEvents | 지정된 로그 스트림에서 로그 이벤트를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetLogGroupFields | 지정된 로그 그룹의 로그 이벤트에 포함된 필드의 목록을 각 필드를 포함하는 로그 이벤트의 백분율과 함께 반환할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetLogRecord | 단일 로그 이벤트의 모든 필드 및 값을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetQueryResults | 지정된 쿼리의 결과를 반환할 수 있는 권한을 부여합니다. | 읽기 | |||
| Link [권한만 해당] | CloudWatch 리소스를 모니터링 계정과 공유할 수 있는 권한을 부여합니다. | 쓰기 | |||
| ListAnomalies | 요청하는 AWS 계정에서 탐지된 모든 이상 항목을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListLogAnomalyDetectors | 요청하는 AWS 계정와 연결된 모든 이상 탐지기를 반환할 수 있는 권한을 부여합니다. | 나열 | |||
| ListLogDeliveries [권한만 해당] | 지정된 계정 및/또는 로그 소스에 대한 모든 로그 전달을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListTagsForResource | 지정된 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListTagsLogGroup | 지정된 로그 그룹의 태그를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| PutAccountPolicy | 계정 수준의 데이터 보호 정책을 연결하여 로그 이벤트에서 민감한 정보를 감지하고 수정하는 권한을 부여합니다. | 쓰기 | |||
| PutDataProtectionPolicy | 로그 이벤트에서 민감한 정보를 감지하고 수정하기 위해 데이터 보호 정책을 첨부할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutDeliveryDestination | 배송지를 생성하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutDeliveryDestinationPolicy | 배송지 정책을 배송지에 연결할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutDeliverySource | 배송 출발지를 생성하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutDestination | 대상을 생성하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| PutDestinationPolicy | 기존 대상과 연결된 액세스 정책을 생성하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutLogEvents | 지정된 로그 스트림에 로그 이벤트의 배치를 업로드할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutMetricFilter | 지표 필터를 생성하거나 업데이트하고 이를 지정된 로그 그룹과 연결할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutQueryDefinition | 쿼리 정의를 생성하거나 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutResourcePolicy | 다른 AWS 서비스가 이 계정에 로그 이벤트를 적용할 수 있도록 하는 리소스 정책을 생성하거나 업데이트할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| PutRetentionPolicy | 지정된 로그 그룹의 보존을 설정할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutSubscriptionFilter | 구독 필터를 생성하거나 업데이트하고 이를 지정된 로그 그룹과 연결할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| StartLiveTail | CloudWatch Logs에서 Live Tail 세션을 시작할 수 있는 권한 부여 | 읽기 | |||
| StartQuery | CloudWatch Logs Insights를 사용하여 로그 그룹 쿼리를 예약할 수 있는 권한을 부여합니다. | 읽기 | |||
| StopLiveTail [권한만 해당] | 진행 중인 Live Tail 세션을 중지할 수 있는 권한 부여 | 읽기 | |||
| StopQuery | 진행 중인 CloudWatch Logs Insights 쿼리를 중지할 수 있는 권한을 부여합니다. | 읽기 | |||
| TagLogGroup | 지정된 로그 그룹에 지정된 태그를 추가하거나 업데이트할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| TagResource | 지정된 리소스에 지정된 태그를 추가하거나 업데이트할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| TestMetricFilter | 로그 이벤트 메시지의 샘플에 대해 지표 필터의 필터 패턴을 테스트할 수 있는 권한을 부여합니다. | 읽기 | |||
| Unmask [권한만 해당] | 데이터 보호 정책으로 수정된 숨겨지지 않은 로그 이벤트를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| UntagLogGroup | 지정된 로그 그룹에서 지정된 태그를 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | 지정된 리소스에서 지정된 태그를 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateAnomaly | 로그 이상 탐지기에서 보고한 모든 이상 항목을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateDeliveryConfiguration | 제공과 관련된 구성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateLogAnomalyDetector | 로그 이상 탐지기를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateLogDelivery [권한만 해당] | 지정된 로그 전달의 로그 전달 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
Amazon CloudWatch Logs에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업에서 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| log-group |
arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName}
|
|
| log-stream |
arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName}:log-stream:${LogStreamName}
|
|
| destination |
arn:${Partition}:logs:${Region}:${Account}:destination:${DestinationName}
|
|
| delivery-source |
arn:${Partition}:logs:${Region}:${Account}:delivery-source:${DeliverySourceName}
|
|
| delivery |
arn:${Partition}:logs:${Region}:${Account}:delivery:${DeliveryName}
|
|
| delivery-destination |
arn:${Partition}:logs:${Region}:${Account}:delivery-destination:${DeliveryDestinationName}
|
|
| anomaly-detector |
arn:${Partition}:logs:${Region}:${Account}:anomaly-detector:${DetectorId}
|
Amazon CloudWatch Logs에 사용되는 조건 키
Amazon CloudWatch Logs는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.
| 조건 키 | 설명 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청에서 전달되는 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:ResourceTag/${TagKey} | 리소스와 연결된 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:TagKeys | 요청에서 전달되는 태그 키를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| logs:DeliveryDestinationResourceArn | 요청에서 전달되는 로그 대상 ARN을 기준으로 액세스를 필터링합니다. | ARN |
| logs:LogGeneratingResourceArns | 요청에서 전달되는 로그 생성 리소스 ARN을 기준으로 액세스를 필터링합니다. | ArrayOfARN |
