개요
AWS에서 태그(tag)는 리소스를 체계적으로 분류·관리하고, 비용 배분 추적이나 세부적인 액세스 제어에 활용할 수 있는 핵심 기능입니다. 이 글에서는 Python의 boto3 라이브러리를 사용해 AWS Glue 리소스에 태그를 추가하는 방법을 단계별로 살펴봅니다.
예제 시나리오
AWS Glue 데이터베이스에 "glue-db: test"라는 태그를 추가해 보겠습니다.
문제 정의: Python의 boto3 라이브러리를 활용하여 AWS Glue 리소스에 태그를 추가합니다.
해결 접근 방식 및 알고리즘
1단계: 예외 처리를 위해 boto3와 botocore.exceptions 모듈을 임포트합니다.
2단계: 이 함수에는 resource_arn(태그를 추가할 대상 리소스의 ARN)과 tags_dict(추가할 태그가 담긴 딕셔너리) 두 가지 필수 파라미터가 필요합니다.
resource_arn은 리소스 유형에 따라 아래와 같은 형식을 따라야 합니다.
| 리소스 유형 | ARN 형식 |
|---|---|
| 카탈로그(Catalog) | arn:aws:glue:region:account-id:catalog |
| 데이터베이스(Database) | arn:aws:glue:region:account-id:database/데이터베이스 이름 |
| 테이블(Table) | arn:aws:glue:region:account-id:table/데이터베이스 이름/테이블 이름 |
| 연결(Connection) | arn:aws:glue:region:account-id:connection/연결 이름 |
| 크롤러(Crawler) | arn:aws:glue:region:account-id:crawler/크롤러 이름 |
| 작업(Job) | arn:aws:glue:region:account-id:job/작업 이름 |
| 트리거(Trigger) | arn:aws:glue:region:account-id:trigger/트리거 이름 |
| 개발 엔드포인트(DevEndpoint) | arn:aws:glue:region:account-id:devEndpoint/개발 엔드포인트 이름 |
| 머신 러닝 변환(ML Transform) | arn:aws:glue:region:account-id:mlTransform/변환 ID |
tags_dict는 {"키": "값", ...} 형태의 딕셔너리로 작성해야 합니다.
3단계: boto3 라이브러리로 AWS 세션을 생성합니다. 기본 프로필에 region_name이 설정되어 있는지 확인하고, 설정되어 있지 않다면 세션 생성 시 region_name을 명시적으로 전달해야 합니다.
4단계: glue 서비스용 AWS 클라이언트를 생성합니다.
5단계: tag_resource 함수를 호출하면서 resource_arn은 ResourceArn 파라미터로, tags_dict는 TagsToAdd 파라미터로 각각 전달합니다.
6단계: 함수는 응답 메타데이터를 반환하며, 지정한 리소스에 태그가 정상적으로 추가됩니다.
7단계: 태그 추가 과정에서 오류가 발생할 경우를 대비해 일반 예외(generic exception) 처리 로직을 포함합니다.
예제 코드
아래 코드를 사용하면 태그를 손쉽게 추가할 수 있습니다.
import boto3
from botocore.exceptions import ClientError
def add_tags_in_resource(resource_arn, tags_dict):
session = boto3.session.Session()
glue_client = session.client('glue')
try:
response = glue_client.tag_resource(ResourceArn=resource_arn, TagsToAdd=tags_dict)
return response
except ClientError as e:
raise Exception("boto3 client error in add_tags_in_resource: " + e.__str__())
except Exception as e:
raise Exception("Unexpected error in add_tags_in_resource: " + e.__str__())
tags_dict = {"glue-db": "test"}
print(add_tags_in_resource("arn:aws:glue:us-east-1:1122225*****88:database/test-db", tags_dict))실행 결과
{'ResponseMetadata': {'RequestId': 'c9f418b0-***************-fb96', 'HTTPStatusCode': 200, 'HTTPHeaders': {'date': 'Fri, 02 Apr 2021 08:04:54 GMT', 'content-type': 'application/x-amz-json-1.1', 'content-length': '27', 'connection': 'keep-alive', 'x-amzn-requestid': 'c9f418b0-******************-fb96'}, 'RetryAttempts': 0}}응답의 HTTP 상태 코드가 200이면 태그가 성공적으로 추가된 것입니다. 이후 AWS Management Console 또는 list_tags_for_resource API를 호출하여 해당 리소스에 적용된 태그를 확인할 수 있습니다.