

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.

# Administre sus datos en instancias de tiempo de ejecución
<a name="runtime-instances-data-management"></a>

Cuando aloja agentes en el tipo de ** procesamiento de la ** instancia, sus datos se almacenan en los volúmenes de Amazon EBS de su propia AWS cuenta.

En este tema se describe lo que se AgentCore almacena allí y cómo se lee, se cambia, se extrae y se elimina.

Para obtener información sobre el modelo de responsabilidad compartida que se aplica a todo Amazon Bedrock AgentCore, consulte Protección de [ datos en Amazon Bedrock AgentCore](data-protection.md).

## Qué almacena Instances y dónde
<a name="runtime-instances-data-management-what"></a>

Las instancias almacenan dos categorías de datos. La siguiente tabla muestra dónde reside cada categoría y qué recurso controla su ciclo de vida.


| Categoría | Dónde se almacena | El ciclo de vida está controlado por | 
| --- | --- | --- | 
| Contenido volumétrico | Volúmenes de Amazon Elastic Block Store (Amazon EBS) que se AgentCore crean en su AWS cuenta y se acumulan en su agente | La sesión que monta el volumen | 
| Configuración de recursos | Los registros de tiempo de ejecución del agente y del proveedor de capacidad, incluidos el nombre, la descripción, los tipos de instancia permitidos y las definiciones de redes y almacenamiento | El proveedor de capacidad y el tiempo de ejecución del agente | 

El contenido del volumen es lo que el agente lee y escribe en su ruta de montaje. Los volúmenes de Amazon EBS se crean en su cuenta, por lo que se les aplican los controles de su cuenta actual. Para obtener información sobre cómo se cifran los volúmenes, consulte [ Encryption at rest for Runtime Instances](runtime-instances-encryption.md).

## Lea y modifique los datos
<a name="runtime-instances-data-management-read-change"></a>

Su agente lee y escribe el contenido del volumen en su ruta de montaje, por lo que cambia ese contenido de la misma manera en que lo creó. En la siguiente tabla se muestra dónde encontrar las operaciones para todo lo demás.


