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

# HealthOmics 執行的執行保留模式
<a name="run-retention"></a>

執行完成後，HealthOmics 會將執行中繼資料封存至 CloudWatch。根據預設，除非您變更 CloudWatch 保留政策，否則 CloudWatch 會無限期保留執行資料。執行輸出也會儲存在 Amazon S3 中，直到您將其刪除為止。

其中一個可調整的 [HealthOmics 服務配額](service-quotas.md) 是區域中**maximum number of runs (active and inactive)**的 。HealthOmics 會將執行中繼資料保留最多此數量的執行，以供主控台和 API 操作 (ListRuns 和 GetRun) 使用。當您開始執行時，您可以設定執行保留模式參數，以指出執行的保留行為。參數支援值 REMOVE 和 RETAIN。

對於將保留模式設定為 REMOVE 的新執行，如果 HealthOmics 嘗試在儲存執行數量上限之後新增執行，則會自動移除已設定 REMOVE 模式之最舊執行的中繼資料。此移除不會影響存放在 CloudWatch 或 Amazon S3 中的資料。

RETAIN 是執行保留模式的預設值。對於在此模式下執行的 ，系統不會刪除執行中繼資料。如果 HealthOmics 達到執行次數上限，全部都設定為 RETAIN，您將無法建立其他執行，直到您刪除一些執行為止。

如果您打算同時執行超過執行數量上限的批次，請務必將執行保留模式設定為 REMOVE。否則，當 HealthOmics 嘗試在最大值之後開始下一次執行時，批次會失敗。

使用 REMOVE 保留模式的其他考量事項：
+ 當您第一次開始使用 REMOVE 做為保留模式時，請考慮刪除一或多個使用 RETAIN 模式的執行，以釋放插槽。當您開始額外的 REMOVE 執行時，自動移除會接管，因此有足夠的插槽可供新執行使用。
+ 如果您想要重新執行封存的執行 （或一組執行），請使用 HealthOmics 重新執行 CLI 工具。如需如何使用此工具的詳細資訊和範例，請參閱 [ HealthOmics 工具 GitHub 儲存庫中的 Omics 重新執行](https://github.com/awslabs/amazon-omics-tools?tab=readme-ov-file#omics-rerun)。 HealthOmics GitHub 
+ 我們建議您為每個執行設定唯一的名稱。HealthOmics 移除執行後，您就無法使用主控台或 API 來尋找執行名稱或執行 ID。不過，您可以使用 CloudWatch 來搜尋執行名稱，因此請使用唯一名稱來取得最佳的搜尋結果。
+ 您可以使用 CloudWatch **start-query**命令來取得封存執行的相關資訊。如果執行名稱不是唯一的，查詢可能會傳回多個資訊清單。開始時間和結束時間參數會定義搜尋的時間範圍。

  ```
  aws logs start-query  \
      --log-group-name "/aws/omics/WorkflowLog" \
      --query-string 'filter @logStream like "manifest" and @message like "myRunName"' \
      --end-time <END-EPOCH-TIME> --start-time <START-EPOCH-TIME>
  ```

  **start-query** 命令會傳回查詢 ID。將查詢 ID 傳遞至 **get-query-results**命令會傳回查詢結果。

  ```
  aws logs get-query-results --query-id QueryId
  ```