翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ブループリント操作の CLI
<a name="bda-blueprint-operations"></a>

このガイドでは、AWS Command Line Interface (CLI) for Amazon BedrockData Automation (BDA) を通じて利用できる設計図オペレーションについて説明します。

## ブループリントの作成
<a name="create-blueprints-cli"></a>

ブループリントは、ドキュメント、画像、音声、または動画のファイルから抽出するデータの構造とプロパティを定義します。新しいブループリントを定義するには、create-blueprint コマンドを使用します。

以下のコマンドは、パスポート画像からデータを抽出するための新しいブループリントを作成します。

**[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"
          }
        }
      }'
```

## 完全なパラメータのリファレンス
<a name="create-blueprint-parameters"></a>

次の表は、`create-blueprint` コマンドで利用可能なパラメータの一覧です。


**create-blueprint のパラメータ**  

| [Parameter] (パラメータ) | 必須 | デフォルト | [Description] (説明) | 
| --- | --- | --- | --- | 
| --blueprint-name | はい | 該当なし | ブループリントの名前 | 
| --type | はい | 該当なし | コンテンツタイプ (画像、ドキュメント、音声、動画) | 
| --blueprint-stage | 不可 | LIVE | ブループリントのステージ (開発環境または本番環境) | 
| --schema | はい | 該当なし | ブループリントの構造を定義する JSON スキーマ | 
| --client-token | 不可 | 自動生成 | リクエストのべき等性を確保するための一意の識別子 | 

## ブループリント設定の表示
<a name="view-blueprint-cli"></a>

**すべてのブループリントを一覧表示する**

アカウントに関連付けられているすべてのブループリントのリストを取得するには、list-blueprints コマンドを使用します。

**[Syntax]** (構文)

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

**ブループリントの詳細を表示する**

スキーマや構成など、特定のブループリントに関する詳細情報を表示するには、get-blueprint コマンドを使用します。

**[Syntax]** (構文)

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

**特定のバージョンを検査する**

バージョン管理されたブループリントを使用する場合に、特定のバージョンを表示するには、get-blueprint コマンドで --blueprint-version オプションを使用します。

**[Syntax]** (構文)

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

**特定のステージを検査する**

開発ステージまたは本番環境ステージでブループリントを表示するには、以下を使用します。

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

## ブループリントの仕様の編集
<a name="edit-blueprint-cli"></a>

**ブループリント設定を更新する**

既存のブループリントのスキーマまたはプロパティを変更するには、update-blueprint コマンドを使用します。

**[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"
          }
        }
      }'
```

**注:** ブループリントを更新する際は、変更しないフィールドであっても、完全なスキーマを指定する必要があります。

**本番環境に昇格する**

ブループリントを本番稼働のために開発ステージから本番環境ステージに移動させるには、update-blueprint コマンドで、--blueprint-stage オプションを使用します。

**[Syntax]** (構文)

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

**ブループリントのバージョニング**

大幅な変更を加える前に、create-blueprint-version コマンドを使用してブループリントの新しいバージョンを作成し、現在の状態を保存します。

**[Syntax]** (構文)

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

## ブループリントタグの管理
<a name="tag-management-cli"></a>

タグを使用すると、ブループリントを整理および分類して、管理を簡素化するのに役立ちます。

**タグを追加する**

タグを追加して、メタデータをブループリントに適用します。

**[Syntax]** (構文)

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

**タグを削除する**

untag-resource コマンドを使用して、ブループリントから特定のタグを削除します。

**[Syntax]** (構文)

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

**タグを表示する**

ブループリントに関連付けられているすべてのタグを一覧表示するには、list-tags-for-resource コマンドを使用します。

**[Syntax]** (構文)

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

## ブループリントの削除
<a name="delete-blueprint-cli"></a>

**ブループリント全体を削除する**

ブループリントとブループリントのすべてのバージョンを完全に削除するには、delete-blueprint コマンドを使用します。

**[Syntax]** (構文)

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

**注:** このコマンドはブループリントを完全に削除するため、復元することはできません。

**重要:** 現在いずれかのプロジェクトで使用されているブループリントは、削除することはできません。削除する前に、プロジェクトのカスタム出力設定でブループリントが参照されていないことを確認する必要があります。

## 設計図の最適化
<a name="blueprint-optimization-cli"></a>

### 設計図の最適化の呼び出し
<a name="invoking-blueprint-optimization"></a>

非同期ブループリント最適化ジョブを開始して、各ブループリントフィールドのブループリントの指示と結果の精度を向上させます。

**[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"
```

### 設計図の最適化ステータスの確認
<a name="checking-blueprint-optimization-status"></a>

ブループリント最適化ジョブの進行状況と結果をモニタリングします。

**[Syntax]** (構文)

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

このコマンドを使用して、最適化ジョブのステータスを追跡します。レスポンスには、現在のステータス (作成済み、InProgress、成功、ServiceError、または ClientError) と、完了時の出力設定の詳細が含まれます。

### 設計図ステージのコピー
<a name="copying-blueprint-stages"></a>

あるステージから別のステージにブループリントをコピーする

**[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"
```

**注意:** このコマンドは、ブループリント設定全体をソースステージからターゲットステージにコピーし、ターゲットステージの既存の設定を上書きします。

**重要:** 本番環境 (LIVE) ステージにコピーする前に、ブループリントがソースステージで徹底的にテストされていることを確認します。この操作は簡単に元に戻すことができません。