CLI für Blueprint-Operationen

Dieses Handbuch behandelt Blueprint-Operationen, die über die AWS-Befehlszeilenschnittstelle (CLI) for Amazon Bedrock Data Automation (BDA) verfügbar sind.

Blueprints erstellen

Blueprints definieren die Struktur und Eigenschaften von Daten, die Sie aus Ihren Dokumenten, Bildern, Audio- oder Videodateien extrahieren möchten. Verwenden Sie den Befehl create-blueprint, um einen neuen Blueprint zu definieren.

Mit dem folgenden Befehl wird ein neuer Blueprint erstellt, der darauf zugeschnitten ist, Daten aus einem Passbild zu extrahieren.

Syntax

aws bedrock-data-automation create-blueprint \
      --blueprint-name "passport-blueprint" \
      --type "IMAGE" \
      --blueprint-stage "DEVELOPMENT" \
      --schema '{
        "class": "Passport",
        "description": "Blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

Vollständige Parameterreferenz

Die folgende Tabelle zeigt alle verfügbaren Parameter für den create-blueprint Befehl:

Parameter für create-blueprint

Parameter	Erforderlich	Standard	Beschreibung
--blueprint-name	Ja	N/A	Name für den Blueprint
--type	Ja	N/A	Art des Inhalts (BILD, DOKUMENT, AUDIO, VIDEO)
--blueprint-stage	Nein	LIVE	Bühne für den Blueprint (ENTWICKLUNG oder LIVE)
--schema	Ja	N/A	JSON-Schema, das die Blueprint-Struktur definiert
--client-token	Nein	Automatisch generiert	Eindeutiger Bezeichner für die Idempotenz der Anfrage

Blueprint-Konfigurationen anzeigen

Alle Blueprints auflisten

Verwenden Sie den Befehl list-blueprints, um eine Liste aller Blueprints abzurufen, die Ihrem Konto zugeordnet sind.

Syntax

aws bedrock-data-automation list-blueprints

Blueprint-Details anzeigen

Um detaillierte Informationen zu einem bestimmten Blueprint, einschließlich seines Schemas und seiner Konfiguration, anzuzeigen, verwenden Sie den Befehl get-blueprint.

Syntax

aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)"

Untersuchen Sie eine bestimmte Version

Wenn Sie mit versionierten Blueprints arbeiten, verwenden Sie den Befehl get-blueprint mit der Option --blueprint-version, um eine bestimmte Version anzuzeigen.

Syntax

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-version "version-number"

Untersuchen Sie eine bestimmte Phase

Um Blueprints entweder in der ENTWICKLUNGS- oder LIVE-Phase anzusehen, verwenden Sie:

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

Blueprint-Spezifikationen bearbeiten

Blueprint-Einstellungen aktualisieren

Verwenden Sie den Befehl update-blueprint, um das Schema oder die Eigenschaften eines vorhandenen Blueprints zu ändern.

Syntax

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --schema '{
        "class": "Passport",
        "description": "Updated blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

Hinweis: Wenn Sie einen Blueprint aktualisieren, müssen Sie das vollständige Schema angeben, auch für Felder, die Sie nicht ändern.

Werben Sie zu LIVE

Verwenden Sie den Befehl update-blueprint mit der Option --blueprint-stage, um einen Blueprint für die Produktion aus der Entwicklungsphase in die LIVE-Phase zu verschieben.

Syntax

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

Versionierung von Blueprints

Erstellen Sie eine neue Version Ihres Blueprints, um den aktuellen Status beizubehalten, bevor Sie mit dem Befehl wesentliche Änderungen vornehmen. create-blueprint-version

Syntax

aws bedrock-data-automation create-blueprint-version \
      --blueprint-arn "Amazon Resource Name (ARN)"
      

Blueprint-Tags verwalten

Mithilfe von Tags können Benutzer Blueprints organisieren und kategorisieren, um die Verwaltung zu vereinfachen.

Fügen Sie Stichwörter hinzu

Wenden Sie Metadaten auf Ihren Blueprint an, indem Sie Tags hinzufügen.

Syntax

aws bedrock-data-automation tag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tags '{"Department":"Finance","Project":"PassportProcessing"}'

Entfernen Sie Stichwörter

Entfernen Sie mit dem Befehl untag-resource bestimmte Tags aus Ihrem Blueprint.

Syntax

aws bedrock-data-automation untag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tag-keys '["Department","Project"]'

Tags anzeigen

Führen Sie mithilfe des list-tags-for-resource Befehls alle mit Ihrem Blueprint verknüpften Tags auf.

Syntax

aws bedrock-data-automation list-tags-for-resource \
      --resource-arn "Amazon Resource Name (ARN)"

Blueprints löschen

Löschen Sie einen gesamten Blueprint

Verwenden Sie den Befehl delete-blueprint, um einen Blueprint und alle seine Versionen dauerhaft zu entfernen.

Syntax

aws bedrock-data-automation delete-blueprint \
          --blueprint-arn "Amazon Resource Name (ARN)"
              

Vorsicht: Dieser Befehl löscht einen Blueprint dauerhaft und kann ihn nicht wiederherstellen.

Wichtig: Sie können einen Blueprint, der derzeit von Projekten verwendet wird, nicht löschen. Stellen Sie vor dem Löschen sicher, dass der Blueprint in der benutzerdefinierten Ausgabekonfiguration eines Projekts nicht referenziert wird.