# 이벤트 소스 매핑에 태그 사용
이벤트 소스 매핑에 태그를 지정하여 리소스를 구성하고 관리할 수 있습니다. 태그는 AWS 서비스 전반에서 지원되는 리소스와 연결된 자유 형식의 키-값 페어입니다. 태그 사용 사례에 대한 자세한 내용은 *AWS 리소스에 태그 지정 및 Tag Editor 사용 설명서*의 [일반적인 태그 지정 전략](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#tag-strategies)을 참조하세요.
이벤트 소스 매핑은 자체 태그를 가질 수 있는 함수와 연결됩니다. 이벤트 소스 매핑은 함수에서 태그를 자동으로 상속하지 않습니다. AWS Lambda API를 사용하여 태그를 보고 업데이트할 수 있습니다. Lambda 콘솔에서 특정 이벤트 소스 매핑을 관리하면서 태그를 보고 업데이트할 수도 있습니다(Amazon SQS에 프로비저닝 모드를 사용하는 태그 포함).
## 태그 작업에 필요한 권한
AWS Identity and Access Management(IAM) ID(사용자, 그룹 또는 역할)가 리소스의 태그를 읽거나 설정할 수 있도록 허용하려면 해당 권한을 부여합니다.
+ **lambda:ListTags** - 리소스에 태그가 있는 경우 리소스에서 `ListTags`를 직접적으로 호출해야 하는 모든 사람에게 이 권한을 부여합니다. 태그가 지정된 함수의 경우 `GetFunction`에도 이 권한이 필요합니다.
+ **lambda:TagResource** - `TagResource`를 직접적으로 호출하거나 생성 시 태그를 수행해야 하는 모든 사람에게 이 권한을 부여합니다.
선택적으로 리소스에 대한 `UntagResource` 직접 호출을 허용하도록 **lambda:UntagResource** 권한 부여를 고려하세요.
자세한 내용은 [Lambda에 대한 자격 증명 기반 IAM 정책](access-control-identity-based.md) 섹션을 참조하세요.
## Lambda 콘솔에서 태그 사용
Lambda 콘솔을 사용하여 태그가 있는 이벤트 소스 매핑을 생성하고, 기존 이벤트 소스 매핑에 태그를 추가하고, 태그로 이벤트 소스 매핑을 필터링할 수 있습니다(Amazon SQS에 프로비저닝 모드로 구성된 태그 포함).
Lambda 콘솔을 사용하여 지원되는 스트림 및 대기열 기반 서비스에 대한 트리거를 추가하면 Lambda가 자동으로 이벤트 소스 매핑을 생성합니다. 이러한 이벤트 소스에 대한 자세한 내용은 [Lambda가 스트림 및 대기열 기반 이벤트 소스의 레코드를 처리하는 방법](invocation-eventsourcemapping.md) 섹션을 참조하세요. 콘솔에서 이벤트 소스 매핑을 생성하려면 다음 사전 요구 사항이 필요합니다.
+ 함수.
+ 영향을 받는 서비스의 이벤트 소스.
트리거를 생성하거나 업데이트하는 데 사용하는 것과 동일한 사용자 인터페이스의 일부로 태그를 추가할 수 있습니다.
**이벤트 소스 매핑을 생성할 때 태그를 추가하려면 다음을 수행하세요.**
1. Lambda 콘솔의 [함수 페이지](https://console.aws.amazon.com/lambda/home#/functions)를 엽니다.
1. 함수의 이름을 선택합니다.
1. **함수 개요(Function overview)**에서 **트리거 추가(Add trigger)**를 선택합니다.
1. **트리거 구성** 아래의 드롭다운 목록에서 이벤트 소스의 출처 서비스 이름을 선택합니다.
1. 이벤트 소스의 핵심 구성을 제공합니다. 이벤트 소스 구성에 대한 자세한 내용은 [다른 AWS 서비스의 이벤트로 Lambda 간접 호출](lambda-services.md)의 관련 서비스 섹션을 참조하세요.
1. **이벤트 소스 매핑 구성**에서 **추가 설정**을 선택합니다.
1. **태그** 아래에서 **새 태그 추가**를 선택합니다.
1. **키** 필드에 태그 키를 입력합니다. 태그 지정 제한에 대한 자세한 내용은 *AWS 리소스에 태그 지정 및 Tag Editor 사용 설명서*의 [태그 이름 지정 제한 및 요구 사항](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices)을 참조하세요.
1. **추가**를 선택합니다.
**기존 이벤트 소스 매핑에 태그를 추가하려면 다음을 수행하세요.**
1. Lambda 콘솔에서 [이벤트 소스 매핑](https://console.aws.amazon.com/lambda/home#/event-source-mappings)을 엽니다.
1. 리소스 목록에서 **함수**와 **이벤트 소스 ARN**에 해당하는 이벤트 소스 매핑의 **UUID**를 선택합니다.
1. **일반 구성 창** 아래의 탭 목록에서 **태그**를 선택합니다.
1. **태그 관리**를 선택합니다.
1. **새 태그 추가**를 선택합니다.
1. **키** 필드에 태그 키를 입력합니다. 태그 지정 제한에 대한 자세한 내용은 *AWS 리소스에 태그 지정 및 Tag Editor 사용 설명서*의 [태그 이름 지정 제한 및 요구 사항](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices)을 참조하세요.
1. **저장**을 선택합니다.
**태그로 이벤트 소스 매핑을 필터링하려면 다음을 수행하세요.**
1. Lambda 콘솔에서 [이벤트 소스 매핑](https://console.aws.amazon.com/lambda/home#/event-source-mappings)을 엽니다.
1. 검색 창을 선택합니다.
1. 드롭다운 목록에서 **태그** 부제목 아래에서 태그 키를 선택합니다.
1. **용도: “tag-name”**을 선택하여 이 키로 태그가 지정된 모든 이벤트 소스 매핑을 보거나 **연산자**를 선택하여 값으로 추가 필터링할 수 있습니다.
1. 태그 키와 값의 조합으로 필터링하려면 태그 값을 선택합니다.
검색 상자는 태그 키 검색도 지원합니다. 목록에서 찾을 키의 이름을 입력합니다.
## AWS CLI에서 태그 사용
이벤트 소스 매핑을 포함하여 기존 Lambda 리소스에 Lambda API로 태그를 추가하고 제거할 수 있습니다. 또한 이벤트 소스 매핑을 생성할 때 태그를 추가하여 리소스의 전체 수명 주기 동안 태그를 유지할 수 있습니다.
### Lambda 태그 API를 사용하여 태그 업데이트
[TagResource](https://docs.aws.amazon.com/lambda/latest/api/API_TagResource.html) 및 [UntagResource](https://docs.aws.amazon.com/lambda/latest/api/API_UntagResource.html) API 작업을 통해 지원되는 Lambda 리소스에 대한 태그를 추가하고 제거할 수 있습니다.
AWS CLI를 사용하여 이러한 작업을 직접적으로 호출할 수 있습니다. 기존 리소스에 태그를 추가하려면 `tag-resource` 명령을 사용합니다. 이 예에서는 두 개의 태그를 추가합니다. 하나는 *Department*라는 키를 갖는 태그이고 다른 하나는 *CostCenter*라는 키를 갖는 태그입니다.
```
aws lambda tag-resource \
--resource arn:aws:lambda:us-east-2:123456789012:resource-type:my-resource \
--tags Department=Marketing,CostCenter=1234ABCD
```
태그를 제거하려면 `untag-resource` 명령을 사용합니다. 이 예에서는 *Department*라는 키가 있는 태그를 제거합니다.
```
aws lambda untag-resource --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier \
--tag-keys Department
```
### 이벤트 소스 매핑을 생성할 때 태그 추가
태그를 사용하여 새로운 Lambda 이벤트 소스 매핑을 생성하려면 [CreateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html) API 작업을 사용합니다. `Tags` 파라미터를 지정합니다. `create-event-source-mapping` AWS CLI 명령과 `--tags` 옵션을 사용하여 이 작업을 직접적으로 호출할 수 있습니다. CLI 명령에 대한 자세한 내용은 *AWS CLI Command Reference*의 [create-event-source-mapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-event-source-mapping.html)을 참조하세요.
`CreateEventSourceMapping`와 함께 `Tags` 파라미터를 사용하기 전에 역할에 이 작업에 필요한 일반적인 권한과 함께 리소스에 태그를 지정할 수 있는 권한이 있는지 확인하세요. 태그 지정 권한에 대한 자세한 내용은 [태그 작업에 필요한 권한](#esm-tags-required-permissions) 섹션을 참조하세요.
### Lambda 태그 API를 사용하여 태그 보기
특정 Lambda 리소스에 적용된 태그를 보려면 `ListTags` API 작업을 사용합니다. 자세한 내용은 [ListTags](https://docs.aws.amazon.com/lambda/latest/api/API_ListTags.html)를 참조하세요.
Amazon 리소스 이름(ARN)을 제공하여 `list-tags` AWS CLI 명령으로 이 작업을 직접적으로 호출할 수 있습니다.
```
aws lambda list-tags --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier
```
### 태그로 리소스 필터링
AWS Resource Groups Tagging API [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) API 작업을 사용하여 태그를 기준으로 리소스를 필터링할 수 있습니다. `GetResources` 작업은 최대 10개의 필터를 수신하며 각 필터는 태그 키와 최대 10개의 태그 값을 포함합니다. `GetResources`에 `ResourceType`을 지정하면 특정 리소스 유형별로 필터링할 수 있습니다.
`get-resources` AWS CLI 명령을 사용하여 이 작업을 직접적으로 호출할 수 있습니다. `get-resources` 사용 예는 *AWS CLI Command Reference*의 [get-resources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html#examples)를 참조하세요.