View a markdown version of this page

Obtenga un paquete de configuración - Base amazónica AgentCore
Combine los metadatos frente al contenido de la versiónEjemplos de códigoParámetros de solicitudRespuestaErrores

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Obtenga un paquete de configuración

Recupere un paquete de configuración para inspeccionar sus metadatos o lea todo el contenido de configuración 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. Utilícela 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 frente al contenido de la versión

GetConfigurationBundledevuelve tanto los metadatos a nivel de paquete (nombre, descripción, ARN) como el contenido de la versión completa (los componentes con sus pares clave-valor de configuración). Si solo necesita saber qué versiones existen sin obtener su contenido completo, utilícela 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 para «obtener el contenido del paquete»; los config-bundle subcomandos son versionsdiff, ycreate-branch. Para enumerar las versiones y capturar sus ID, utilice agentcore config-bundle versions --name myAgentConfig --json (si lo desea, 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 todo el contenido de 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 versión más reciente:

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 sucursal de la que obtener la última versión. Si se omite, devuelve la versión más reciente en todas las ramas.

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 a 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

Cuando 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 solo).

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. Verifique 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 .