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](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).
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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) 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.
**Topics**
+ [Menandai sumber daya pada titik akhir `bedrock-runtime`](#tagging-runtime)
+ [Tandai sumber daya pada titik akhir `batuan dasar mantel`](#tagging-mantle)
## 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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) API | Sumber daya yang dibuat dengan [operasi API Amazon Bedrock Agents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) | Sumber daya yang dibuat dengan Amazon Bedrock Data Automation API |
| --- | --- | --- | --- |
| Menandai sumber daya | [See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/tagging.html) |
| Membatalkan tag sumber daya | Buat [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)permintaan dengan titik [akhir bidang kontrol Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Buat [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)permintaan dengan titik akhir [waktu pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | Buat UntagResource permintaan dengan Titik Akhir Waktu Pembuatan Otomasi Data Bedrock Amazon. |
| Membuat daftar tanda untuk sumber daya | Buat [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)permintaan dengan titik [akhir bidang kontrol Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Buat [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | 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-mantle`Titik akhir mendukung proyek penandaan, model yang disesuaikan, dan reservasi. Berbeda dengan bidang `bedrock-runtime` kontrol, `bedrock-mantle` tidak mengekspos operasi khusus`TagResource`,`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:RequestTag``aws: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 menggunakan`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"
}
}'
```
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"]
}'
```