API 및 AWS CLI 태그 작업 사용

포커스 모드

API 및 AWS CLI 태그 작업 사용 - Amazon Athena

다음 태그 작업을 사용하여 리소스에서 태그를 추가, 제거 또는 나열할 수 있습니다.

API	CLI	작업 설명
`TagResource`	`tag-resource`	지정된 ARN이 있는 리소스에 태그를 한 개 이상 추가하거나 덮어씁니다.
`UntagResource`	`untag-resource`	지정된 ARN이 있는 리소스에서 태그를 한 개 이상 삭제합니다.
`ListTagsForResource`	`list‑tags‑for‑resource`	지정된 ARN이 있는 리소스의 태그를 한 개 이상 나열합니다.

리소스를 생성할 때 태그 추가

작업 그룹 또는 데이터 카탈로그를 생성할 때 태그를 추가하려면 CreateWorkGroup 또는 CreateDataCatalog API 작업이나 AWS CLI create-work-group 또는 create-data-catalog 명령과 함께 tags 파라미터를 사용합니다.

API 작업을 사용하여 태그 관리

이 섹션의 예제에서는 태그 API 작업을 사용하여 작업 그룹 및 데이터 카탈로그의 태그를 관리하는 방법을 보여줍니다. 예제는 Java 프로그래밍 언어로 작성되어 있습니다.

다음 예제에서는 작업 그룹 workgroupA에 두 개의 태그를 추가합니다.


List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey("tagKey1").withValue("tagValue1"));
tags.add(new Tag().withKey("tagKey2").withValue("tagValue2"));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA")
    .withTags(tags);

client.tagResource(request);

다음 예제에서는 데이터 카탈로그 datacatalogA에 두 개의 태그를 추가합니다.


List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey("tagKey1").withValue("tagValue1"));
tags.add(new Tag().withKey("tagKey2").withValue("tagValue2"));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA")
    .withTags(tags);

client.tagResource(request);

참고

중복된 태그 키를 동일한 리소스에 추가하지 마세요. 이렇게 할 경우 Athena에서 오류 메시지가 표시됩니다. 개별 TagResource 작업의 기존 태그 키를 사용하여 리소스에 태그를 지정할 경우 새 태그 값이 기존 값을 덮어씁니다.

예 - TagResource

다음 예제에서는 작업 그룹 workgroupA에 두 개의 태그를 추가합니다.


List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey("tagKey1").withValue("tagValue1"));
tags.add(new Tag().withKey("tagKey2").withValue("tagValue2"));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA")
    .withTags(tags);

client.tagResource(request);

다음 예제에서는 데이터 카탈로그 datacatalogA에 두 개의 태그를 추가합니다.


List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey("tagKey1").withValue("tagValue1"));
tags.add(new Tag().withKey("tagKey2").withValue("tagValue2"));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA")
    .withTags(tags);

client.tagResource(request);

참고

다음 예제에서는 작업 그룹 workgroupA에서 tagKey2를 제거합니다.


List<String> tagKeys = new ArrayList<>();
tagKeys.add("tagKey2");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA")
    .withTagKeys(tagKeys);

client.untagResource(request);

다음 예제에서는 데이터 카탈로그 datacatalogA에서 tagKey2를 제거합니다.


List<String> tagKeys = new ArrayList<>();
tagKeys.add("tagKey2");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA")
    .withTagKeys(tagKeys);

client.untagResource(request);

예 - UntagResource

다음 예제에서는 작업 그룹 workgroupA에서 tagKey2를 제거합니다.


List<String> tagKeys = new ArrayList<>();
tagKeys.add("tagKey2");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA")
    .withTagKeys(tagKeys);

client.untagResource(request);

다음 예제에서는 데이터 카탈로그 datacatalogA에서 tagKey2를 제거합니다.


List<String> tagKeys = new ArrayList<>();
tagKeys.add("tagKey2");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA")
    .withTagKeys(tagKeys);

client.untagResource(request);

다음 예제에서는 작업 그룹 workgroupA에 대한 태그를 나열합니다.


ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA");

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();

다음 예제에서는 데이터 카탈로그 datacatalogA에 대한 태그를 나열합니다.


ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA");

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();

예 - ListTagsForResource

다음 예제에서는 작업 그룹 workgroupA에 대한 태그를 나열합니다.


ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA");

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();

다음 예제에서는 데이터 카탈로그 datacatalogA에 대한 태그를 나열합니다.


ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA");

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();

AWS CLI를 사용하여 태그 관리

