View a markdown version of this page

管理您在运行时实例上的数据 - 亚马逊基岩 AgentCore
实例存储什么，存储在哪里读取和更改您的数据导出您的数据删除你的数据

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

管理您在运行时实例上的数据

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

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

有关适用于所有亚马逊 Bedrock 的分担责任模式的信息 AgentCore，请参阅亚马逊 Bedrock 中的数据保护。 AgentCore

实例存储什么，存储在哪里

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

类别 存储在哪里 生命周期由... 控制

音量内容

Amazon Elastic Block Store (Amazon EBS) 卷在您的 AWS 账户中 AgentCore 创建并挂载到您的代理中

装入音量的会话

资源配置

容量提供商和代理运行时记录，包括名称、描述、允许的实例类型、网络和存储定义

容量提供商和代理运行时间

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

读取和更改您的数据

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

要执行的操作 参见

从代理外部读取或更改音量内容

在 AgentCore 运行时会话中执行 shell 命令。InvokeAgentRuntimeCommand在正在运行的会话中运行 shell 命令，文件系统与代理看到的文件系统相同。

查找支持您的会话的实例和交易量

亚马逊 EC2 托管实例。 AgentCore 将它们配置为托管实例，默认情况下，这些实例在列表操作和您的 Amazon EC2 控制台视图中处于隐藏状态。用于列describe-instances --include-managed-resources出这些资源或更改托管资源的可见性设置。

查看装载路径和存储设置

AgentCore 运行时的文件系统配置

查看您的容量提供商配置

GetCapacityProvider 和 ListCapacityProviders 要查找使用代理运行时，请使用ListAgentRuntimeVersionsByCapacityProvider。

更改您的容量提供商配置

只有描述才能通过UpdateCapacityProvider。对于任何其他设置，请创建一个新的容量提供器并将您的代理运行时与其关联起来。在控制台中，使用重复流程从现有配置开始。

查看指标和日志

控制台中运行时详细信息页面上的可观察性或可观测性和日志与跟踪

导出您的数据

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

要输出卷内容，请将其写入您控制的目的地，例如 Amazon S3 存储桶。你有两种方法可以做到这一点：

  • 在与的会话中运行命令InvokeAgentRuntimeCommand。有关更多信息，请参见在 AgentCore 运行时会话中执行 shell 命令。

  • 调用您的代理并让它复制数据，或在响应中返回数据。

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

重要

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

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

删除你的数据

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

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

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

事件 它能阻止什么 您的永久卷会怎样

StopRuntimeSession

一个会话中的一个代理运行时间。会话中的其他代理运行时不受影响。

已保留。 AgentCore 使音量与会话保持连接。

空闲超时

该实例在其所有代理都处于空闲状态idleInstanceTimeout几秒钟之后。

已保留。 AgentCore 当您再次调用会话时，会重新连接该音量。

已达到最大使用寿命

无论活动如何，该实例均位于maxLifetime。

已保留。 AgentCore 当您再次调用会话时，会重新连接该音量。

DeleteCapacityProviderSession

整个会话，包括其 Amazon EC2 实例和网络接口。

已删除。 AgentCore 删除会话的永久音量。

DeleteCapacityProvider

容量提供者及其所有会话。

已删除。 AgentCore 删除属于容量提供商的每个会话的卷。

有关空闲和生命周期设置的信息，请参阅配置 Amazon Bedrock AgentCore 生命周期设置。

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

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

有关操作和示例的信息，请参阅使用 AWS CLI 或 SDK 开始使用实例。有关控制台步骤的信息，请参阅使用控制台开始使用实例。