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

Amazon Bedrock 리소스 태그 지정

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

태그를 사용하면 용도, 소유자 또는 애플리케이션 등 다양한 방식으로 AWS 리소스를 분류할 수 있습니다. 태그 지정에 대한 모범 사례 및 제한 사항은 AWS 리소스 태그 지정을 참조하세요.

태그는 다음을 지원합니다.

bedrock-runtime 엔드포인트의 리소스에 태그 지정

bedrock-runtime 컨트롤 플레인을 통해 생성된 리소스(예: 에이전트, 지식 기반, 사용자 지정 모델, 프로비저닝된 처리량 및 흐름)는 전용 태그 지정 API 작업을 사용하여 태그 지정됩니다.

콘솔을 사용합니다.

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

API 사용

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

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

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

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')

bedrock-mantle 엔드포인트의 리소스에 태그 지정

bedrock-mantle 엔드포인트는 태그 지정 프로젝트, 사용자 지정 모델 및 예약을 지원합니다. bedrock-runtime 컨트롤 플레인과 달리 bedrock-mantle는 전용 TagResource, UntagResource또는 ListTagsForResource API 작업을 노출하지 않습니다. 대신 리소스 APIs.

태그 설정

태그는 이러한 리소스에 대한 응답 가져오기 및 나열에 인라인으로 반환됩니다.

IAM 작업

전용 태그 지정 엔드포인트는 없지만 bedrock-mantle 리소스에서 태그를 설정, 변경 또는 읽을 때 다음 IAM 작업이 평가됩니다. 이러한 작업 이름과 aws:RequestTag, aws:TagKeys및 aws:ResourceTag 조건 키를 사용하여 태그 기반 액세스를 제어하는 IAM 정책을 작성할 수 있습니다.

예제

다음 예제에서는를 사용하여 두 개의 태그가 있는 프로젝트를 생성합니다curl.

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "billing-experiments",
      "tags": {
        "department": "billing",
        "facing": "internal"
      }
    }'

다음 예제에서는 하나의 태그를 추가하고 기존 프로젝트에서 다른 태그를 제거합니다.

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "add_tags": { "owner": "alice" },
      "remove_tag_keys": ["facing"]
    }'