# Obtenir un bundle de configuration
<a name="configuration-bundles-get"></a>

Récupérez un bundle de configuration pour inspecter ses métadonnées ou lire le contenu complet de configuration d'une version spécifique. Deux opérations sont disponibles :
+  **GetConfigurationBundle**— Renvoie la dernière version d'un bundle. Si elle `branchName` est spécifiée, renvoie la dernière version sur cette branche. En cas d'omission, renvoie la version la plus récente dans toutes les branches. Utilisez-le pour lire la configuration active actuelle.
+  **GetConfigurationBundleVersion**— Renvoie une version historique spécifique par ID de version. Utilisez-le pour inspecter les configurations passées ou comparer les versions.

## Comparaison des métadonnées du bundle avec le contenu de la version
<a name="get-bundle-metadata-vs-content"></a>

 `GetConfigurationBundle`renvoie à la fois les métadonnées au niveau du bundle (nom, description, ARN) et le contenu complet de la version (composants avec leurs paires clé-valeur de configuration). Si vous avez uniquement besoin de savoir quelles versions existent sans récupérer leur contenu complet, utilisez `ListConfigurationBundleVersions` plutôt.

 `GetConfigurationBundleVersion`renvoie les mêmes champs plus`versionCreatedAt`, qui vous indiquent exactement quand cette version spécifique a été créée (par opposition à la date à `createdAt` laquelle le bundle lui-même a été créé pour la première fois).

## Exemples de code
<a name="get-bundle-examples"></a>

**Example**  
Afficher l'historique des versions d'un bundle :  

```
agentcore config-bundle versions --name myAgentConfig
```
Comparez deux versions côte à côte :  

```
agentcore config-bundle diff --name myAgentConfig \
  --from <version-1> \
  --to <version-2>
```
Il n'existe pas de commande CLI directe « get bundle content » ; les `config-bundle` sous-commandes sont `versions``diff`, et`create-branch`. Pour énumérer les versions et capturer leurs identifiants, utilisez `agentcore config-bundle versions --name myAgentConfig --json` (éventuellement avec`--branch <name>`, ou`--created-by <name>`)`--latest-per-branch`, puis introduisez les identifiants de version dans`config-bundle diff`. Pour récupérer le contenu complet de la configuration d'une version groupée, utilisez l' SDK/REST `GetConfigurationBundleVersion`opération ci-dessous.
Accédez aux métadonnées du bundle et au contenu de la dernière version :  

```
import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

response = client.get_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5"
)

print(f"Bundle: {response['bundleName']}")
print(f"Version: {response['versionId']}")
print(f"Branch: {response.get('lineageMetadata', {}).get('branchName', 'N/A')}")
print(f"Components: {response['components']}")
```
Obtenez une version historique spécifique :  

```
response = client.get_configuration_bundle_version(
    bundleId="myAgentConfig-a1b2c3d4e5",
    versionId="12345678-1234-1234-1234-123456789012"
)

print(f"Version: {response['versionId']}")
print(f"Version created at: {response['versionCreatedAt']}")
print(f"Commit message: {response.get('lineageMetadata', {}).get('commitMessage', '')}")
print(f"Components: {response['components']}")
```

## Paramètres de demande
<a name="get-bundle-params"></a>

### GetConfigurationBundle
<a name="get-bundle-params-latest"></a>


| Paramètre | Type | Obligatoire | Description | 
| --- | --- | --- | --- | 
|  `bundleId`  | String | Oui | ID du bundle de configuration. Transmis en tant que paramètre de chemin. | 
|  `branchName`  | String | Non | Nom de la branche à partir de laquelle obtenir la dernière version. En cas d'omission, renvoie la version la plus récente dans toutes les branches. | 

### GetConfigurationBundleVersion
<a name="get-bundle-params-version"></a>


| Paramètre | Type | Obligatoire | Description | 
| --- | --- | --- | --- | 
|  `bundleId`  | String | Oui | ID du bundle de configuration. Transmis en tant que paramètre de chemin. | 
|  `versionId`  | String | Oui | L'UUID de la version spécifique à récupérer. Transmis en tant que paramètre de chemin. | 

## Réponse
<a name="get-bundle-response"></a>

Les deux opérations renvoient les mêmes champs. `GetConfigurationBundleVersion`retours supplémentaires`versionCreatedAt`.


| Champ | Type | Description | 
| --- | --- | --- | 
|  `bundleArn`  | String | ARN du bundle de configuration. | 
|  `bundleId`  | String | ID du bundle de configuration. | 
|  `bundleName`  | String | Nom du bundle. | 
|  `description`  | String | Description du bundle (si défini). | 
|  `versionId`  | String | UUID de la version renvoyée. | 
|  `components`  | Map | Associer l'identifiant du composant à la configuration du composant. Chaque valeur contient un `configuration` objet dont les paires clé-valeur sont stockées dans cette version. | 
|  `lineageMetadata`  | Objet | Les métadonnées du lignage des versions`parentVersionIds`, y compris`branchName`,`createdBy`, et`commitMessage`. | 
|  `createdAt`  | Horodatage | Date de création initiale du bundle. | 
|  `updatedAt`  | Horodatage | Date de dernière mise à jour du bundle (GetConfigurationBundle uniquement). | 
|  `versionCreatedAt`  | Horodatage | Quand cette version spécifique a été créée (GetConfigurationBundleVersion uniquement). | 

## Erreurs
<a name="get-bundle-errors"></a>


| Erreur | Statut HTTP | Description | 
| --- | --- | --- | 
|  `ValidationException`  | 400 | Paramètres de demande non valides. | 
|  `ResourceNotFoundException`  | 404 | La valeur spécifiée `bundleId` ou `versionId` n'existe pas. | 
|  `AccessDeniedException`  | 403 | Autorisations insuffisantes. Vérifiez que les politiques IAM incluent `bedrock-agentcore:GetConfigurationBundle` ou`bedrock-agentcore:GetConfigurationBundleVersion`. | 
|  `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. |