View a markdown version of this page

Elenca i pacchetti di configurazione - Amazon Bedrock AgentCore
Esempi di codiceParametri della richiestaRispostaErrori

Elenca i pacchetti di configurazione

Elenca i pacchetti di configurazione presenti nel tuo account o elenca le versioni di un pacchetto specifico. Sono disponibili due operazioni:

  • ListConfigurationBundles— Restituisce tutti i pacchetti presenti nel tuo account con informazioni di riepilogo.

  • ListConfigurationBundleVersions— Restituisce tutte le versioni di un pacchetto specifico, con filtraggio opzionale per ramo o fonte di creazione.

Entrambe le operazioni supportano l'impaginazione.

Esempi di codice

Esempio
AgentCore CLI

Elenca le versioni di un pacchetto:

agentcore config-bundle versions --name myAgentConfig

Filtra per ramo:

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

Mostra solo la versione più recente per filiale:

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

Filtra per autore (ad esempio, versioni create da un processo di raccomandazione):

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

Elenca tutti i pacchetti con impaginazione:

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

Elenca le versioni di un pacchetto specifico:

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

Parametri della richiesta

ListConfigurationBundles

Parametro Tipo Campo obbligatorio Description

maxResults

Numero intero

No

Numero massimo di risultati da restituire per pagina. Intervallo: 1—100.

nextToken

Stringa

No

Token di impaginazione di una risposta precedente.

ListConfigurationBundleVersions

Parametro Tipo Campo obbligatorio Descrizione

bundleId

Stringa

Sì

L'ID del pacchetto di configurazione. Passato come parametro di percorso.

filter

Oggetto

No

Filtro opzionale. ConsultaFiltro di versione qui di seguito.

maxResults

Numero intero

No

Numero massimo di risultati da restituire per pagina. Intervallo: 1—100.

nextToken

Stringa

No

Token di impaginazione di una risposta precedente.

Filtro di versione

Campo Tipo Description

branchName

Stringa

Restituisce solo le versioni su questo ramo.

createdByName

Stringa

Restituisce solo le versioni create con questo nome di origine (ad esempio, optimization-job orecommendation).

latestPerBranch

Booleano

Whentrue, restituisce solo la versione più recente per ogni ramo. Può essere combinato con branchName per ottenere le ultime novità per un ramo specifico.

Risposta

ListConfigurationBundles

Campo Tipo Description

bundles

List

Elenco dei riepiloghi dei pacchetti. Ciascuno contienebundleArn, bundleIdbundleName, e. description

nextToken

Stringa

Token di impaginazione per la pagina successiva. Assente quando non ci sono più risultati.

ListConfigurationBundleVersions

Campo Tipo Description

versions

List

Elenco dei riepiloghi delle versioni. Ciascuno contienebundleArn,bundleId, versionIdlineageMetadata, eversionCreatedAt.

nextToken

Stringa

Token di impaginazione per la pagina successiva. Assente quando non ci sono più risultati.

Errori

Errore Stato HTTP Description

ValidationException

400

Parametri di richiesta non validi.

ResourceNotFoundException

404

Il valore specificato bundleId non esiste (ListConfigurationBundleVersions solo).

AccessDeniedException

403

Autorizzazioni insufficienti.

ThrottlingException

429

Frequenza di richiesta superata. Riprova con backoff esponenziale.

InternalServerException

500

Service-side errore. Riprova la richiesta .