View a markdown version of this page

設定バンドルを取得する - Amazon Bedrock AgentCore
バンドルメタデータとバージョンコンテンツコードサンプルリクエストパラメータ[応答]エラー

設定バンドルを取得する

設定バンドルを取得してメタデータを検査するか、特定のバージョンの完全な設定コンテンツを読み込みます。次の 2 つのオペレーションを使用できます。

  • GetConfigurationBundle — バンドルの最新バージョンを返します。branchName が指定されている場合、 はそのブランチの最新バージョンを返します。省略すると、すべてのブランチで最新バージョンが返されます。これを使用して、現在のアクティブな設定を読み取ります。

  • GetConfigurationBundleVersion — 特定の履歴バージョンをバージョン ID で返します。これを使用して、過去の設定を検査したり、バージョンを比較したりします。

バンドルメタデータとバージョンコンテンツ

GetConfigurationBundle は、バンドルレベルのメタデータ (名前、説明、ARN) とフルバージョンのコンテンツ (設定キーと値のペアを持つコンポーネント) の両方を返します。完全なコンテンツを取得せずに、どのバージョンが存在するかのみを知る必要がある場合は、ListConfigurationBundleVersions代わりに を使用してください。

GetConfigurationBundleVersion は、同じフィールドと を返します。これはversionCreatedAt、特定のバージョンが作成された日時 (バンドル自体createdAtが最初に作成された日時である とは対照的) を正確に知らせます。

コードサンプル

例
AgentCore CLI

バンドルのバージョン履歴を表示します。

agentcore config-bundle versions --name myAgentConfig

2 つのバージョンを並べて比較します。

agentcore config-bundle diff --name myAgentConfig \
  --from <version-1> \
  --to <version-2>
注記

直接「バンドルコンテンツを取得する」CLI コマンドはありません。config-bundleサブコマンドは versions、diff、および ですcreate-branch。バージョンを列挙して IDs を取得するには、 agentcore config-bundle versions --name myAgentConfig --json (オプションで --branch <name>、、または で--created-by <name>) を使用し--latest-per-branch、バージョン IDsにフィードしますconfig-bundle diff。バンドルバージョンの完全な設定コンテンツを取得するには、以下に示す SDK/REST GetConfigurationBundleVersionオペレーションを使用します。

AWS SDK (boto3)

バンドルメタデータと最新バージョンのコンテンツを取得します。

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

response = client.get_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5"
)

print(f"Bundle: {response['bundleName']}")
print(f"Version: {response['versionId']}")
print(f"Branch: {response.get('lineageMetadata', {}).get('branchName', 'N/A')}")
print(f"Components: {response['components']}")

特定の履歴バージョンを取得します。

response = client.get_configuration_bundle_version(
    bundleId="myAgentConfig-a1b2c3d4e5",
    versionId="12345678-1234-1234-1234-123456789012"
)

print(f"Version: {response['versionId']}")
print(f"Version created at: {response['versionCreatedAt']}")
print(f"Commit message: {response.get('lineageMetadata', {}).get('commitMessage', '')}")
print(f"Components: {response['components']}")

リクエストパラメータ

GetConfigurationBundle

パラメータ タイプ 必須 説明

bundleId

文字列

はい

設定バンドルの ID。パスパラメータとして渡されます。

branchName

String

いいえ

最新バージョンを取得するブランチ名。省略すると、すべてのブランチで最新バージョンが返されます。

GetConfigurationBundleVersion

パラメータ タイプ 必須 説明

bundleId

文字列

はい

設定バンドルの ID。パスパラメータとして渡されます。

versionId

String

はい

取得する特定のバージョンの UUID。パスパラメータとして渡されます。

[応答]

どちらのオペレーションも同じフィールドを返します。 GetConfigurationBundleVersionはさらに を返しますversionCreatedAt。

フィールド タイプ 説明

bundleArn

文字列

設定バンドルの ARN。

bundleId

String

設定バンドルの ID。

bundleName

String

バンドルの名前。

description

String

バンドルの説明 (設定されている場合）。

versionId

String

返されたバージョンの UUID。

components

マッピング

コンポーネント識別子のコンポーネント設定へのマップ。各値には、このバージョンに保存されているキーと値のペアを持つconfigurationオブジェクトが含まれます。

lineageMetadata

オブジェクト

parentVersionIds、、branchName、 createdByを含むバージョン系統メタデータcommitMessage。

createdAt

タイムスタンプ

バンドルが最初に作成された日時。

updatedAt

タイムスタンプ

バンドルが最後に更新された日時 (GetConfigurationBundle のみ）。

versionCreatedAt

タイムスタンプ

この特定のバージョンが作成されたとき (GetConfigurationBundleVersion のみ）。

エラー

エラー HTTP ステータス 説明

ValidationException

400

リクエストパラメータが無効です。

ResourceNotFoundException

404

指定された bundleIdまたは versionId は存在しません。

AccessDeniedException

403

アクセス許可が不十分です。IAM ポリシーに bedrock-agentcore:GetConfigurationBundleまたは が含まれていることを確認しますbedrock-agentcore:GetConfigurationBundleVersion。

ThrottlingException

429

リクエストレートを超えました。エクスポネンシャルバックオフを使用して再試行してください。

InternalServerException

500

サービス側のエラー。リクエストを再試行します。