Memberi tanda pada sumber daya

Untuk membantu mengelola sumber daya Amazon Bedrock, Anda dapat menetapkan metadata ke setiap sumber daya sebagai tag. Tag adalah label yang Anda tetapkan ke AWS sumber daya. Setiap tanda terdiri dari sebuah kunci dan sebuah nilai.

Tag memungkinkan Anda untuk mengkategorikan AWS sumber daya Anda dengan cara yang berbeda, misalnya, berdasarkan tujuan, pemilik, atau aplikasi. Tag membantu Anda melakukan hal berikut:

• Identifikasi dan atur AWS sumber daya Anda. Banyak AWS sumber daya mendukung penandaan, sehingga Anda dapat menetapkan tag yang sama ke sumber daya di layanan yang berbeda untuk menunjukkan bahwa sumber dayanya sama.

• Alokasikan biaya. Anda mengaktifkan tag di AWS Billing and Cost Management dasbor. AWS menggunakan tag untuk mengkategorikan biaya Anda dan mengirimkan laporan alokasi biaya bulanan kepada Anda. Untuk informasi selengkapnya, lihat Menggunakan tag alokasi biaya di Panduan AWS Billing and Cost Management Pengguna.

• Mengendalikan akses ke sumber daya Anda. Anda dapat menggunakan tag dengan Amazon Bedrock untuk membuat kebijakan untuk mengontrol akses ke sumber daya Amazon Bedrock. Kebijakan ini dapat dilampirkan ke peran IAM atau pengguna untuk mengaktifkan kontrol akses berbasis tag.

Sumber daya Amazon Bedrock yang dapat Anda tag adalah:

• Model kustom

• Pekerjaan kustomisasi model

• Model yang disediakan

• Pekerjaan inferensi Batch (hanya API)

• Agen

• Alias agen

• Basis pengetahuan

• Evaluasi model (hanya konsol)

Gunakan konsol

Anda dapat menambahkan, memodifikasi, dan menghapus tag kapan saja saat membuat atau mengedit sumber daya yang didukung.

Gunakan API

Untuk melakukan operasi penandaan, Anda memerlukan Nama Sumber Daya Amazon (ARN) dari sumber daya tempat Anda ingin melakukan operasi penandaan. Ada dua set operasi penandaan, tergantung pada sumber daya yang Anda tambahkan atau kelola tag.

1. Sumber daya berikut menggunakan Amazon Bedrock TagResource, UntagResource, dan ListTagsForResourceoperasi.

   • Model kustom

   • Pekerjaan kustomisasi model

   • Model yang disediakan

   • Pekerjaan inferensi Batch

2. Sumber daya berikut menggunakan Agen untuk Amazon Bedrock TagResource, UntagResource, dan ListTagsForResourceoperasi.

   • Agen

   • Alias agen

   • Basis pengetahuan

Untuk menambahkan tag ke sumber daya, kirim permintaan Amazon Bedrock TagResourceatau Agen untuk Amazon Bedrock TagResource.

Untuk menghapus tag sumber daya, kirim UntagResourceatau UntagResourcepermintaan.

Untuk membuat daftar tag untuk sumber daya, kirim ListTagsForResourceatau ListTagsForResourcepermintaan.

Pilih tab untuk melihat contoh kode dalam antarmuka atau bahasa.

AWS CLI

Tambahkan dua tag ke agen. Pisahkan pasangan kunci/nilai dengan spasi.

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

Hapus tag dari agen. Pisahkan kunci dengan spasi.

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

Daftar tag untuk agen.

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

Python (Boto)

Tambahkan dua tag ke agen.

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)

Hapus tag dari agen.

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

Daftar tag untuk agen.

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

Praktik dan pembatasan terbaik

Untuk praktik terbaik dan pembatasan penandaan, lihat Menandai sumber daya Anda AWS.