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. AWS

Tags sind für folgende Aktivitäten nützlich:

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:

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

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:RequestTagaws:TagKeys, um den tagbasierten Zugriff zu steuern.

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