本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 管理您在运行时实例上的数据
<a name="runtime-instances-data-management"></a>

当您在**实例**计算类型上托管代理时，您的数据将存储在您自己 AWS 账户中的 Amazon EBS 卷上。

本主题介绍 AgentCore 存储在那里的内容，以及如何读取、更改、删除和删除它。

有关适用于所有亚马逊 Bedrock 的分担责任模式的信息 AgentCore，请参阅亚马逊 Bedrock 中的[数据保护。 AgentCore ](data-protection.md)

## 实例存储什么，存储在哪里
<a name="runtime-instances-data-management-what"></a>

实例存储两类数据。下表显示了每个类别的存在位置以及控制其生命周期的资源。


| 类别 | 存储在哪里 | 生命周期由... 控制 | 
| --- | --- | --- | 
| 音量内容 | Amazon Elastic Block Store (Amazon EBS) 卷在您的 AWS 账户中 AgentCore 创建并挂载到您的代理中 | 装入音量的会话 | 
| 资源配置 | 容量提供商和代理运行时记录，包括名称、描述、允许的实例类型、网络和存储定义 | 容量提供商和代理运行时间 | 

卷内容是您的代理在其挂载路径上读取和写入的任何内容。亚马逊 EBS 卷是在您的账户中创建的，因此您现有的账户控制适用于它们。有关如何加密卷的信息，请参阅运行时实例的静[态加密](runtime-instances-encryption.md)。

## 读取和更改您的数据
<a name="runtime-instances-data-management-read-change"></a>

您的代理在其装载路径上读取和写入卷内容，因此它会按照创建该内容的方式更改该内容。下表显示了在哪里可以找到其他所有操作的操作。


| 要执行的操作 | 参见 | 
| --- | --- | 
| 从代理外部读取或更改音量内容 |  [在 AgentCore 运行时会话中执行 shell 命令](runtime-execute-command.md)。`InvokeAgentRuntimeCommand`在正在运行的会话中运行 shell 命令，文件系统与代理看到的文件系统相同。 | 
| 查找支持您的会话的实例和交易量 |  [亚马逊 EC2 托管实例](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html)。 AgentCore 将它们配置为托管实例，默认情况下，这些实例在列表操作和您的 Amazon EC2 控制台视图中处于隐藏状态。用于列`describe-instances --include-managed-resources`出这些资源或更改[托管资源的可见性设置](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html#managed-resource-visibility-settings)。 | 
| 查看装载路径和存储设置 |  [ AgentCore 运行时的文件系统配置 ](runtime-filesystem-configurations.md)  | 
| 查看您的容量提供商配置 |  `GetCapacityProvider` 和 `ListCapacityProviders` 要查找使用代理运行时，请使用`ListAgentRuntimeVersionsByCapacityProvider`。 | 
| 更改您的容量提供商配置 | 只有描述才能通过`UpdateCapacityProvider`。对于任何其他设置，请创建一个新的容量提供器并将您的代理运行时与其关联起来。在控制台中，使用重复流程从现有配置开始。 | 
| 查看指标和日志 |  [控制](runtime-observability.md)台中运行时详细信息页面**上的**可观察性或可观测**性和**日志与跟踪 | 

## 导出您的数据
<a name="runtime-instances-data-management-export"></a>

没有卷内容的导出操作，也无法拍摄容量提供商卷的 Amazon EBS 快照。 AgentCore 将这些卷作为托管资源创建和运行，因此您在自己创建的卷上使用的快照操作不适用于他们。

要输出卷内容，请将其写入您控制的目的地，例如 Amazon S3 存储桶。你有两种方法可以做到这一点：
+ 在与的会话中运行命令`InvokeAgentRuntimeCommand`。有关更多信息，请参见在 AgentCore 运行时会话中[执行 shell 命令](runtime-execute-command.md)。
+ 调用您的代理并让它复制数据，或在响应中返回数据。

无论哪种方式，副本都使用代理运行时执行角色运行，因此请授予该角色对目标的写入权限。有关该角色的更多信息，请参阅[AWS 身份和访问管理 (IAM) 角色](runtime-instances-how-it-works.md#runtime-instances-permissions)。

**重要**  
在删除会话或容量提供者之前，导出要保留的内容。删除任一卷都会删除卷。

要导出容量提供商配置，请调用`GetCapacityProvider`并保存响应。

## 删除你的数据
<a name="runtime-instances-data-management-delete"></a>

删除卷内容是会话的属性，而不是单个代理的属性。在会话中停止一个代理运行时不会删除数据，也不会终止实例。

只有永久卷才能在会话停止期间保存数据。当实例终止时，根卷和任何临时卷都会消失，因此您的代理在永久挂载路径之外写入的任何内容都是临时的。有关卷类型的信息，请参阅运行时实例的静[态加密](runtime-instances-encryption.md)。

除显式删除外，永久卷在每次事件中都能存活。下表显示了每个事件对他们的影响。


| 事件 | 它能阻止什么 | 您的永久卷会怎样 | 
| --- | --- | --- | 
|  `StopRuntimeSession`  | 一个会话中的一个代理运行时间。会话中的其他代理运行时不受影响。 | 已保留。 AgentCore 使音量与会话保持连接。 | 
| 空闲超时 | 该实例在其所有代理都处于空闲状态`idleInstanceTimeout`几秒钟之后。 | 已保留。 AgentCore 当您再次调用会话时，会重新连接该音量。 | 
| 已达到最大使用寿命 | 无论活动如何，该实例均位于`maxLifetime`。 | 已保留。 AgentCore 当您再次调用会话时，会重新连接该音量。 | 
|  `DeleteCapacityProviderSession`  | 整个会话，包括其 Amazon EC2 实例和网络接口。 | 已删除。 AgentCore 删除会话的永久音量。 | 
|  `DeleteCapacityProvider`  | 容量提供者及其所有会话。 | 已删除。 AgentCore 删除属于容量提供商的每个会话的卷。 | 

有关空闲和生命周期设置的信息，请参阅[配置 Amazon Bedrock AgentCore 生命周期设置](runtime-lifecycle-settings.md)。

要删除会话，您需要在调用`runtimeSessionId`该会话时提供的会话。记录您使用的会话 ID。如果您不再拥有它们，请删除容量提供商以删除其所有会话及其卷。

在删除容量提供器之前，先通过删除关联的运行时、版本或终端节点来移除引用该容量提供器的代理运行时。否则，请求将失败并显示`ValidationException`。

有关操作和示例的信息，请参阅使用 AWS CLI 或 SDK [ 开始使用实例](runtime-instances-get-started-cli.md)。有关控制台步骤的信息，请参阅使用控制台[开始使用实例](runtime-instances-get-started-console.md)。