Amazon OpenSearch 서비스 도메인 태그 지정 - 아마존 OpenSearch 서비스
태그 예제태그 작업(콘솔)태그 작업(AWS CLI)태그 (AWS SDK) 사용

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

Amazon OpenSearch 서비스 도메인 태그 지정

태그를 사용하면 Amazon OpenSearch Service 도메인에 임의의 정보를 할당하여 해당 정보를 분류하고 필터링할 수 있습니다. 태그는 사용자가 정의하여 서비스 도메인과 연결하는 키-값 쌍입니다. OpenSearch 이러한 태그를 사용하면 비슷한 태그가 지정된 리소스의 비용을 그룹화하여 비용을 추적할 수 있습니다. AWS 태그에 어떠한 의미론적 의미도 적용하지 않습니다. 태그는 엄격히 문자열로 해석됩니다. 모든 태그에는 다음 요소가 포함되어 있습니다.

태그 요소 설명 필수
태그 키

태그 키는 태그의 이름입니다. 키는 해당 키가 연결된 OpenSearch 서비스 도메인에만 고유해야 합니다. 태그 키 및 값에 대한 기본 제한 사항 목록은 사용자 정의 태그 제한을 참조하세요.

 예
태그 값

태그 값은 태그의 문자열 값입니다. 태그 값은 태그 세트에서 고유할 필요는 없으며 null일 수 있습니다. 예를 들어, project/Trinity 및 cost-center/Trinity의 태그 세트에 키-값 페어가 있을 수 있습니다. 태그 키 및 값에 대한 기본 제한 사항 목록은 사용자 정의 태그 제한을 참조하세요.

 아니요

각 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 서비스 도메인의 태그에 대한 추가 및 업데이트를 사용할 수 있을 때까지 몇 분 정도 걸릴 수 있습니다.

태그 작업(콘솔)

콘솔은 도메인에 태그를 지정하는 가장 간단한 방법입니다.

태그를 만들려면(콘솔)

  1. https://aws.amazon.com으로 이동하여 콘솔에 로그인(Sign In to the Console)을 선택합니다.

  2. 애널리틱스에서 Amazon OpenSearch 서비스를 선택합니다.

  3. 태그를 추가할 도메인을 선택한 다음 [태그(Tags)] 탭으로 이동합니다.

  4. [관리(Manage)], [새 태그 추가(Add new tag)]를 선택합니다.

  5. 태그 키와 선택 값을 입력합니다.

  6. 저장을 선택합니다.

태그를 삭제하려면 동일한 단계를 따르고 [태그 관리(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) 의 OpenSearchService하위 수준 Python 클라이언트를 사용하여 도메인에 태그를 추가하고, 도메인에 연결된 태그를 나열하고, 도메인에서 태그를 제거합니다. DOMAIN_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