View a markdown version of this page

Listar pacotes de configuração - Amazon Bedrock AgentCore
Exemplos de códigoParâmetros de solicitaçãoRespostaErros

Listar pacotes de configuração

Liste pacotes de configuração em sua conta ou liste versões de um pacote específico. Duas operações estão disponíveis:

  • ListConfigurationBundles— Retorna todos os pacotes da sua conta com informações resumidas.

  • ListConfigurationBundleVersions— Retorna todas as versões de um pacote específico, com filtragem opcional por ramificação ou fonte de criação.

Ambas as operações oferecem suporte à paginação.

Exemplos de código

exemplo
AgentCore CLI

Listar as versões de um pacote:

agentcore config-bundle versions --name myAgentConfig

Filtrar por filial:

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

Mostrar somente a versão mais recente por filial:

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

Filtrar por criador (por exemplo, versões criadas por um trabalho de recomendação):

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

Liste todos os pacotes com paginação:

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']}")

Liste as versões de um pacote específico:

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', '')}"
    )

Parâmetros de solicitação

ListConfigurationBundles

Parâmetro Tipo Obrigatório Description

maxResults

Inteiro

Não

Número máximo de resultados a serem retornados por página. Intervalo: 1—100.

nextToken

String

Não

Token de paginação de uma resposta anterior.

ListConfigurationBundleVersions

Parâmetro Tipo Obrigatório Descrição

bundleId

String

Sim

O ID do pacote de configuração. Passado como parâmetro de caminho.

filter

Objeto

Não

Filtro opcional. Consulte Filtro de versão abaixo.

maxResults

Inteiro

Não

Número máximo de resultados a serem retornados por página. Intervalo: 1—100.

nextToken

String

Não

Token de paginação de uma resposta anterior.

Filtro de versão

Campo Tipo Description

branchName

String

Retorne somente as versões desta ramificação.

createdByName

String

Retorne somente as versões criadas por esse nome de fonte (por exemplo, optimization-job ourecommendation).

latestPerBranch

Booleano

Quandotrue, retorna somente a versão mais recente de cada ramificação. Pode ser combinado branchName para obter as últimas novidades de uma filial específica.

Resposta

ListConfigurationBundles

Campo Tipo Description

bundles

Lista

Lista de resumos de pacotes. Cada um contém bundleArn bundleIdbundleName,, description e.

nextToken

String

Token de paginação para a próxima página. Ausente quando não há mais resultados.

ListConfigurationBundleVersions

Campo Tipo Description

versions

Lista

Lista de resumos de versões. Cada um contém bundleArn bundleIdversionId,lineageMetadata,, versionCreatedAt e.

nextToken

String

Token de paginação para a próxima página. Ausente quando não há mais resultados.

Erros

Erro Status HTTP Description

ValidationException

400

Parâmetros de solicitação inválidos.

ResourceNotFoundException

404

O especificado bundleId não existe (ListConfigurationBundleVersions somente).

AccessDeniedException

403

Permissões insuficientes.

ThrottlingException

429

Taxa de solicitações excedida. Novas tentativas com recuo exponencial.

InternalServerException

500

Service-side erro. Repetir a solicitação .