View a markdown version of this page

Konfigurationspakete auflisten - Amazon Grundgestein AgentCore
CodebeispieleAnforderungsparameterAntwortFehler

Konfigurationspakete auflisten

Listet Konfigurationspakete in Ihrem Konto auf oder listet Versionen eines bestimmten Bundles auf. Zwei Operationen sind verfügbar:

  • ListConfigurationBundles— Gibt alle Bundles in Ihrem Konto mit zusammenfassenden Informationen zurück.

  • ListConfigurationBundleVersions— Gibt alle Versionen eines bestimmten Bundles zurück, mit optionaler Filterung nach Zweig oder Erstellungsquelle.

Beide Operationen unterstützen die Paginierung.

Codebeispiele

Beispiel
AgentCore CLI

Versionen eines Bundles auflisten:

agentcore config-bundle versions --name myAgentConfig

Nach Branche filtern:

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

Nur die neueste Version pro Zweig anzeigen:

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

Nach Ersteller filtern (z. B. Versionen, die durch einen Empfehlungsjob erstellt wurden):

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

Alle Bundles mit Paginierung auflisten:

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

Listet die Versionen eines bestimmten Bundles auf:

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

Anforderungsparameter

ListConfigurationBundles

Parameter Typ Erforderlich Description

maxResults

Ganzzahl

Nein

Maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen. Bereich: 1—100.

nextToken

Zeichenfolge

Nein

Paginierungstoken aus einer früheren Antwort.

ListConfigurationBundleVersions

Parameter Typ Erforderlich Beschreibung

bundleId

Zeichenfolge

Ja

Die ID des Konfigurationspakets. Als Pfadparameter übergeben.

filter

Objekt

Nein

Optionaler Filter. Weitere Informationen finden Sie unter Versionsfilter weiter unten in diesem Dokument.

maxResults

Ganzzahl

Nein

Maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen. Bereich: 1—100.

nextToken

Zeichenfolge

Nein

Paginierungstoken aus einer früheren Antwort.

Versionsfilter

Feld Typ Description

branchName

Zeichenfolge

Gibt nur Versionen in diesem Zweig zurück.

createdByName

Zeichenfolge

Gibt nur Versionen zurück, die mit diesem Quellnamen erstellt wurden (z. B. optimization-job oderrecommendation).

latestPerBranch

Boolesch

Wenntrue, gibt nur die neueste Version für jeden Zweig zurück. Kann kombiniert werdenbranchName, um die neueste Version für einen bestimmten Zweig zu erhalten.

Antwort

ListConfigurationBundles

Feld Typ Description

bundles

Auflisten

Liste der Zusammenfassungen der Pakete. Jedes enthältbundleArn, bundleIdbundleName, unddescription.

nextToken

Zeichenfolge

Paginierungstoken für die nächste Seite. Fehlt, wenn es keine weiteren Ergebnisse gibt.

ListConfigurationBundleVersions

Feld Typ Description

versions

Auflisten

Liste der Versionszusammenfassungen. Jede enthältbundleArn,bundleId, versionIdlineageMetadata, undversionCreatedAt.

nextToken

Zeichenfolge

Paginierungstoken für die nächste Seite. Fehlt, wenn es keine weiteren Ergebnisse gibt.

Fehler

Fehler HTTP-Status Description

ValidationException

400

Ungültige Anforderungsparameter.

ResourceNotFoundException

404

Das angegebene bundleId Objekt existiert nicht (ListConfigurationBundleVersions nur).

AccessDeniedException

403

Unzureichende Berechtigungen.

ThrottlingException

429

Die Anforderungsrate wurde überschritten. Versuchen Sie es erneut mit exponentiellem Backoff.

InternalServerException

500

Service-side Fehler. Wiederholen Sie die Anforderung.