View a markdown version of this page

Menandai sumber daya Amazon Bedrock - Amazon Bedrock
Menandai sumber daya pada titik akhir bedrock-runtimeTandai sumber daya pada titik akhir batuan dasar mantel

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menandai sumber daya Amazon Bedrock

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 tag terdiri dari kunci dan nilai.

Tag memungkinkan Anda untuk mengkategorikan AWS sumber daya Anda dengan cara yang berbeda, misalnya, berdasarkan tujuan, pemilik, atau aplikasi. Untuk praktik terbaik dan pembatasan penandaan, lihat Menandai sumber daya Anda AWS.

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 Manajemen Penagihan dan Biaya 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 Manajemen Penagihan dan Biaya 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.

Menandai sumber daya pada titik akhir bedrock-runtime

Sumber daya yang dibuat melalui bidang bedrock-runtime kontrol (seperti agen, basis pengetahuan, model kustom, throughput yang disediakan, dan alur) diberi tag menggunakan operasi API penandaan khusus.

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.

Tabel berikut merangkum kasus penggunaan yang berbeda dan operasi penandaan yang akan digunakan untuk mereka:

Kasus penggunaan Sumber daya yang dibuat dengan operasi Amazon Bedrock API Sumber daya yang dibuat dengan operasi API Amazon Bedrock Agents Sumber daya yang dibuat dengan Amazon Bedrock Data Automation API
Menandai sumber daya

  • Jika sumber daya belum dibuat, gunakan tags bidang saat membuat sumber daya.

  • Jika sumber daya sudah dibuat, buat TagResource permintaan dengan Titik Akhir Waktu Pembuatan Otomasi Data Bedrock Amazon.
Membatalkan tag sumber daya Buat UntagResourcepermintaan dengan titik akhir bidang kontrol Amazon Bedrock. Buat UntagResourcepermintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. Buat UntagResource permintaan dengan Titik Akhir Waktu Pembuatan Otomasi Data Bedrock Amazon.
Membuat daftar tanda untuk sumber daya Buat ListTagsForResourcepermintaan dengan titik akhir bidang kontrol Amazon Bedrock. Buat ListTagsForResourcepermintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. Buat ListTagsForResource permintaan dengan Titik Akhir Waktu Pembuatan Otomasi Data Bedrock Amazon.
catatan

Saat melihat operasi ini CloudTrail, Anda dapat mengidentifikasi sumber daya tertentu yang diberi tag dengan memeriksa parameter permintaan di detail acara.

Pilih tab untuk melihat contoh kode dalam antarmuka atau bahasa.

AWS CLI

Tambahkan dua tag ke agen. Pisahkan key/value pasangan 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')

Tandai sumber daya pada titik akhir batuan dasar mantel

bedrock-mantleTitik akhir mendukung proyek penandaan, model yang disesuaikan, dan reservasi. Berbeda dengan bidang bedrock-runtime kontrol, bedrock-mantle tidak mengekspos operasi khususTagResource,UntagResource, atau ListTagsForResource API. Sebagai gantinya, Anda mengatur dan membaca tag sebaris melalui API sumber daya.

Mengatur tag

Tindakan Panggilan API Bidang tag
Buat proyek dengan tag POST /v1/organization/projects tags
Menambahkan atau menghapus tag pada proyek yang ada POST /v1/organization/projects/{project_id} add_tags, remove_tag_keys, tags
Buat model yang disesuaikan dengan tag Customized-model buat titik akhir tags
Perbarui tag pada model yang disesuaikan Customized-model perbarui titik akhir add_tags, remove_tag_keys
Buat reservasi dengan tag Reservasi membuat titik akhir tags
Perbarui tag pada reservasi Titik akhir pembaruan reservasi add_tags, remove_tag_keys

Tag dikembalikan sebaris pada tanggapan Dapatkan dan Daftar untuk sumber daya ini.

Tindakan IAM

Meskipun tidak ada titik akhir penandaan khusus, tindakan IAM berikut dievaluasi saat Anda menyetel, mengubah, atau membaca tag pada sumber daya. bedrock-mantle Anda dapat menulis kebijakan IAM menggunakan nama tindakan ini dan tombol aws:RequestTagaws:TagKeys, dan aws:ResourceTag kondisi untuk mengontrol akses berbasis tag.

  • bedrock-mantle:TagResource

  • bedrock-mantle:UntagResource

  • bedrock-mantle:ListTagsForResource

Contoh

Contoh berikut membuat proyek dengan dua tag menggunakancurl:

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"
      }
    }'

Contoh berikut menambahkan satu tag dan menghapus yang lain dari proyek yang ada:

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"]
    }'