本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在執行期執行個體上管理您的資料
<a name="runtime-instances-data-management"></a>

當您在**執行個體**運算類型上託管代理程式時，您的資料會存放在您自己的 AWS 帳戶中的 Amazon EBS 磁碟區中。

本主題說明 AgentCore 在該處存放哪些內容，以及您如何閱讀、變更、取得和刪除它。

如需有關適用於所有 Amazon Bedrock AgentCore 的共同責任模型的資訊，請參閱 [Amazon Bedrock AgentCore 中的資料保護](data-protection.md)。

## 執行個體存放的內容，以及存放位置
<a name="runtime-instances-data-management-what"></a>

執行個體存放兩個類別的資料。下表顯示每個類別的所在位置，以及哪個資源控制其生命週期。


| Category | 存放位置 | 生命週期由 控制 | 
| --- | --- | --- | 
| 磁碟區內容 | AgentCore 在 AWS 帳戶中建立並掛載到代理程式的 Amazon Elastic Block Store (Amazon EBS) 磁碟區 | 掛載磁碟區的工作階段 | 
| 資源組態 | 容量提供者和代理程式執行期記錄，包括名稱、描述、允許的執行個體類型、聯網和儲存定義 | 容量提供者和代理程式執行時間 | 

磁碟區內容是代理程式在其掛載路徑上讀取和寫入的任何內容。Amazon EBS 磁碟區會在您的帳戶中建立，因此您現有的帳戶控制項會套用到這些磁碟區。如需有關磁碟區如何加密的資訊，請參閱[執行期執行個體的靜態加密](runtime-instances-encryption.md)。

## 讀取和變更您的資料
<a name="runtime-instances-data-management-read-change"></a>

您的代理程式會在掛載路徑上讀取和寫入磁碟區內容，因此變更該內容的方式與其建立內容的方式相同。下表顯示在何處尋找其他項目的操作。


| 若要執行此作業 | 請參閱 | 
| --- | --- | 
| 從代理程式外部讀取或變更磁碟區內容 |  [在 AgentCore 執行期工作階段中執行 shell 命令](runtime-execute-command.md)。 在執行中的工作階段中`InvokeAgentRuntimeCommand`執行 shell 命令，其檔案系統與代理程式看到的相同。 | 
| 尋找可備份工作階段的執行個體和磁碟區 |  [Amazon 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 Identity and Access Management (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`提供的 。保留您使用的工作階段 IDs的記錄。如果您不再擁有它們，請刪除容量提供者，以刪除其所有工作階段及其磁碟區。

刪除容量提供者之前，請先刪除相關聯的執行時間、版本或端點，以移除參考它的代理程式執行時間。否則，請求會因 而失敗`ValidationException`。

如需 操作和範例的相關資訊，請參閱[使用 CLI 或 SDK AWS 開始使用執行個體](runtime-instances-get-started-cli.md)。如需主控台步驟的相關資訊，請參閱[使用主控台開始使用執行個體](runtime-instances-get-started-console.md)。