View a markdown version of this page

Obtenga un paquete de configuración - Amazon Bedrock AgentCore
Combine los metadatos con el contenido de la versiónEjemplos de códigoParámetros de solicitudRespuestaErrores

Obtenga un paquete de configuración

Recupere un paquete de configuración para inspeccionar sus metadatos o leer el contenido de configuración completo de una versión específica. Hay dos operaciones disponibles:

  • GetConfigurationBundle— Devuelve la última versión de un paquete. Si branchName se especifica, devuelve la última versión de esa rama. Si se omite, devuelve la versión más reciente en todas las ramas. Use esto para leer la configuración activa actual.

  • GetConfigurationBundleVersion— Devuelve una versión histórica específica por ID de versión. Úselo para inspeccionar configuraciones anteriores o comparar versiones.

Combine los metadatos con el contenido de la versión

GetConfigurationBundledevuelve los metadatos a nivel de paquete (nombre, descripción, ARN) y el contenido de la versión completa (componentes con sus pares clave-valor de configuración). Si solo necesita saber qué versiones existen sin obtener su contenido completo, utilícelas en su lugar. ListConfigurationBundleVersions

GetConfigurationBundleVersiondevuelve los mismos campos másversionCreatedAt, lo que indica exactamente cuándo se creó esa versión específica (a createdAt diferencia de cuando se creó el paquete por primera vez).

Ejemplos de código

ejemplo
AgentCore CLI

Ver el historial de versiones de un paquete:

agentcore config-bundle versions --name myAgentConfig

Compara dos versiones una al lado de la otra:

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

No existe un comando CLI directo «get bundle content»; los config-bundle subcomandos son versionsdiff, ycreate-branch. Para enumerar las versiones y capturar sus ID, utilice agentcore config-bundle versions --name myAgentConfig --json (opcionalmente con--branch <name>, o--created-by <name>) y--latest-per-branch, a continuación, introduzca los ID de versión. config-bundle diff Para obtener el contenido completo de la configuración de una versión de paquete, utilice la SDK/REST GetConfigurationBundleVersion operación que se muestra a continuación.

AWS SDK (boto3)

Obtenga los metadatos del paquete y el contenido de la última versión:

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

Obtenga una versión histórica específica:

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

Parámetros de solicitud

GetConfigurationBundle

Parámetro Tipo Obligatorio Descripción

bundleId

Cadena

Sí

El ID del paquete de configuración. Se pasa como parámetro de ruta.

branchName

Cadena

No

Nombre de la rama de la que se va a obtener la última versión. Si se omite, devuelve la versión más reciente en todas las sucursales.

GetConfigurationBundleVersion

Parámetro Tipo Obligatorio Descripción

bundleId

Cadena

Sí

El ID del paquete de configuración. Se pasa como parámetro de ruta.

versionId

Cadena

Sí

El UUID de la versión específica que se va a recuperar. Se pasa como parámetro de ruta.

Respuesta

Ambas operaciones devuelven los mismos campos. GetConfigurationBundleVersiondevuelve adicionalmenteversionCreatedAt.

Campo Tipo Description (Descripción)

bundleArn

Cadena

ARN del paquete de configuración.

bundleId

Cadena

ID del paquete de configuración.

bundleName

Cadena

Nombre del paquete.

description

Cadena

Descripción del paquete (si está establecido).

versionId

Cadena

UUID de la versión devuelta.

components

Asignación

Mapa del identificador del componente con la configuración del componente. Cada valor contiene un configuration objeto con los pares clave-valor almacenados en esta versión.

lineageMetadata

Objeto

Los metadatos del linaje de versiones incluyenparentVersionIds,branchName, createdBy y. commitMessage

createdAt

Timestamp

Cuándo se creó originalmente el paquete.

updatedAt

Timestamp

Cuándo se actualizó el paquete por última vez (GetConfigurationBundle únicamente).

versionCreatedAt

Timestamp

Cuándo se creó esta versión específica (GetConfigurationBundleVersion únicamente).

Errores

Error Estado HTTP Description (Descripción)

ValidationException

400

Parámetros de solicitud no válidos.

ResourceNotFoundException

404

El especificado bundleId o versionId no existe.

AccessDeniedException

403

Permisos insuficientes. Compruebe que las políticas de IAM incluyan bedrock-agentcore:GetConfigurationBundle obedrock-agentcore:GetConfigurationBundleVersion.

ThrottlingException

429

Se superó la tasa de solicitudes. Vuelva a intentarlo con retroceso exponencial.

InternalServerException

500

Service-side error. Intente realizar de nuevo la solicitud .