View a markdown version of this page

Ottieni un pacchetto di configurazione - Amazon Bedrock AgentCore
Raggruppa i metadati e il contenuto della versioneEsempi di codiceParametri della richiestaRispostaErrori

Ottieni un pacchetto di configurazione

Recupera un pacchetto di configurazione per esaminarne i metadati o leggi il contenuto completo della configurazione di una versione specifica. Sono disponibili due operazioni:

  • GetConfigurationBundle— Restituisce l'ultima versione di un pacchetto. Se branchName specificato, restituisce la versione più recente su quel ramo. Se omesso, restituisce la versione più recente in tutti i rami. Utilizzatelo per leggere la configurazione attiva corrente.

  • GetConfigurationBundleVersion— Restituisce una versione storica specifica in base all'ID della versione. Utilizzatelo per controllare le configurazioni precedenti o confrontare le versioni.

Raggruppa i metadati e il contenuto della versione

GetConfigurationBundlerestituisce sia i metadati a livello di pacchetto (nome, descrizione, ARN) sia il contenuto della versione completa (componenti con le relative coppie chiave-valore di configurazione). Se hai solo bisogno di sapere quali versioni esistono senza recuperarne il contenuto completo, usa invece. ListConfigurationBundleVersions

GetConfigurationBundleVersionrestituisce lo stesso campo plusversionCreatedAt, che indica esattamente quando è stata creata quella versione specifica (al createdAt contrario di quando è stato creato il pacchetto stesso per la prima volta).

Esempi di codice

Esempio
AgentCore CLI

Visualizza la cronologia delle versioni di un pacchetto:

agentcore config-bundle versions --name myAgentConfig

Confronta due versioni fianco a fianco:

agentcore config-bundle diff --name myAgentConfig \
  --from <version-1> \
  --to <version-2>
Nota

Non esiste un comando CLI diretto «get bundle content»: config-bundle i sottocomandi versions sonodiff, e. create-branch Per enumerare le versioni e acquisirne gli ID, usa agentcore config-bundle versions --name myAgentConfig --json (facoltativamente con, o--created-by <name>) --branch <name>--latest-per-branch, quindi inserisci gli ID di versione in. config-bundle diff Per recuperare il contenuto completo della configurazione di una versione in bundle, utilizzate l'operazione mostrata di seguito. SDK/REST GetConfigurationBundleVersion

AWS SDK (boto3)

Ottieni i metadati del pacchetto e il contenuto della versione più recente:

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

Ottieni una versione storica specifica:

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

Parametri della richiesta

GetConfigurationBundle

Parametro Tipo Campo obbligatorio Descrizione

bundleId

Stringa

Sì

L'ID del pacchetto di configurazione. Passato come parametro di percorso.

branchName

Stringa

No

Nome del ramo da cui ottenere la versione più recente. Se omesso, restituisce la versione più recente in tutti i rami.

GetConfigurationBundleVersion

Parametro Tipo Campo obbligatorio Descrizione

bundleId

Stringa

Sì

L'ID del pacchetto di configurazione. Passato come parametro di percorso.

versionId

Stringa

Sì

L'UUID della versione specifica da recuperare. Passato come parametro di percorso.

Risposta

Entrambe le operazioni restituiscono gli stessi campi. GetConfigurationBundleVersionrestituisce inoltreversionCreatedAt.

Campo Tipo Description

bundleArn

Stringa

ARN del pacchetto di configurazione.

bundleId

Stringa

ID del pacchetto di configurazione.

bundleName

Stringa

Nome del pacchetto.

description

Stringa

Descrizione del pacchetto (se impostato).

versionId

Stringa

UUID della versione restituita.

components

Eseguire la mappatura

Mappa dell'identificatore del componente alla configurazione del componente. Ogni valore contiene un configuration oggetto con le coppie chiave-valore memorizzate in questa versione.

lineageMetadata

Oggetto

Metadati relativi alla derivazione delle versioniparentVersionIds, tra cui,, ebranchName. createdBy commitMessage

createdAt

Time stamp

Quando il pacchetto è stato originariamente creato.

updatedAt

Time stamp

Data dell'ultimo aggiornamento del pacchetto (GetConfigurationBundle solo).

versionCreatedAt

Time stamp

Quando è stata creata questa versione specifica (GetConfigurationBundleVersion solo).

Errori

Errore Stato HTTP Description

ValidationException

400

Parametri di richiesta non validi.

ResourceNotFoundException

404

L'bundleIdo specificato versionId non esiste.

AccessDeniedException

403

Autorizzazioni insufficienti. Verifica che le politiche IAM includano bedrock-agentcore:GetConfigurationBundle obedrock-agentcore:GetConfigurationBundleVersion.

ThrottlingException

429

Frequenza di richiesta superata. Riprova con backoff esponenziale.

InternalServerException

500

Service-side errore. Riprova la richiesta .