기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon OpenSearch 서비스 도메인 태그 지정
태그를 사용하면 Amazon OpenSearch Service 도메인에 임의의 정보를 할당하여 해당 정보를 분류하고 필터링할 수 있습니다. 태그는 사용자가 정의하여 서비스 도메인과 연결하는 키-값 쌍입니다. OpenSearch 이러한 태그를 사용하면 비슷한 태그가 지정된 리소스의 비용을 그룹화하여 비용을 추적할 수 있습니다. AWS 태그에 어떠한 의미론적 의미도 적용하지 않습니다. 태그는 엄격히 문자열로 해석됩니다. 모든 태그에는 다음 요소가 포함되어 있습니다.
태그 요소 | 설명 | 필수 |
---|---|---|
태그 키 |
태그 키는 태그의 이름입니다. 키는 해당 키가 연결된 OpenSearch 서비스 도메인에만 고유해야 합니다. 태그 키 및 값에 대한 기본 제한 사항 목록은 사용자 정의 태그 제한을 참조하세요. |
예 |
태그 값 |
태그 값은 태그의 문자열 값입니다. 태그 값은 태그 세트에서 고유할 필요는 없으며 |
아니요 |
각 OpenSearch 서비스 도메인에는 해당 OpenSearch 서비스 도메인에 할당된 모든 태그가 포함된 태그 세트가 있습니다. AWS OpenSearch 서비스 도메인에 태그를 자동으로 할당하지 않습니다. 태그 세트는 0에서 50 사이의 태그를 포함할 수 있습니다. 기존 태그와 동일한 키가 있는 도메인에 태그를 추가하면 새 값이 이전 값을 덮어씁니다.
태그 예제
키를 사용하여 범주를 정의할 수 있으며 값은 해당 범주의 항목일 수 있습니다. 예를 들어, OpenSearch 서비스 도메인이 Salix 프로젝트에 할당되었음을 나타내는 태그 키와 태그 값을 정의할 수 있습니다. project
Salix
또는 같은 environment=test
키를 사용하여 태그를 사용하여 테스트 또는 프로덕션에 사용할 OpenSearch 서비스 도메인을 지정할 수도 있습니다. environment=production
OpenSearch 서비스 도메인과 관련된 메타데이터를 더 쉽게 추적할 수 있도록 일관된 태그 키 세트를 사용하세요.
또한 태그를 사용하여 자체 비용 구조를 반영하도록 AWS 청구서를 구성할 수 있습니다. 이렇게 하려면 가입하여 태그 키 값이 포함된 AWS 계정 청구서를 받아보세요. 그런 다음 같은 태그 키 값을 가진 리소스에 따라 결제 정보를 구성하여 리소스 비용의 합을 볼 수 있습니다. 예를 들어 여러 OpenSearch 서비스 도메인에 키-값 쌍을 태그한 다음 청구 정보를 구성하여 여러 서비스에 걸친 각 도메인의 총 비용을 확인할 수 있습니다. 자세한 내용은 AWS Billing and Cost Management 설명서의 비용 할당 태그 사용을 참조하세요.
참고
권한 부여 목적으로 태그가 캐시됩니다. 이로 인해 OpenSearch 서비스 도메인의 태그에 대한 추가 및 업데이트를 사용할 수 있을 때까지 몇 분 정도 걸릴 수 있습니다.
태그 작업(콘솔)
콘솔은 도메인에 태그를 지정하는 가장 간단한 방법입니다.
태그를 만들려면(콘솔)
-
https://aws.amazon.com
으로 이동하여 콘솔에 로그인(Sign In to the Console)을 선택합니다. -
애널리틱스에서 Amazon OpenSearch 서비스를 선택합니다.
-
태그를 추가할 도메인을 선택한 다음 [태그(Tags)] 탭으로 이동합니다.
-
[관리(Manage)], [새 태그 추가(Add new tag)]를 선택합니다.
-
태그 키와 선택 값을 입력합니다.
-
저장을 선택합니다.
태그를 삭제하려면 동일한 단계를 따르고 [태그 관리(Manage tags)] 페이지에서 [제거(Remove)]를 선택합니다.
콘솔을 사용한 태그 작업에 대한 자세한 내용은 AWS 관리 콘솔 시작 안내서에서 Tag Editor를 참조하세요.
태그 작업(AWS CLI)
AWS CLI --add-tags명령과 함께 사용하여 리소스 태그를 생성할 수 있습니다.
구문
add-tags --arn=<domain_arn> --tag-list
Key=<key>,Value=<value>
파라미터 | 설명 |
---|---|
--arn |
태그가 연결된 OpenSearch 서비스 도메인의 Amazon 리소스 이름. |
--tag-list |
공백으로 구분된 키-값 페어 세트로, 형식은 다음과 같습니다. Key=<key>,Value=<value> |
예
다음 예제에서는 logs 도메인에 대해 태그 2개를 생성합니다.
aws opensearch add-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-list Key=service,Value=OpenSearch Key=instances,Value=m3.2xlarge
--remove-tags명령을 사용하여 OpenSearch 서비스 도메인에서 태그를 제거할 수 있습니다.
구문
remove-tags --arn=<domain_arn> --tag-keys
Key=<key>,Value=<value>
파라미터 | 설명 |
---|---|
--arn |
태그가 연결된 OpenSearch 서비스 도메인의 Amazon 리소스 이름 (ARN). |
--tag-keys |
서비스 도메인에서 제거하려는 공백으로 구분된 키-값 쌍 세트. OpenSearch |
예
다음 예제에서는 이전 예제에서 생성한 logs 도메인에서 태그 2개를 제거합니다.
aws opensearch remove-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-keys service instances
다음 명령을 사용하여 OpenSearch 서비스 도메인의 기존 태그를 볼 수 있습니다. --list-tags
구문
list-tags --arn=<domain_arn>
파라미터 | 설명 |
---|---|
--arn |
태그가 연결된 OpenSearch 서비스 도메인의 Amazon 리소스 이름 (ARN). |
예
다음 예제에서는 logs 도메인에 대한 리소스 태그를 모두 나열합니다.
aws opensearch list-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs
태그 (AWS SDK) 사용
AWS SDK (Android 및 iOS SDK 제외) 는, 및 RemoveTags
작업을 포함하여 Amazon OpenSearch 서비스 API 참조에 정의된 모든 작업을 지원합니다. AddTags
ListTags
AWS SDK 설치 및 사용에 대한 자세한 내용은 AWS 소프트웨어
Python
이 예제에서는 AWS SDK for Python (Boto) 의 OpenSearchServiceDOMAIN_ARN
, TAG_KEY
및 TAG_VALUE
의 값을 입력해야 합니다.
import boto3 from botocore.config import Config # import configuration DOMAIN_ARN = '' # ARN for the domain. i.e "arn:aws:es:us-east-1:123456789012:domain/my-domain TAG_KEY = '' # The name of the tag key. i.e 'Smileyface' TAG_VALUE = '' # The value assigned to the tag. i.e 'Practicetag' # defines the configurations parameters such as region my_config = Config(region_name='us-east-1') client = boto3.client('opensearch', config=my_config) # defines the client variable def addTags(): """Adds tags to the domain""" response = client.add_tags(ARN=DOMAIN_ARN, TagList=[{'Key': TAG_KEY, 'Value': TAG_VALUE}]) print(response) def listTags(): """List tags that have been added to the domain""" response = client.list_tags(ARN=DOMAIN_ARN) print(response) def removeTags(): """Remove tags that have been added to the domain""" response = client.remove_tags(ARN=DOMAIN_ARN, TagKeys=[TAG_KEY]) print('Tag removed') return response