View a markdown version of this page

Ottieni un pacchetto di configurazione - Fondamento Amazon AgentCore
Raggruppa i metadati rispetto al contenuto della versioneEsempi di codiceParametri della richiestaRispostaErrori

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ottieni un pacchetto di configurazione

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

  • GetConfigurationBundle— Restituisce la versione più recente di un pacchetto. Se branchName è specificato, restituisce la versione più recente su quel ramo. Se omesso, restituisce la versione più recente in tutte le filiali. Usalo per leggere la configurazione attiva corrente.

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

Raggruppa i metadati rispetto al contenuto della versione

GetConfigurationBundlerestituisce sia i metadati a livello di pacchetto (nome, descrizione, ARN) che 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 gli stessi campi in piùversionCreatedAt, che indicano esattamente quando è stata creata quella versione specifica (al createdAt contrario di quando il pacchetto stesso è stato creato 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»: i config-bundle sottocomandi sonoversions, diff e. create-branch Per enumerare le versioni e acquisirne gli ID, utilizza 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 di configurazione completo di una versione del pacchetto, utilizzate l'operazione mostrata di seguito. SDK/REST GetConfigurationBundleVersion

AWS SDK (boto3)

Ottieni i metadati del pacchetto e i contenuti 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 della filiale da cui ottenere la versione più recente. Se omesso, restituisce la versione più recente in tutte le filiali.

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 sulla derivazione della versione, tra cui,, parentVersionIds e. branchName createdBy commitMessage

createdAt

Time stamp

Quando il pacchetto è stato creato originariamente.

updatedAt

Time stamp

L'ultima volta che il pacchetto è stato aggiornato (GetConfigurationBundle solo).

versionCreatedAt

Time stamp

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

Errori

Errore Stato HTTP Description

ValidationException

400

Parametri di richiesta non validi.

ResourceNotFoundException

404

Il valore specificato bundleId o versionId non esiste.

AccessDeniedException

403

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

ThrottlingException

429

La percentuale di richieste è stata superata. Riprova con un backoff esponenziale.

InternalServerException

500

Service-side errore. Riprova la richiesta .