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

# Amazon Bedrock 리소스 태그 지정
<a name="tagging"></a>

Amazon Bedrock 리소스 관리를 지원하려면 각 리소스에 메타데이터를 태그로 할당할 수 있습니다. 태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 키와 값으로 구성됩니다.

태그를 사용하면 용도, 소유자 또는 애플리케이션 등 다양한 방식으로 AWS 리소스를 분류할 수 있습니다. 태그 지정에 대한 모범 사례 및 제한은 [AWS 리소스 태그 지정을 참조하세요](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).

태그는 다음을 지원합니다.
+  AWS 리소스를 식별하고 구성합니다. 많은 AWS 리소스가 태그 지정을 지원하므로 다른 서비스의 리소스에 동일한 태그를 할당하여 리소스가 동일함을 나타낼 수 있습니다.
+ 비용을 할당합니다. AWS 결제 및 비용 관리 대시보드에서 태그를 활성화합니다. AWS 는 태그를 사용하여 비용을 분류하고 월별 비용 할당 보고서를 제공합니다. 자세한 내용은 *AWS 결제 및 비용 관리 사용자 가이드*의 [비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하세요.
+  리소스에 대한 액세스를 제어합니다. Amazon Bedrock과 함께 태그를 사용하여 Amazon Bedrock 리소스에 대한 액세스를 제어하는 정책을 생성할 수 있습니다. 이러한 정책을 IAM 역할 또는 사용자에 연결하여 태그 기반 액세스 제어를 활성화할 수 있습니다.

**Topics**
+ [콘솔을 사용합니다.](#tagging-console)
+ [API 사용](#tagging-api)

## 콘솔을 사용합니다.
<a name="tagging-console"></a>

지원되는 리소스를 만들거나 편집하는 동안 언제든지 태그를 추가, 수정 및 제거할 수 있습니다.

## API 사용
<a name="tagging-api"></a>

태깅 작업을 수행하려면, 태깅 작업을 수행하려는 리소스의 Amazon 리소스 이름(ARN)이 필요합니다. 태그를 추가하거나 관리하는 리소스에 따라 두 세트의 태깅 작업을 사용할 수 있습니다.

다음 표에는 다양한 사용 사례와 이에 사용할 태그 지정 작업이 요약되어 있습니다.


****  

| 사용 사례: | [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) API 작업으로 생성된 리소스 | [Amazon Bedrock Agents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) API 작업으로 생성된 리소스 | Amazon Bedrock Data Automation API로 생성된 리소스 | 
| --- | --- | --- | --- | 
| 리소스에 태그 지정 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/tagging.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/tagging.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/tagging.html)  | 
| 리소스에서 태그 제거 | [Amazon Bedrock 컨트롤 플레인 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)를 사용하여 [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)를 요청합니다. | [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)를 요청합니다. | Amazon Bedrock Data Automation 빌드 타임 엔드포인트를 사용하여 UntagResource를 요청합니다. | 
| 리소스에 대한 태그 나열 | [Amazon Bedrock 컨트롤 플레인 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)를 사용하여 [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)를 요청합니다. | [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)를 요청합니다. | Amazon Bedrock Data Automation 빌드 타임 엔드포인트를 사용하여 ListTagsForResource를 요청합니다. | 

**참고**  
CloudTrail에서 이러한 작업을 볼 때 이벤트 세부 정보에서 요청 파라미터를 확인하여 태그가 지정된 특정 리소스를 식별할 수 있습니다.

탭을 선택하면 인터페이스 또는 해당 언어로 된 코드 예제를 볼 수 있습니다.

------
#### [ AWS CLI ]

에이전트에 두 개의 태그를 추가합니다. 키/값 페어는 공백으로 구분합니다.

```
aws bedrock-agent tag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tags key=department,value=billing key=facing,value=internal
```

에이전트에서 태그를 제거합니다. 키는 공백으로 구분합니다.

```
aws bedrock-agent untag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tag-keys key=department facing
```

에이전트에 대한 태그를 나열합니다

```
aws bedrock-agent list-tags-for-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"
```

------
#### [ Python (Boto) ]

에이전트에 두 개의 태그를 추가합니다.

```
import boto3

bedrock = boto3.client(service_name='bedrock-agent')

tags = [
    {
        'key': 'department',
        'value': 'billing'
    },
    {
        'key': 'facing',
        'value': 'internal'
    }
]

bedrock.tag_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', tags=tags)
```

에이전트에서 태그를 제거합니다.

```
bedrock.untag_resource(
    resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', 
    tagKeys=['department', 'facing']
)
```

에이전트에 대한 태그를 나열합니다

```
bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')
```

------