View a markdown version of this page

Obtenir un bundle de configuration - Amazon Bedrock AgentCore
Comparaison des métadonnées du bundle avec le contenu de la versionExemples de codeParamètres de demandeRéponseErreurs

Obtenir un bundle de configuration

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

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

GetConfigurationBundleVersionrenvoie les mêmes champs plusversionCreatedAt, 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

Exemple
AgentCore CLI

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

Il n'existe pas de commande CLI directe « get bundle content » ; les config-bundle sous-commandes sont versionsdiff, etcreate-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 dansconfig-bundle diff. Pour récupérer le contenu complet de la configuration d'une version groupée, utilisez l' SDK/REST GetConfigurationBundleVersionopération ci-dessous.

AWS SDK (boto3)

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

GetConfigurationBundle

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

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

Les deux opérations renvoient les mêmes champs. GetConfigurationBundleVersionretours supplémentairesversionCreatedAt.

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 versionsparentVersionIds, y comprisbranchName,createdBy, etcommitMessage.

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

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