View a markdown version of this page

Répertorier les ensembles de configuration - Amazon Bedrock AgentCore
Exemples de codeParamètres de demandeRéponseErreurs

Répertorier les ensembles de configuration

Répertoriez les ensembles de configuration dans votre compte ou listez les versions d'un ensemble spécifique. Deux opérations sont disponibles :

  • ListConfigurationBundles— Renvoie tous les forfaits de votre compte avec des informations récapitulatives.

  • ListConfigurationBundleVersions— Renvoie toutes les versions d'un bundle spécifique, avec un filtrage optionnel par branche ou source de création.

Les deux opérations prennent en charge la pagination.

Exemples de code

Exemple
AgentCore CLI

Répertorier les versions d'un bundle :

agentcore config-bundle versions --name myAgentConfig

Filtrer par branche :

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

Afficher uniquement la dernière version par branche :

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

Filtrer par créateur (par exemple, versions créées par une tâche de recommandation) :

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

Répertoriez tous les bundles avec pagination :

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

Répertorier les versions d'un bundle spécifique :

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

Paramètres de demande

ListConfigurationBundles

Paramètre Type Obligatoire Description

maxResults

Entier

Non

Nombre maximum de résultats à renvoyer par page. Gamme : 1 à 100

nextToken

String

Non

Jeton de pagination provenant d'une réponse précédente.

ListConfigurationBundleVersions

Paramètre Type Obligatoire Description

bundleId

String

Oui

L'ID du bundle de configuration. Transmis en tant que paramètre de chemin.

filter

Objet

Non

Filtre optionnel. Reportez-vous à Filtre de version ci-dessous.

maxResults

Entier

Non

Nombre maximum de résultats à renvoyer par page. Gamme : 1 à 100

nextToken

String

Non

Jeton de pagination provenant d'une réponse précédente.

Filtre de version

Champ Type Description

branchName

String

Renvoie uniquement les versions de cette branche.

createdByName

String

Renvoie uniquement les versions créées sous ce nom de source (par exemple, optimization-job ourecommendation).

latestPerBranch

Booléen

Whentrue, renvoie uniquement la dernière version pour chaque branche. Peut être combiné branchName pour obtenir les dernières informations pour une branche spécifique.

Réponse

ListConfigurationBundles

Champ Type Description

bundles

List

Liste des résumés des offres groupées. Chacun contient bundleArnbundleId,bundleName, etdescription.

nextToken

String

Jeton de pagination pour la page suivante. Absent lorsqu'il n'y a plus de résultats.

ListConfigurationBundleVersions

Champ Type Description

versions

List

Liste des résumés des versions. Chacun contientbundleArn, bundleIdversionId,lineageMetadata, etversionCreatedAt.

nextToken

String

Jeton de pagination pour la page suivante. Absent lorsqu'il n'y a plus de résultats.

Erreurs

Erreur Statut HTTP Description

ValidationException

400

Paramètres de demande non valides.

ResourceNotFoundException

404

Le spécifié bundleId n'existe pas (ListConfigurationBundleVersions uniquement).

AccessDeniedException

403

Autorisations insuffisantes.

ThrottlingException

429

Le taux de demandes a été dépassé. Réessayez avec un recul exponentiel.

InternalServerException

500

Service-side erreur. Réitérez la demande.