View a markdown version of this page

Holen Sie sich ein Konfigurationspaket - Amazon Grundgestein AgentCore
Bündel-Metadaten im Vergleich zu VersionsinhaltenCodebeispieleAnforderungsparameterAntwortFehler

Holen Sie sich ein Konfigurationspaket

Rufen Sie ein Konfigurationspaket ab, um dessen Metadaten zu überprüfen, oder lesen Sie den vollständigen Konfigurationsinhalt einer bestimmten Version. Zwei Operationen sind verfügbar:

  • GetConfigurationBundle— Gibt die neueste Version eines Bundles zurück. Wenn angegeben, branchName wird die neueste Version in diesem Zweig zurückgegeben. Wenn nicht angegeben, wird die neueste Version für alle Zweige zurückgegeben. Verwenden Sie dies, um die aktuelle aktive Konfiguration zu lesen.

  • GetConfigurationBundleVersion— Gibt eine bestimmte historische Version anhand der Versions-ID zurück. Verwenden Sie diese Option, um frühere Konfigurationen zu überprüfen oder Versionen zu vergleichen.

Bündel-Metadaten im Vergleich zu Versionsinhalten

GetConfigurationBundlegibt sowohl die Metadaten auf Bundle-Ebene (Name, Beschreibung, ARN) als auch den Inhalt der Vollversion (Komponenten mit ihren Konfigurationsschlüssel-Wert-Paaren) zurück. Wenn Sie nur wissen möchten, welche Versionen existieren, ohne deren vollständigen Inhalt abzurufen, verwenden Sie stattdessen. ListConfigurationBundleVersions

GetConfigurationBundleVersiongibt dieselben Felder plus zurückversionCreatedAt, was Ihnen genau sagt, wann diese bestimmte Version erstellt wurde (im Gegensatz zu dem ZeitpunktcreatedAt, an dem das Bundle selbst zum ersten Mal erstellt wurde).

Codebeispiele

Beispiel
AgentCore CLI

Versionsverlauf für ein Bundle anzeigen:

agentcore config-bundle versions --name myAgentConfig

Vergleichen Sie zwei Versionen nebeneinander:

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

Es gibt keinen direkten CLI-Befehl „Get Bundle Content“ — die config-bundle Unterbefehle lauten versionsdiff, undcreate-branch. Um Versionen aufzuzählen und ihre IDs zu erfassen, verwenden Sie agentcore config-bundle versions --name myAgentConfig --json (optional mit--branch <name>,--latest-per-branch, oder--created-by <name>) und geben Sie dann die Versions-IDs ein. config-bundle diff Verwenden Sie den unten gezeigten SDK/REST GetConfigurationBundleVersion Vorgang, um den vollständigen Konfigurationsinhalt einer Bundle-Version abzurufen.

AWS SDK (boto3)

Holen Sie sich die Bundle-Metadaten und den Inhalt der neuesten 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']}")

Holen Sie sich eine bestimmte historische Version:

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

Anforderungsparameter

GetConfigurationBundle

Parameter Typ Erforderlich Beschreibung

bundleId

Zeichenfolge

Ja

Die ID des Konfigurationspakets. Als Pfadparameter übergeben.

branchName

Zeichenfolge

Nein

Name der Filiale, von der die neueste Version abgerufen werden soll. Wenn nicht angegeben, wird die neueste Version für alle Zweige zurückgegeben.

GetConfigurationBundleVersion

Parameter Typ Erforderlich Beschreibung

bundleId

Zeichenfolge

Ja

Die ID des Konfigurationspakets. Als Pfadparameter übergeben.

versionId

Zeichenfolge

Ja

Die UUID der spezifischen Version, die abgerufen werden soll. Als Pfadparameter übergeben.

Antwort

Beide Operationen geben dieselben Felder zurück. GetConfigurationBundleVersiongibt zusätzlich zurückversionCreatedAt.

Feld Typ Description

bundleArn

Zeichenfolge

ARN des Konfigurationspakets.

bundleId

Zeichenfolge

ID des Konfigurationspakets.

bundleName

Zeichenfolge

Name des Bundles.

description

Zeichenfolge

Beschreibung des Bundles (falls festgelegt).

versionId

Zeichenfolge

UUID der zurückgegebenen Version.

components

Zuordnung

Zuordnung der Komponenten-ID zur Komponentenkonfiguration. Jeder Wert enthält ein configuration Objekt mit den in dieser Version gespeicherten Schlüssel-Wert-Paaren.

lineageMetadata

Objekt

Metadaten zur VersionsherkunftparentVersionIds, einschließlich,branchName, createdBy und. commitMessage

createdAt

Zeitstempel

Wann das Bundle ursprünglich erstellt wurde.

updatedAt

Zeitstempel

Wann das Bundle zuletzt aktualisiert wurde (GetConfigurationBundle nur).

versionCreatedAt

Zeitstempel

Wann diese spezielle Version erstellt wurde (GetConfigurationBundleVersion nur).

Fehler

Fehler HTTP-Status Description

ValidationException

400

Ungültige Anforderungsparameter.

ResourceNotFoundException

404

Der angegebene Wert ist versionId nicht vorhanden bundleId oder nicht vorhanden.

AccessDeniedException

403

Unzureichende Berechtigungen. Stellen Sie sicher, dass die IAM-Richtlinien bedrock-agentcore:GetConfigurationBundle oder bedrock-agentcore:GetConfigurationBundleVersion beinhalten.

ThrottlingException

429

Die Anforderungsrate wurde überschritten. Versuchen Sie es erneut mit exponentiellem Backoff.

InternalServerException

500

Service-side Fehler. Wiederholen Sie die Anforderung.