Markieren von 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.

Mit Tags können Sie Ihre AWS Ressourcen auf unterschiedliche Weise kategorisieren, z. B. nach Zweck, Eigentümer oder Anwendung. Tags sind für folgende Aktivitäten nützlich:

• Identifizieren und organisieren Sie Ihre - AWS Ressourcen. Viele AWS Ressourcen unterstützen das Markieren, sodass Sie Ressourcen in verschiedenen Services dasselbe Tag zuweisen können, um anzuzeigen, dass die Ressourcen identisch sind.

• Zuordnen von Kosten. Sie aktivieren Tags auf dem AWS Billing and Cost Management Dashboard. AWS verwendet die Tags, um Ihre Kosten zu kategorisieren und Ihnen einen monatlichen Kostenzuordnungsbericht bereitzustellen. Weitere Informationen finden Sie unter Use cost allocation tags (Verwendung von Kostenzuordnungs-Tags) im AWS Billing and Cost Management -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.

Folgende Amazon-Bedrock-Ressourcen können mit einem Tag markiert werden:

• Benutzerdefinierte Modelle

• Modellanpassungsaufträge

• Bereitgestellte Modelle

• Batch-Inferenzaufträge (nur API)

• Kundendienstmitarbeiters (Kundendienstmitarbeiter)

• Agent-Aliase

• Wissensdatenbanken

• Modellevaluierungen (nur Konsole)

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.

1. Die folgenden Ressourcen verwenden die Amazon-Bedrock-ListTagsForResourceOperationen UntagResource, und TagResource.

   • Benutzerdefinierte Modelle

   • Modellanpassungsaufträge

   • Bereitgestellte Modelle

   • Batch-Inferenzaufträge

2. Die folgenden Ressourcen verwenden die ListTagsForResource Operationen -Agenten für Amazon Bedrock UntagResource, und TagResource.

   • Kundendienstmitarbeiters (Kundendienstmitarbeiter)

   • Agent-Aliase

   • Wissensdatenbanken

Um einer Ressource Tags hinzuzufügen, senden Sie eine Amazon-Bedrock- TagResource oder -Agents-for-Amazon-Bedrock-TagResourceAnforderung.

Senden Sie eine - UntagResource oder -UntagResourceAnforderung, um die Markierung einer Ressource aufzuheben.

Um die Tags für eine Ressource aufzulisten, senden Sie eine - ListTagsForResource oder -ListTagsForResourceAnforderung.

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 Schlüssel-Wert-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')

Bewährte Methoden und Einschränkungen

Bewährte Methoden und Einschränkungen für das Markieren finden Sie unter Markieren Ihrer - AWS Ressourcen.