View a markdown version of this page

구성 번들 나열 - Amazon Bedrock AgentCore
코드 샘플요청 파라미터응답오류

구성 번들 나열

계정의 구성 번들을 나열하거나 특정 번들의 버전을 나열합니다. 두 가지 작업을 사용할 수 있습니다.

  • 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

Integer

아니요

페이지당 반환할 최대 결과 수입니다. 범위: 1~100.

nextToken

문자열

No

이전 응답의 페이지 매김 토큰입니다.

ListConfigurationBundleVersions

파라미터 유형 필수 설명

bundleId

문자열

예

구성 번들의 ID입니다. 경로 파라미터로 전달됩니다.

filter

객체

아니요

선택적 필터. 자세한 내용은 아래 버전 필터 섹션을 참조하세요.

maxResults

Integer

아니요

페이지당 반환할 최대 결과 수입니다. 범위: 1~100.

nextToken

문자열

No

이전 응답의 페이지 매김 토큰입니다.

버전 필터

Field 유형 설명

branchName

문자열

이 브랜치의 버전만 반환합니다.

createdByName

문자열

이 소스 이름으로 생성된 버전만 반환합니다(예: optimization-job 또는 recommendation).

latestPerBranch

부울

true인 경우는 각 브랜치에 대해 최신 버전만 반환합니다. 와 결합하여 특정 브랜치에 대한 최신를 branchName 가져올 수 있습니다.

응답

ListConfigurationBundles

Field 유형 설명

bundles

목록

번들 요약 목록입니다. 각 에는 bundleArn, bundleName, bundleId및가 포함되어 있습니다description.

nextToken

문자열

다음 페이지의 페이지 매김 토큰입니다. 더 이상 결과가 없으면 없습니다.

ListConfigurationBundleVersions

Field 유형 설명

versions

목록

버전 요약 목록입니다. 각 에는 bundleArn, bundleId, lineageMetadata, versionId및가 포함되어 있습니다versionCreatedAt.

nextToken

문자열

다음 페이지의 페이지 매김 토큰입니다. 더 이상 결과가 없으면 없습니다.

오류

오류 HTTP 상태 설명

ValidationException

400

잘못된 요청 파라미터입니다.

ResourceNotFoundException

404

지정된 bundleId이 존재하지 않습니다(ListConfigurationBundleVersions만 해당).

AccessDeniedException

403

권한이 부족합니다.

ThrottlingException

429

요청 속도가 초과되었습니다. 지수 백오프를 사용하여 재시도하세요.

InternalServerException

500

서비스 측 오류입니다. 요청을 다시 시도하세요.