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.

# CLI für Vorlagen-Operationen
<a name="bda-blueprint-operations"></a>

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

## Erstellen von Vorlagen
<a name="create-blueprints-cli"></a>

Vorlagen 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 eine neue Vorlage zu erstellen.

Mit dem folgenden Befehl wird eine neue Vorlage erstellt, der dazu dient, 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
<a name="create-blueprint-parameters"></a>

Die folgende Tabelle enthält alle Parameter, die für den `create-blueprint`-Befehl verfügbar sind:


**Parameter für create-blueprint**  

| Parameter | Erforderlich | Standard | Description | 
| --- | --- | --- | --- | 
| --blueprint-name | Ja | – | Vorlagen-Name | 
| --type | Ja | – | Art des Inhalts (BILD, DOKUMENT, AUDIO, VIDEO) | 
| --blueprint-stage | Nein | LIVE | Vorlagen-Phase (ENTWICKLUNG oder LIVE) | 
| --schema | Ja | – | JSON-Schema, das die Vorlagen-Struktur definiert | 
| --client-token | Nein | Automatisch generiert | Eindeutiger Bezeichner für die Anforderungsidempotenz | 

## Anzeigen von Vorlagen-Konfigurationen
<a name="view-blueprint-cli"></a>

**Alle Vorlagen auflisten**

Verwenden Sie den Befehl list-blueprints, um eine Liste aller Vorlagen abzurufen, die mit Ihrem Konto verknüpft sind.

**Syntax**

```
aws bedrock-data-automation list-blueprints
```

**Vorlagen-Details anzeigen**

Verwenden Sie zum Anzeigen detaillierter Informationen über eine bestimmte Vorlage, einschließlich seines Schemas und seiner Konfiguration, den Befehl get-blueprint.

**Syntax**

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

**Spezifische Version untersuchen**

Wenn Sie mit versionierten Vorlagen 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"
```

**Spezifische Phase untersuchen**

Zum Anzeigen von Vorlagen entweder in der ENTWICKLUNGS- oder der LIVE-Phase verwenden Sie:

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

## Bearbeiten von Vorlagen-Spezifikationen
<a name="edit-blueprint-cli"></a>

**Vorlagen-Einstellungen aktualisieren**

Verwenden Sie den Befehl update-blueprint, um das Schema oder die Eigenschaften eines vorhandenen Vorlagen 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 eine Vorlage aktualisieren, müssen Sie das vollständige Schema angeben, auch für Felder, die Sie nicht ändern.

**Zu Live hochstufen**

Verwenden Sie den Befehl update-blueprint mit der Option --blueprint-stage, um eine Vorlage aus der Phase ENTWICKLUNG in die Phase LIVE hochzustufen.

**Syntax**

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

**Versionsverwaltung von Vorlagen**

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

**Syntax**

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

## Verwalten von Vorlagen-Tags
<a name="tag-management-cli"></a>

Mithilfe von Tags können Benutzer Vorlagen organisieren und kategorisieren und so die Verwaltung vereinfachen.

**Tags hinzufügen**

Wenden Sie Metadaten auf Ihre Vorlage an, indem Sie Tags hinzufügen.

**Syntax**

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

**Tags entfernen**

Entfernen Sie mit dem Befehl untag-resource bestimmte Tags aus Ihrer Vorlage.

**Syntax**

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

**Tags anzeigen**

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

**Syntax**

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

## Löschen von Vorlagen
<a name="delete-blueprint-cli"></a>

**Gesamte Vorlage löschen**

Verwenden Sie den Befehl delete-blueprint, um eine Vorlage und alle ihre Versionen dauerhaft zu entfernen.

**Syntax**

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

**Achtung:** Dieser Befehl löscht eine Vorlage dauerhaft und kann sie nicht wiederherstellen.

**Wichtig:** Sie können keine Vorlage verwenden, die aktuell von einem Projekt verwendet wird. Stellen Sie vor dem Löschen sicher, dass auf die Vorlage nicht in der benutzerdefinierten Ausgabekonfiguration eines Projekts verwiesen wird.

## Blueprint-Optimierung
<a name="blueprint-optimization-cli"></a>

### Blueprint-Optimierung aufrufen
<a name="invoking-blueprint-optimization"></a>

Starten Sie einen asynchronen Blueprint-Optimierungsjob, um die Blueprint-Anweisungen für jedes Ihrer Blueprint-Felder und die Ergebnisgenauigkeit zu verbessern.

**Syntax**

```
aws bedrock-data-automation invoke-blueprint-optimization-async \
    --blueprint blueprintArn="arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>",stage="DEVELOPMENT" \
    --samples '[
        {
            "assetS3Object": {
                "s3Uri": "s3://my-optimization-bucket/samples/document1.pdf"
            },
            "groundTruthS3Object": {
                "s3Uri": "s3://my-optimization-bucket/ground-truth/document1-expected.json"
            }
        }
    ]' \
    --output-configuration s3Object='{s3Uri="s3://my-optimization-bucket/results/optimization-output"}' \
    --data-automation-profile-arn "Amazon Resource Name (ARN):data-automation-profile/default"
```

### Überprüfen Sie den Status der Blueprint-Optimierung
<a name="checking-blueprint-optimization-status"></a>

Überwachen Sie den Fortschritt und die Ergebnisse eines Blueprint-Optimierungsjobs.

**Syntax**

```
aws bedrock-data-automation get-blueprint-optimization-status \
    --invocation-arn "arn:aws:bedrock:<region>:<account_id>:blueprint-optimization-invocation/opt-12345abcdef"
```

Verwenden Sie diesen Befehl, um den Status des Optimierungsauftrags zu verfolgen. Die Antwort enthält den aktuellen Status (Erstellt InProgress, Erfolgreich ServiceError, oder ClientError) und nach Abschluss Details zur Ausgabekonfiguration.

### Blueprint-Stufen werden kopiert
<a name="copying-blueprint-stages"></a>

Kopieren Sie einen Blueprint von einer Phase in eine andere

**Syntax**

```
aws bedrock-data-automation copy-blueprint-stage \
    --blueprint-arn "arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>" \
    --source-stage "DEVELOPMENT" \
    --target-stage "LIVE"
```

**Vorsicht:** Mit diesem Befehl wird die gesamte Blueprint-Konfiguration von der Quellphase in die Zielphase kopiert, wobei alle vorhandenen Konfigurationen in der Zielphase überschrieben werden.

**Wichtig:** Stellen Sie sicher, dass der Blueprint in der Quellphase gründlich getestet wird, bevor Sie ihn in die Produktionsphase (LIVE) kopieren. Dieser Vorgang kann nur schwer rückgängig gemacht werden.