다음 예제는 AWS CLI를 사용하여 데이터 카탈로그에서 태그를 생성하고 관리하는 방법을 보여줍니다.

tag-resource 명령은 지정된 리소스에 태그를 한 개 이상 추가합니다.

구문

aws athena tag-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name --tags Key=string,Value=string Key=string,Value=string

--resource-arn 파라미터는 태그가 추가되는 리소스를 지정합니다. --tags 파라미터는 리소스에 태그로 추가할 공백으로 구분된 키-값 페어의 목록을 지정합니다.

예

다음 예제에서는 데이터 카탈로그 mydatacatalog에 태그를 추가합니다.


aws athena tag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tags Key=Color,Value=Orange Key=Time,Value=Now

결과를 표시하려면 list-tags-for-resource 명령을 사용합니다.

create-data-catalog 명령 사용 시 태그 추가에 대한 자세한 내용은 카탈로그 등록: Create-data-catalog 단원을 참조하세요.

리소스에 태그 추가: tag-resource

tag-resource 명령은 지정된 리소스에 태그를 한 개 이상 추가합니다.

구문

aws athena tag-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name --tags Key=string,Value=string Key=string,Value=string

예

다음 예제에서는 데이터 카탈로그 mydatacatalog에 태그를 추가합니다.


aws athena tag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tags Key=Color,Value=Orange Key=Time,Value=Now

결과를 표시하려면 list-tags-for-resource 명령을 사용합니다.

create-data-catalog 명령 사용 시 태그 추가에 대한 자세한 내용은 카탈로그 등록: Create-data-catalog 단원을 참조하세요.

list-tags-for-resource 명령은 지정된 리소스에 대한 태그를 나열합니다.

구문

aws athena list-tags-for-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name

--resource-arn 파라미터는 태그를 나열하기 위한 리소스를 지정합니다.

다음 예제에서는 데이터 카탈로그 mydatacatalog에 대한 태그를 나열합니다.


aws athena list-tags-for-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog

다음 샘플 결과는 JSON 형식입니다.


{
    "Tags": [
        {
            "Key": "Time",
            "Value": "Now"
        },
        {
            "Key": "Color",
            "Value": "Orange"
        }
    ]
}

리소스에 대한 태그 나열: list-tags-for-resource

list-tags-for-resource 명령은 지정된 리소스에 대한 태그를 나열합니다.

구문

aws athena list-tags-for-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name

--resource-arn 파라미터는 태그를 나열하기 위한 리소스를 지정합니다.

다음 예제에서는 데이터 카탈로그 mydatacatalog에 대한 태그를 나열합니다.


aws athena list-tags-for-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog

다음 샘플 결과는 JSON 형식입니다.


{
    "Tags": [
        {
            "Key": "Time",
            "Value": "Now"
        },
        {
            "Key": "Color",
            "Value": "Orange"
        }
    ]
}

untag-resource 명령은 지정된 리소스에서 지정된 태그 키 및 관련된 값을 제거합니다.

구문

aws athena untag-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name --tag-keys key_name [key_name ...]

--resource-arn 파라미터는 태그를 제거하기 위한 리소스를 지정합니다. --tag-keys 파라미터는 공백으로 구분된 키 이름 목록을 사용합니다. untag-resource 명령은 지정된 각 키 이름에서 키 및 해당 값을 모두 제거합니다.

다음 예제에서는 Color 및 Time 키와 해당 값을 mydatacatalog 카탈로그 리소스에서 제거합니다.


aws athena untag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tag-keys Color Time

리소스에서 태그 제거: untag-resource

untag-resource 명령은 지정된 리소스에서 지정된 태그 키 및 관련된 값을 제거합니다.

구문

aws athena untag-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name --tag-keys key_name [key_name ...]

다음 예제에서는 Color 및 Time 키와 해당 값을 mydatacatalog 카탈로그 리소스에서 제거합니다.


aws athena untag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tag-keys Color Time

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

작업 그룹에 대한 태그

태그 기반 IAM 액세스 제어 사용

다음 주제:

태그 기반 IAM 액세스 제어 사용

이전 주제:

작업 그룹에 대한 태그

도움이 필요하십니까?

이 페이지에서

페이지 내용이 도움이 되었습니까?

피드백 제공

프라이버시 사이트 이용 약관 쿠키 기본 설정

쿠키 기본 설정 선택

쿠키 기본 설정 사용자 지정

필수

성능

기능

광고

쿠키 기본 설정을 저장할 수 없음