Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Markieren von Amazon-Bedrock-Ressourcen
Zur Unterstützung der Verwaltung Ihrer Amazon-Bedrock-Ressourcen können Sie jeder Ressource Metadaten in Form von Tags zuweisen. Ein Tag ist eine Bezeichnung, die Sie einer AWS Ressource zuweisen. Jedes Tag besteht aus einem Schlüssel und einem Wert.
Mithilfe von Tags können Sie Ihre AWS Ressourcen auf unterschiedliche Weise kategorisieren, z. B. nach Zweck, Eigentümer oder Anwendung. Bewährte Methoden und Einschränkungen beim Taggen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html). AWS
Tags sind für folgende Aktivitäten nützlich:
+ Identifizieren und organisieren Sie Ihre AWS Ressourcen. Viele AWS Ressourcen unterstützen Tagging, sodass Sie Ressourcen in verschiedenen Diensten dasselbe Tag zuweisen können, um anzuzeigen, dass es sich um dieselben Ressourcen handelt.
+ Zuordnen von Kosten. Sie aktivieren Tags auf dem AWS Fakturierung und Kostenmanagement Dashboard. AWS verwendet die Tags, um Ihre Kosten zu kategorisieren und Ihnen einen monatlichen Kostenverteilungsbericht zu liefern. Weitere Informationen finden Sie unter [Use cost allocation tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) (Verwendung von Kostenzuordnungs-Tags) im *AWS Fakturierung und Kostenmanagement -Benutzerhandbuch*.
+ Kontrollieren Sie den Zugriff auf Ihre -Ressourcen. Sie können Tags mit Amazon Bedrock verwenden, um Richtlinien zur Steuerung des Zugriffs auf Amazon-Bedrock-Ressourcen zu erstellen. Diese Richtlinien können IAM-Rollen oder -Benutzern angefügt werden, um die Tag-basierte Zugriffskontrolle zu aktivieren.
**Topics**
+ [Taggen Sie Ressourcen auf dem `Bedrock-Runtime-Endpunkt`](#tagging-runtime)
+ [Markieren Sie Ressourcen auf dem Endpunkt `Bedrock-Mantle`](#tagging-mantle)
## Taggen Sie Ressourcen auf dem `Bedrock-Runtime-Endpunkt`
Ressourcen, die über die `bedrock-runtime` Kontrollebene erstellt wurden (wie Agenten, Wissensdatenbanken, benutzerdefinierte Modelle, bereitgestellter Durchsatz und Datenflüsse), werden mithilfe spezieller Tagging-API-Operationen markiert.
### Verwenden der Konsole
Sie können jederzeit Tags hinzufügen, ändern und entfernen, während Sie eine unterstützte Ressource erstellen oder bearbeiten.
### Verwenden der API
Zum Durchführen von Tagging-Operationen benötigen Sie den Amazon-Ressourcennamen (ARN) der Ressource, in der Sie eine Tagging-Operation ausführen möchten. Abhängig von der Ressource, für die Sie Tags hinzufügen oder verwalten, gibt es zwei Gruppen von Tagging-Operationen.
In der folgenden Tabelle sind die verschiedenen Anwendungsfälle und die dafür zu verwendenden Markierungsvorgänge zusammengefasst:
****
| Anwendungsfall | Ressource, die mit dem API-Vorgang für [Amazon-Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) erstellt wurde | Ressource, die mit dem API-Vorgang für [Agenten für Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) erstellt wurde | Ressource, die mit der API von Amazon Bedrock Data Automation erstellt wurde |
| --- | --- | --- | --- |
| Eine Ressource markieren | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/tagging.html) |
| Tag einer Ressource entfernen | Stellen Sie eine [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)Anfrage mit einem [Endpunkt der Amazon Bedrock-Steuerebene](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Stellen Sie eine [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)Anfrage bei einem [Build-Time-Endpunkt von Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). | Stellen Sie eine UntagResource Anfrage mit einem Amazon Bedrock Data Automation Build Time Endpoint. |
| Tags für eine Ressource auflisten | Stellen Sie eine [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)Anfrage mit einem [Endpunkt der Amazon Bedrock-Steuerebene](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Stellen Sie eine [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)Anfrage bei einem [Build-Time-Endpunkt von Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). | Stellen Sie eine ListTagsForResource Anfrage mit einem Amazon Bedrock Data Automation Build Time Endpoint. |
**Anmerkung**
Wenn Sie sich diese Operationen ansehen CloudTrail, können Sie anhand der Anforderungsparameter in den Ereignisdetails die spezifische Ressource identifizieren, die markiert wird.
Wählen Sie eine Registerkarte aus, um Codebeispiele in einer Oberfläche oder Sprache anzuzeigen.
------
#### [ AWS CLI ]
Fügen Sie einem Agenten zwei Tags hinzu. Trennen Sie key/value Paare durch ein Leerzeichen.
```
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
```
Entfernen Sie die Tags aus dem Agenten. Trennen Sie Schlüssel durch ein Leerzeichen.
```
aws bedrock-agent untag-resource \
--resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
--tag-keys key=department facing
```
Führen Sie die Tags für den Agenten auf
```
aws bedrock-agent list-tags-for-resource \
--resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"
```
------
#### [ Python (Boto) ]
Fügen Sie einem Agenten zwei Tags hinzu.
```
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)
```
Entfernen Sie die Tags aus dem Agenten.
```
bedrock.untag_resource(
resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345',
tagKeys=['department', 'facing']
)
```
Führen Sie die Tags für den Agenten auf.
```
bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')
```
------
## Markieren Sie Ressourcen auf dem Endpunkt `Bedrock-Mantle`
Der `bedrock-mantle` Endpunkt unterstützt das Taggen von Projekten, benutzerdefinierten Modellen und Reservierungen. Im Gegensatz `bedrock-runtime` zur Steuerungsebene werden `bedrock-mantle` keine dedizierten `TagResource` Operationen oder `ListTagsForResource` API-Operationen angezeigt. `UntagResource` Stattdessen setzen und lesen Sie Tags inline über die Ressourcen-APIs.
### Tags setzen
****
| Action | API-Aufruf. | Tag-Felder |
| --- | --- | --- |
| Erstellen Sie ein Projekt mit Tags | POST /v1/organization/projects | tags |
| Fügen Sie einem vorhandenen Projekt Tags hinzu oder entfernen Sie sie | POST /v1/organization/projects/{project\_id} | add\_tags, remove\_tag\_keys, tags |
| Erstellen Sie ein benutzerdefiniertes Modell mit Tags | Customized-model Endpunkt erstellen | tags |
| Aktualisieren Sie die Tags auf einem benutzerdefinierten Modell | Customized-model Endpunkt aktualisieren | add\_tags, remove\_tag\_keys |
| Erstellen Sie eine Reservierung mit Tags | Reservierung Endpunkt erstellen | tags |
| Aktualisieren Sie die Tags einer Reservierung | Endpunkt für die Aktualisierung der Reservierung | add\_tags, remove\_tag\_keys |
Stichwörter werden bei den Antworten „Abrufen“ und „Auflisten“ für diese Ressourcen als Inline zurückgegeben.
### IAM-Aktionen
Obwohl es keine speziellen Tagging-Endpunkte gibt, werden die folgenden IAM-Aktionen ausgewertet, wenn Sie Tags für Ressourcen setzen, ändern oder lesen. `bedrock-mantle` Mithilfe dieser Aktionsnamen und der `aws:ResourceTag` Bedingungstasten, und können Sie IAM-Richtlinien schreiben `aws:RequestTag``aws:TagKeys`, um den tagbasierten Zugriff zu steuern.
+ `bedrock-mantle:TagResource`
+ `bedrock-mantle:UntagResource`
+ `bedrock-mantle:ListTagsForResource`
### Beispiel
Im folgenden Beispiel wird ein Projekt mit zwei Tags erstellt, wobei Folgendes verwendet wird: `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"
}
}'
```
Im folgenden Beispiel wird ein Tag hinzugefügt und ein anderes aus einem vorhandenen Projekt entfernt:
```
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"]
}'
```