View a markdown version of this page

Listar paquetes de configuración - Amazon Bedrock AgentCore
Ejemplos de códigoParámetros de solicitudRespuestaErrores

Listar paquetes de configuración

Enumere los paquetes de configuración de su cuenta o enumere las versiones de un paquete específico. Hay dos operaciones disponibles:

  • ListConfigurationBundles— Devuelve todos los paquetes de tu cuenta con información resumida.

  • ListConfigurationBundleVersions— Devuelve todas las versiones de un paquete específico, con el filtrado opcional por sucursal o fuente de creación.

Ambas operaciones admiten la paginación.

Ejemplos de código

ejemplo
AgentCore CLI

Enumere las versiones de un paquete:

agentcore config-bundle versions --name myAgentConfig

Filtrar por rama:

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

Mostrar solo la última versión por sucursal:

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

Filtrar por creador (por ejemplo, las versiones creadas por un trabajo de recomendación):

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

Haz una lista de todos los paquetes con paginación:

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

Enumere las versiones de un paquete 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 solicitud

ListConfigurationBundles

Parámetro Tipo Obligatorio Description (Descripción)

maxResults

Entero

No

Número máximo de resultados que se pueden devolver por página. Rango: de 1 a 100.

nextToken

Cadena

No

Símbolo de paginación de una respuesta anterior.

ListConfigurationBundleVersions

Parámetro Tipo Obligatorio Descripción

bundleId

Cadena

Sí

El ID del paquete de configuración. Se pasa como parámetro de ruta.

filter

Objeto

No

Filtro opcional. Consulte Filtro de versiones a continuación.

maxResults

Entero

No

Número máximo de resultados que se devolverán por página. Rango: de 1 a 100.

nextToken

Cadena

No

Símbolo de paginación de una respuesta anterior.

Filtro de versiones

Campo Tipo Description (Descripción)

branchName

Cadena

Devuelve solo las versiones de esta rama.

createdByName

Cadena

Devuelve solo las versiones creadas con este nombre de fuente (por ejemplo, optimization-job orecommendation).

latestPerBranch

Booleano

Cuandotrue, devuelve solo la versión más reciente de cada rama. Se puede combinar con ella branchName para obtener la versión más reciente de una sucursal específica.

Respuesta

ListConfigurationBundles

Campo Tipo Description (Descripción)

bundles

Enumeración

Lista de resúmenes de paquetes. Cada uno contienebundleArn, bundleIdbundleName, y. description

nextToken

Cadena

Símbolo de paginación para la página siguiente. Ausente cuando no hay más resultados.

ListConfigurationBundleVersions

Campo Tipo Description (Descripción)

versions

Enumeración

Lista de resúmenes de versiones. Cada uno contienebundleArn,bundleId, versionIdlineageMetadata, yversionCreatedAt.

nextToken

Cadena

Símbolo de paginación para la página siguiente. Ausente cuando no hay más resultados.

Errores

Error Estado HTTP Description (Descripción)

ValidationException

400

Parámetros de solicitud no válidos.

ResourceNotFoundException

404

Lo especificado bundleId no existe (ListConfigurationBundleVersions solo).

AccessDeniedException

403

Permisos insuficientes.

ThrottlingException

429

Se superó la tasa de solicitudes. Vuelva a intentarlo con retroceso exponencial.

InternalServerException

500

Service-side error. Intente realizar de nuevo la solicitud .