# Répertorier les ensembles de configuration
<a name="configuration-bundles-list"></a>

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
<a name="list-bundles-examples"></a>

**Example**  
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
```
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
<a name="list-bundles-params"></a>

### ListConfigurationBundles
<a name="list-bundles-params-bundles"></a>


| 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
<a name="list-bundles-params-versions"></a>


| 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](#list-bundles-filter) 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
<a name="list-bundles-filter"></a>


| 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` ou`recommendation`). | 
|  `latestPerBranch`  | Booléen | When`true`, 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
<a name="list-bundles-response"></a>

### ListConfigurationBundles
<a name="list-bundles-response-bundles"></a>


| Champ | Type | Description | 
| --- | --- | --- | 
|  `bundles`  | List | Liste des résumés des offres groupées. Chacun contient `bundleArn``bundleId`,`bundleName`, et`description`. | 
|  `nextToken`  | String | Jeton de pagination pour la page suivante. Absent lorsqu'il n'y a plus de résultats. | 

### ListConfigurationBundleVersions
<a name="list-bundles-response-versions"></a>


| Champ | Type | Description | 
| --- | --- | --- | 
|  `versions`  | List | Liste des résumés des versions. Chacun contient`bundleArn`, `bundleId``versionId`,`lineageMetadata`, et`versionCreatedAt`. | 
|  `nextToken`  | String | Jeton de pagination pour la page suivante. Absent lorsqu'il n'y a plus de résultats. | 

## Erreurs
<a name="list-bundles-errors"></a>


| 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. |