View a markdown version of this page

設定バンドルを一覧表示する - Amazon Bedrock AgentCore
コードサンプルリクエストパラメータ[応答]エラー

設定バンドルを一覧表示する

アカウントの設定バンドルを一覧表示するか、特定のバンドルのバージョンを一覧表示します。次の 2 つのオペレーションを使用できます。

  • ListConfigurationBundles — 概要情報を含むアカウント内のすべてのバンドルを返します。

  • ListConfigurationBundleVersions — ブランチまたは作成ソースによるオプションのフィルタリングを使用して、特定のバンドルのすべてのバージョンを返します。

どちらのオペレーションもページ分割をサポートしています。

コードサンプル

例
AgentCore CLI

バンドルのバージョンを一覧表示します。

agentcore config-bundle versions --name myAgentConfig

ブランチでフィルタリングする:

agentcore config-bundle versions --name myAgentConfig --branch mainline

ブランチごとに最新バージョンのみを表示します。

agentcore config-bundle versions --name myAgentConfig --latest-per-branch

作成者によるフィルタリング (レコメンデーションジョブによって作成されたバージョンなど)

agentcore config-bundle versions --name myAgentConfig --created-by recommendation
AWS SDK (boto3)

ページ分割されたすべてのバンドルを一覧表示します。

import boto3

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

paginator = client.get_paginator("list_configuration_bundles")
for page in paginator.paginate(maxResults=20):
    for bundle in page["bundles"]:
        print(f"{bundle['bundleId']} - {bundle['bundleName']}")

特定のバンドルのバージョンを一覧表示します。

response = client.list_configuration_bundle_versions(
    bundleId="myAgentConfig-a1b2c3d4e5",
    filter={"branchName": "mainline"},
    maxResults=20,
)

for version in response["versions"]:
    lineage = version.get("lineageMetadata", {})
    print(
        f"{version['versionId']}  "
        f"{version['versionCreatedAt']}  "
        f"{lineage.get('commitMessage', '')}"
    )

リクエストパラメータ

ListConfigurationBundles

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

maxResults

整数

いいえ

1 ページあたりに返される結果の最大数。範囲: 1～100。

nextToken

String

いいえ

前のレスポンスからのページ分割トークン。

ListConfigurationBundleVersions

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

bundleId

文字列

はい

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

filter

オブジェクト

いいえ

オプションのフィルター。以下の「バージョンフィルター」を参照してください。

maxResults

整数

いいえ

1 ページあたりに返される結果の最大数。範囲: 1～100。

nextToken

String

いいえ

前のレスポンスからのページ分割トークン。

バージョンフィルター

フィールド タイプ 説明

branchName

文字列

このブランチのバージョンのみを返します。

createdByName

String

このソース名で作成されたバージョンのみを返します (例: optimization-jobまたは recommendation)。

latestPerBranch

ブール値

の場合true、 は各ブランチの最新バージョンのみを返します。と組み合わせてbranchName、特定のブランチの最新の を取得できます。

[応答]

ListConfigurationBundles

フィールド タイプ 説明

bundles

[List] (リスト)

バンドルの概要のリスト。各 には、bundleArn、bundleId、bundleName、および が含まれますdescription。

nextToken

String

次のページのページ分割トークン。結果がない場合には存在しません。

ListConfigurationBundleVersions

フィールド タイプ 説明

versions

[List] (リスト)

バージョン概要のリスト。各 には、bundleArn、bundleId、versionId、lineageMetadata、および が含まれますversionCreatedAt。

nextToken

String

次のページのページ分割トークン。結果がない場合には存在しません。

エラー

エラー HTTP ステータス 説明

ValidationException

400

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

ResourceNotFoundException

404

指定された bundleIdは存在しません (ListConfigurationBundleVersions のみ）。

AccessDeniedException

403

アクセス許可が不十分です。

ThrottlingException

429

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

InternalServerException

500

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