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

使用快照管理应用程序备份

快照是 Apache Flink 保存点的 Managed Service for Apache Flink 实现。快照是用户或服务触发、创建和管理的应用程序状态备份。有关 Apache Flink 指标的更多信息，请参阅 Apache Flink 文档中的保存点。通过使用快照，您可以从特定的应用程序状态快照中重新启动应用程序。

在 Managed Service for Apache Flink 中，您可以使用以下 API 操作管理快照：

有关每个应用程序的快照数限制，请参阅Managed Service for Apache Flink 与 Studio 笔记本配额。如果应用程序达到快照限制，则手动创建快照将失败并出现 LimitExceededException。

Managed Service for Apache Flink永远不会删除快照。您必须使用 DeleteApplicationSnapshot 操作手动删除快照。

要在启动应用程序时加载已保存的应用程序状态快照，请使用 StartApplication 或 UpdateApplication 操作的 ApplicationRestoreConfiguration 参数。

管理自动快照创建

如果在应用程序true中设置SnapshotsEnabled为，则 Apache Flink 托管服务将在应用程序更新、缩放或停止时自动创建和使用快照，以提供精确一次的处理语义。 ApplicationSnapshotConfiguration

自动创建的快照具有以下特性：

从包含不兼容状态数据的快照中还原

由于快照包含有关操作符的信息，因此，如果从自上一应用程序版本以来发生变化的操作符的快照中还原状态数据，则可能会出现意外的结果。如果尝试从与当前操作符不对应的快照中还原状态数据，应用程序将会发生故障。发生故障的应用程序将停滞在 STOPPING 或 UPDATING 状态。

要允许应用程序从包含不兼容状态数据的快照中恢复，FlinkRunConfiguration请true使用UpdateApplication操作将的AllowNonRestoredState参数设置为。

从过时的快照中还原应用程序时，您将会看到以下行为：

如果您需要恢复与现有 savepoint 数据不兼容的应用程序，我们建议您将操作的ApplicationRestoreType参数设置为，从而跳过从快照还原的StartApplication操作。SKIP_RESTORE_FROM_SNAPSHOT

有关 Apache Flink 如何处理不兼容状态数据的更多信息，请参阅 Apache Flink 文档中的状态架构演变。

查看快照 API 示例

本节包含将快照与应用程序一起使用的 API 操作的示例请求。有关如何将 JSON 文件用于 API 操作输入的信息，请参阅 Managed Service for Apache Flink API 示例代码。

为应用程序启用快照

UpdateApplication 操作的以下示例请求为应用程序启用快照：

{
   "ApplicationName": "MyApplication",
   "CurrentApplicationVersionId": 1,
   "ApplicationConfigurationUpdate": { 
      "ApplicationSnapshotConfigurationUpdate": { 
         "SnapshotsEnabledUpdate": "true"
       }
    }
}

创建快照

CreateApplicationSnapshot 操作的以下示例请求创建当前应用程序状态的快照：

{
   "ApplicationName": "MyApplication",
   "SnapshotName": "MyCustomSnapshot"
}

列出应用程序的快照

ListApplicationSnapshots 操作的以下示例请求列出当前应用程序状态的前 50 个快照：

{
   "ApplicationName": "MyApplication",
   "Limit": 50
}

列出应用程序快照的详细信息

DescribeApplicationSnapshot 操作的以下示例请求列出特定应用程序快照的详细信息：

{
   "ApplicationName": "MyApplication",
   "SnapshotName": "MyCustomSnapshot"
}

删除快照

DeleteApplicationSnapshot 操作的以下示例请求删除以前保存的快照。您可以使用以下任一方法来获取 ListApplicationSnapshots 或 DeleteApplicationSnapshot 的 SnapshotCreationTimestamp 值：

{
   "ApplicationName": "MyApplication",
   "SnapshotName": "MyCustomSnapshot",
   "SnapshotCreationTimestamp": 12345678901.0,
}

使用命名的快照重新启动应用程序

StartApplication 操作的以下示例请求使用特定快照中保存的状态启动应用程序：

{
   "ApplicationName": "MyApplication",
   "RunConfiguration": { 
      "ApplicationRestoreConfiguration": { 
         "ApplicationRestoreType": "RESTORE_FROM_CUSTOM_SNAPSHOT",
         "SnapshotName": "MyCustomSnapshot"
      }
   }
}

使用最近的快照重新启动应用程序

StartApplication 操作的以下示例请求使用最近的快照启动应用程序：

{
   "ApplicationName": "MyApplication",
   "RunConfiguration": { 
      "ApplicationRestoreConfiguration": { 
         "ApplicationRestoreType": "RESTORE_FROM_LATEST_SNAPSHOT"
      }
   }
}

不使用快照重新启动应用程序

StartApplication 操作的以下示例请求启动应用程序而不加载应用程序状态，即使具有快照也是如此：

{
   "ApplicationName": "MyApplication",
   "RunConfiguration": { 
      "ApplicationRestoreConfiguration": { 
         "ApplicationRestoreType": "SKIP_RESTORE_FROM_SNAPSHOT"
      }
   }
}