Lambda 함수에서 태그 사용 - AWS Lambda

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

Lambda 함수에서 태그 사용

AWS Lambda 함수에 태그를 지정하여 ABAC(속성 기반 액세스 제어)를 활성화하고 소유자, 프로젝트 또는 부서별로 구성할 수 있습니다. 태그는 ABAC에서 리소스를 필터링하고 결제 보고서에 세부 정보를 추가하는 데 사용할 수 있도록 AWS 서비스 전체에서 지원되는 자유형 키-값 페어입니다.

태그는 버전이나 별칭이 아닌 함수 수준에서 적용됩니다. 태그는 버전을 게시할 때 스냅샷이 생성되는 버전별 구성에 포함되지 않습니다.

태그 작업에 필요한 권한

함수를 사용하는 사람의 AWS Identity and Access Management(IAM) 자격 증명(사용자, 그룹 또는 역할)에 적절한 권한을 부여합니다.

  • lambda: ListTags ListTags 함수에 태그가 있으면 함수를 GetFunction 호출하거나 호출해야 하는 모든 사람에게 이 권한을 부여하십시오.

  • lambda: TagResource — 또는 를 호출해야 하는 모든 사람에게 이 권한을 부여합니다. CreateFunction TagResource

자세한 설명은 Lambda에 대한 자격 증명 기반 IAM 정책 섹션을 참조하세요.

Lambda 콘솔에서 태그 사용

Lambda 콘솔을 사용하여 태그가 있는 함수를 생성하고 기존 함수에 태그를 추가하고 추가한 태그를 기준으로 함수를 필터링할 수 있습니다.

함수를 생성할 때 태그를 추가하려면
  1. Lambda 콘솔의 함수 페이지를 엽니다.

  2. 함수 생성을 선택합니다.

  3. 새로 작성(Author from scratch) 또는 컨테이너 이미지(Container image)를 선택합니다.

  4. 기본 정보에서 다음과 같이 합니다.

    1. 함수 이름(Function name)에 함수 이름을 입력합니다. 함수 이름은 64자로 제한됩니다.

    2. 런타임에서 함수에 사용할 언어 버전을 선택합니다.

    3. (선택 사항) 아키텍처(Architecture)에서 함수에 사용할 명령 세트 아키텍처를 선택합니다. 기본 아키텍처는 x86_64입니다. 함수의 배포 패키지를 빌드할 때 해당 패키지가 이 명령 세트 아키텍처와 호환되는지 확인합니다.

  5. 고급 설정(Advanced settings)을 확장한 다음 태그 활성화(Enable tags)를 선택합니다.

  6. 이렇게 하려면 태그 추가(Add new tag)를 선택한 다음 키(Key) 및 선택 사항인 값(Value)을 입력합니다. 태그를 더 추가하려면 이 단계를 반복합니다.

  7. 함수 생성을 선택합니다.

기존 함수에 태그를 추가하려면
  1. Lambda 콘솔의 함수 페이지를 엽니다.

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

  3. 구성(Configuration)을 선택한 다음 태그(Tags)를 선택합니다.

  4. 태그에서 태그 관리(Manage tags)를 선택합니다.

  5. 이렇게 하려면 태그 추가(Add new tag)를 선택한 다음 키(Key) 및 선택 사항인 값(Value)을 입력합니다. 태그를 더 추가하려면 이 단계를 반복합니다.

    
              Lambda 콘솔에서 함수에 태그를 지정합니다.
  6. 저장을 선택합니다.

태그를 사용하여 함수를 필터링하려면
  1. Lambda 콘솔의 함수 페이지를 엽니다.

  2. 검색 창을 선택하여 함수 속성 및 태그 키 목록을 표시합니다.

    
              함수 검색 창의 태그입니다.
  3. 태그 키를 선택하여 현재 AWS 리전에서 사용 중인 값 목록을 표시합니다.

  4. 값을 선택하여 해당 값을 가진 함수를 표시하거나 (모든 값)을 선택하여 해당 키와 함께 태그가 있는 모든 함수를 표시합니다.

    
              태그 값 기준으로 필터링.

검색 창은 태그 키 검색도 지원합니다. tag을(를) 입력하여 태그 키 목록만 표시하거나 키 이름을 입력하여 목록에서 찾습니다.

AWS CLI에서 태그 사용

태그 추가 및 제거

태그를 사용하여 새 Lambda 함수를 생성하려면 create-function 명령을 —tags 옵션과 함께 사용합니다.

aws lambda create-function --function-name my-function --handler index.js --runtime nodejs20.x \ --role arn:aws:iam::123456789012:role/lambda-role \ --tags Department=Marketing,CostCenter=1234ABCD

기존 함수에 태그를 추가하려면 tag-resource 명령을 사용하세요.

aws lambda tag-resource \ --resource arn:aws:lambda:us-east-2:123456789012:function:my-function \ --tags Department=Marketing,CostCenter=1234ABCD

태그를 제거하려면 untag-resource 명령을 사용합니다.

aws lambda untag-resource --resource arn:aws:lambda:us-east-1:123456789012:function:my-function \ --tag-keys Department

함수의 태그 보기

특정 Lambda 함수에 적용된 태그를 보려면 다음 AWS CLI 명령 중 하나를 사용할 수 있습니다.

  • ListTags— 이 함수와 관련된 태그 목록을 보려면 Lambda 함수 ARN (Amazon 리소스 이름) 을 포함하십시오.

    aws lambda list-tags --resource arn:aws:lambda:us-east-1:123456789012:function:my-function
  • GetFunction— 이 함수와 관련된 태그 목록을 보려면 Lambda 함수 이름을 포함하십시오.

    aws lambda get-function --function-name my-function

태그를 기준으로 함수 필터링

AWS Resource Groups Tagging APIGetResourcesAPI 작업을 사용하여 태그를 기준으로 리소스를 필터링할 수 있습니다. GetResources 작업은 최대 10개의 필터를 수신하며 각 필터는 태그 키와 최대 10개의 태그 값을 포함합니다. GetResourcesResourceType을 지정하면 특정 리소스 유형별로 필터링할 수 있습니다.

AWS Resource Groups에 대한 자세한 내용은 AWS Resource Groups 및 태그 사용 설명서에서 Resource Groups란 무엇입니까?를 참조하세요.

태그 요구 사항

태그에 적용되는 요구 사항은 다음과 같습니다.

  • 리소스당 최대 태그 수: 50개

  • 최대 키 길이: UTF-8의 유니코드 문자 128자

  • 최대 값 길이: 유니코드 문자 256자(UTF-8)

  • 태그 키와 값은 대/소문자를 구분합니다.

  • 태그 이름이나 값에서 aws: 접두사는 사용하지 마세요. 이 단어는 AWS용으로 예약되어 있습니다. 이 접두사가 지정된 태그 이름이나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.

  • 태그 지정 스키마를 여러 서비스와 리소스에서 사용하려는 경우, 서비스마다 허용되는 문자에 대한 제한이 다를 수 있음에 유의하십시오. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 공백 및 숫자와 특수 문자+ - = . _ : / @