| Para ello | Consulte | 
| --- | --- | 
| Lea o modifique el contenido del volumen desde fuera del agente |  [Ejecute los comandos de shell en las sesiones AgentCore de Runtime](runtime-execute-command.md). `InvokeAgentRuntimeCommand`ejecuta un comando de shell en la sesión en ejecución, con el mismo sistema de archivos que ve el agente. | 
| Busque las instancias y los volúmenes que respaldan sus sesiones |  [Instancias ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html) administradas por Amazon EC2. AgentCore las aprovisiona como instancias administradas, que de forma predeterminada no aparecen en las operaciones de lista ni en las vistas de la consola de Amazon EC2. Utilícelas `describe-instances --include-managed-resources` para enumerarlas o cambiar la configuración [ de visibilidad de los recursos ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html#managed-resource-visibility-settings) gestionados. | 
| Vea las rutas de montaje y la configuración de almacenamiento |  [Configuraciones del sistema de archivos para AgentCore Runtime ](runtime-filesystem-configurations.md)  | 
| Vea la configuración de su proveedor de capacidad |  `GetCapacityProvider` y `ListCapacityProviders`. Para encontrar los tiempos de ejecución de los agentes que utilizan uno, utilice`ListAgentRuntimeVersionsByCapacityProvider`. | 
| Cambie la configuración de su proveedor de capacidad | Solo la descripción puede cambiar de principio a fin`UpdateCapacityProvider`. Para cualquier otra configuración, cree un nuevo proveedor de capacidad y asocie a él los tiempos de ejecución de sus agentes. En la consola, utilice el flujo duplicado para empezar desde la configuración existente. | 
| Vea las métricas y los registros |  [La observabilidad ](runtime-observability.md) o la ** observabilidad ** y ** los registros y el seguimiento se encuentran ** en la página de detalles del tiempo de ejecución de la consola | 

## Exporta tus datos
<a name="runtime-instances-data-management-export"></a>

No existe ninguna operación de exportación para el contenido del volumen y no puede tomar una instantánea de Amazon EBS de un volumen de un proveedor de capacidad. AgentCore crea y opera estos volúmenes como recursos gestionados, por lo que las operaciones de instantáneas que utiliza en los volúmenes que crea usted mismo no están disponibles para ellos.

Para publicar el contenido del volumen, escríbalo en un destino que controle, como un bucket de Amazon S3. Tiene dos maneras de hacerlo:
+ Ejecute un comando en la sesión con`InvokeAgentRuntimeCommand`. Para obtener más información, consulte [ Ejecutar comandos de shell en sesiones AgentCore de tiempo de ejecución](runtime-execute-command.md).
+ Invoca a tu agente y haz que copie los datos o los devuelva en la respuesta.

En cualquier caso, la copia se ejecuta con la función de ejecución del agente en tiempo de ejecución, por lo que debes conceder a esa función acceso de escritura en el destino. Para obtener más información sobre la función, consulte Funciones [ de administración de acceso e ](runtime-instances-how-it-works.md#runtime-instances-permissions)AWS identidad (IAM).

**importante**  
Exporte lo que quiera conservar antes de eliminar una sesión o un proveedor de capacidad. Al eliminar cualquiera de los dos, se eliminan los volúmenes.

Para exportar la configuración de su proveedor de capacidad, llame `GetCapacityProvider` y guarde la respuesta.

## Elimine sus datos
<a name="runtime-instances-data-management-delete"></a>

La eliminación del contenido del volumen es propiedad de la sesión, no del agente individual. Detener el tiempo de ejecución de un agente en una sesión no elimina los datos ni termina la instancia.

Solo los volúmenes persistentes contienen datos durante una parada de sesión. El volumen raíz y cualquier volumen efímero desaparecen cuando la instancia termina, por lo que todo lo que el agente escriba fuera de una ruta de montaje persistente es temporal. Para obtener información sobre los tipos de volúmenes, consulta el artículo [ Encryption at rest for Runtime Instances. ](runtime-instances-encryption.md)

Los volúmenes persistentes sobreviven a todos los eventos, excepto a una eliminación explícita. En la tabla siguiente se muestra lo que les hace cada evento.


| Event | Qué detiene | ¿Qué ocurre con tus volúmenes persistentes | 
| --- | --- | --- | 
|  `StopRuntimeSession`  | El tiempo de ejecución de un agente dentro de una sesión. Los tiempos de ejecución de otros agentes de la sesión no se ven afectados. | Retenido. AgentCore mantiene el volumen adjunto a la sesión. | 
| Tiempo de inactividad | La instancia, después de que todos sus agentes hayan estado inactivos durante `idleInstanceTimeout` segundos. | Retenido. AgentCore vuelve a adjuntar el volumen cuando vuelves a invocar la sesión. | 
| Se ha alcanzado la vida útil máxima | La instancia, independientemente de la actividad, en`maxLifetime`. | Retenido. AgentCore vuelve a adjuntar el volumen cuando vuelves a invocar la sesión. | 
|  `DeleteCapacityProviderSession`  | Toda la sesión, incluidas la instancia de Amazon EC2 y la interfaz de red. | Eliminado. AgentCore elimina los volúmenes persistentes de la sesión. | 
|  `DeleteCapacityProvider`  | El proveedor de capacidad y todas sus sesiones. | Eliminado. AgentCore elimina los volúmenes de todas las sesiones que pertenecen al proveedor de capacidad. | 

Para obtener información sobre los ajustes de inactividad y de duración, consulte [ Configurar los ajustes del AgentCore ciclo de vida de Amazon Bedrock. ](runtime-lifecycle-settings.md)

Para eliminar una sesión, necesita la `runtimeSessionId` que proporcionó al invocarla. Mantenga un registro de los ID de sesión que utiliza. Si ya no los tiene, elimine el proveedor de capacidad para eliminar todas sus sesiones y sus volúmenes.

Antes de poder eliminar un proveedor de capacidad, elimine los tiempos de ejecución del agente que hacen referencia a él eliminando los tiempos de ejecución, las versiones o los puntos finales asociados. De lo contrario, la solicitud falla con un. `ValidationException`

Para obtener información sobre las operaciones y los ejemplos, consulte [ Introducción a las instancias mediante la AWS CLI o el SDK](runtime-instances-get-started-cli.md). Para obtener información sobre los pasos de la consola, consulte [ Cómo empezar a usar las instancias desde la consola](runtime-instances-get-started-console.md).