이벤트 소스 매핑에 태그 사용

이벤트 소스 매핑에 태그를 지정하여 리소스를 구성하고 관리할 수 있습니다. 태그는 AWS 서비스 전반에서 지원되는 리소스와 연결된 자유 형식의 키-값 페어입니다. 태그 사용 사례에 대한 자세한 내용은 AWS 리소스에 태그 지정 및 Tag Editor 사용 설명서의 일반적인 태그 지정 전략을 참조하세요.

이벤트 소스 매핑은 자체 태그를 가질 수 있는 함수와 연결됩니다. 이벤트 소스 매핑은 함수에서 태그를 자동으로 상속하지 않습니다. AWS Lambda API를 사용하여 태그를 보고 업데이트할 수 있습니다. Lambda 콘솔에서 특정 이벤트 소스 매핑을 관리하면서 태그를 보고 업데이트할 수도 있습니다.

태그 작업에 필요한 권한

AWS Identity and Access Management(IAM) ID(사용자, 그룹 또는 역할)가 리소스의 태그를 읽거나 설정할 수 있도록 허용하려면 해당 권한을 부여합니다.

• lambda:ListTags - 리소스에 태그가 있는 경우 리소스에서 ListTags를 직접적으로 호출해야 하는 모든 사람에게 이 권한을 부여합니다. 태그가 지정된 함수의 경우 GetFunction에도 이 권한이 필요합니다.

• lambda:TagResource - TagResource를 직접적으로 호출하거나 생성 시 태그를 수행해야 하는 모든 사람에게 이 권한을 부여합니다.

자세한 내용은 Lambda에 대한 자격 증명 기반 IAM 정책 단원을 참조하십시오.

Lambda 콘솔에서 태그 사용

Lambda 콘솔을 사용하여 태그가 있는 이벤트 소스 매핑을 생성하고, 기존 이벤트 소스 매핑에 태그를 추가하고, 태그로 이벤트 소스 매핑을 필터링할 수 있습니다.

Lambda 콘솔을 사용하여 지원되는 스트림 및 대기열 기반 서비스에 대한 트리거를 추가하면 Lambda가 자동으로 이벤트 소스 매핑을 생성합니다. 이러한 이벤트 소스에 대한 자세한 내용은 Lambda가 스트림 및 대기열 기반 이벤트 소스의 레코드를 처리하는 방법 섹션을 참조하세요. 콘솔에서 이벤트 소스 매핑을 생성하려면 다음 사전 요구 사항이 필요합니다.

• 함수.

• 영향을 받는 서비스의 이벤트 소스.

트리거를 생성하거나 업데이트하는 데 사용하는 것과 동일한 사용자 인터페이스의 일부로 태그를 추가할 수 있습니다.

이벤트 소스 매핑을 생성할 때 태그를 추가하려면 다음을 수행하세요.

1. Lambda 콘솔의 함수 페이지를 엽니다.

2. 함수의 이름을 선택합니다.

3. 함수 개요(Function overview)에서 트리거 추가(Add trigger)를 선택합니다.

4. 트리거 구성 아래의 드롭다운 목록에서 이벤트 소스의 출처 서비스 이름을 선택합니다.

5. 이벤트 소스의 핵심 구성을 제공합니다. 이벤트 소스 구성에 대한 자세한 내용은 다른 AWS 서비스의 이벤트로 Lambda 간접 호출의 관련 서비스 섹션을 참조하세요.

6. 이벤트 소스 매핑 구성에서 추가 설정을 선택합니다.

7. 태그 아래에서 새 태그 추가를 선택합니다.

8. 키 필드에 태그 키를 입력합니다. 태그 지정 제한에 대한 자세한 내용은 AWS 리소스에 태그 지정 및 Tag Editor 사용 설명서의 태그 이름 지정 제한 및 요구 사항을 참조하세요.

9. 추가를 선택합니다.

기존 이벤트 소스 매핑에 태그를 추가하려면 다음을 수행하세요.

1. Lambda 콘솔에서 이벤트 소스 매핑을 엽니다.

2. 리소스 목록에서 함수와 이벤트 소스 ARN에 해당하는 이벤트 소스 매핑의 UUID를 선택합니다.

3. 일반 구성 창 아래의 탭 목록에서 태그를 선택합니다.

4. 태그 관리를 선택합니다.

5. 새 태그 추가를 선택합니다.

6. 키 필드에 태그 키를 입력합니다. 태그 지정 제한에 대한 자세한 내용은 AWS 리소스에 태그 지정 및 Tag Editor 사용 설명서의 태그 이름 지정 제한 및 요구 사항을 참조하세요.

7. Save(저장)를 선택합니다.

태그로 이벤트 소스 매핑을 필터링하려면 다음을 수행하세요.

1. Lambda 콘솔에서 이벤트 소스 매핑을 엽니다.

2. 검색 창을 선택합니다.

3. 드롭다운 목록에서 태그 부제목 아래에서 태그 키를 선택합니다.

4. 용도: “tag-name”을 선택하여 이 키로 태그가 지정된 모든 이벤트 소스 매핑을 보거나 연산자를 선택하여 값으로 추가 필터링할 수 있습니다.

5. 태그 키와 값의 조합으로 필터링하려면 태그 값을 선택합니다.

검색 상자는 태그 키 검색도 지원합니다. 목록에서 찾을 키의 이름을 입력합니다.

AWS CLI에서 태그 사용

이벤트 소스 매핑을 포함하여 기존 Lambda 리소스에 Lambda API로 태그를 추가하고 제거할 수 있습니다. 또한 이벤트 소스 매핑을 생성할 때 태그를 추가하여 리소스의 전체 수명 주기 동안 태그를 유지할 수 있습니다.

Lambda 태그 API를 사용하여 태그 업데이트

TagResource 및 UntagResource 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 API 작업을 사용합니다. Tags 파라미터를 지정합니다. create-event-source-mapping AWS CLI 명령과 --tags 옵션을 사용하여 이 작업을 직접적으로 호출할 수 있습니다. CLI 명령에 대한 자세한 내용은 AWS CLI Command Reference의 create-event-source-mapping을 참조하세요.

CreateEventSourceMapping와 함께 Tags 파라미터를 사용하기 전에 역할에 이 작업에 필요한 일반적인 권한과 함께 리소스에 태그를 지정할 수 있는 권한이 있는지 확인하세요. 태그 지정 권한에 대한 자세한 내용은 태그 작업에 필요한 권한 섹션을 참조하세요.

Lambda 태그 API를 사용하여 태그 보기

특정 Lambda 리소스에 적용된 태그를 보려면 ListTags API 작업을 사용합니다. 자세한 내용은 ListTags를 참조하세요.

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 API 작업을 사용하여 태그를 기준으로 리소스를 필터링할 수 있습니다. GetResources 작업은 최대 10개의 필터를 수신하며 각 필터는 태그 키와 최대 10개의 태그 값을 포함합니다. GetResources에 ResourceType을 지정하면 특정 리소스 유형별로 필터링할 수 있습니다.

get-resources AWS CLI 명령을 사용하여 이 작업을 직접적으로 호출할 수 있습니다. get-resources 사용 예는 AWS CLI Command Reference의 get-resources를 참조하세요.