View a markdown version of this page

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

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Elenca i pacchetti di configurazione

Elenca i pacchetti di configurazione 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 filtro opzionale per filiale 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 filiale:

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 creatore (ad esempio, versioni create da un job 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 derivante da 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 della 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 derivante da una risposta precedente.

Filtro della 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

Quandotrue, restituisce solo la versione più recente per ogni ramo. Può essere combinato con branchName per ottenere la versione più recente per una filiale specifica.

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

Percentuale di richieste superata. Riprova con un backoff esponenziale.

InternalServerException

500

Service-side errore. Riprova la richiesta .