View a markdown version of this page

Obtenir un ensemble de configuration - Base rocheuse de l'Amazonie AgentCore
Les métadonnées du bundle par rapport au contenu de la versionExemples de codeParamètres de demandeRéponseErreurs

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Obtenir un ensemble 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 cette option branchName est spécifiée, renvoie la dernière version de 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 précédentes ou comparer les versions.

Les métadonnées du bundle par rapport au contenu de la version

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

GetConfigurationBundleVersionrenvoie les mêmes champs plusversionCreatedAt, ce qui vous indique 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 ID, utilisez agentcore config-bundle versions --name myAgentConfig --json (éventuellement avec --branch <name>--latest-per-branch, ou--created-by <name>), puis saisissez les ID de version dansconfig-bundle diff. Pour récupérer le contenu de configuration complet d'une version groupée, utilisez l' SDK/REST GetConfigurationBundleVersionopération ci-dessous.

AWS SDK (boto3)

Obtenez les métadonnées du bundle et le 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

Chaîne

Oui

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

branchName

Chaîne

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

Chaîne

Oui

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

versionId

Chaîne

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. GetConfigurationBundleVersionrenvoie égalementversionCreatedAt.

Champ Type Description

bundleArn

Chaîne

ARN du bundle de configuration.

bundleId

Chaîne

ID du bundle de configuration.

bundleName

Chaîne

Nom du bundle.

description

Chaîne

Description du pack (s'il est défini).

versionId

Chaîne

UUID de la version renvoyée.

components

Map

Carte de 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

Métadonnées de 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

Le bundleId ou la valeur spécifiée versionId n'existe pas.

AccessDeniedException

403

Autorisations insuffisantes. Vérifiez que les politiques IAM incluent bedrock-agentcore:GetConfigurationBundle oubedrock-agentcore:GetConfigurationBundleVersion.

ThrottlingException

429

Taux de demandes dépassé. Réessayez avec un backoff exponentiel.

InternalServerException

500

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