你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
SnapshotOperationsExtensions 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
SnapshotOperations 的扩展方法。
public static class SnapshotOperationsExtensionstype SnapshotOperationsExtensions = classPublic Module SnapshotOperationsExtensions- 继承
-
SnapshotOperationsExtensions
方法
| ApplyAsync(ISnapshotOperations, Guid, String, SnapshotApplyMode, CancellationToken) |
提交操作以将快照应用到当前订阅。 对于每个快照，只有 Snapshot - Take 的 applyScope 中包含的订阅才能应用它。<br /> 快照接口供用户将其人脸数据从同一区域或跨区域备份和还原到另一个人脸订阅。 工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。 快照存储在每个 Azure 实例) (集中位置，以便可以跨帐户和区域应用快照。<br /> 应用快照是一种异步操作。 可以从响应标头中的“操作位置”字段获取操作 ID，该 ID 在 OperationStatus - Get 中用于跟踪应用快照的进度。 当操作状态为“成功”时，目标对象 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。<br /> 快照应用时间取决于快照对象中的人和人脸条目数。 对于多张脸的 1，000，000 人，它可能以秒为单位，或者最多 1 小时。<br /> 快照将在快照 - 拍摄创建后的 48 小时内自动过期并清理快照。 因此，目标订阅需要在创建后的 48 小时内应用快照。<br /> 应用快照不会阻止针对目标对象的任何其他操作，但不建议这样做，因为在应用快照期间无法保证正确性。 完成快照应用后，针对目标对象的所有操作都可以正常工作。 快照还包括源对象的训练结果，这意味着应用快照的目标订阅在调用 Identify/FindSimilar 之前不需要重新训练目标对象。<br /> 一个快照可以并行应用多次，而目前仅支持 CreateNew apply 模式，这意味着如果目标订阅已包含相同类型的对象且使用相同的 objectId，则应用操作将失败。 用户可以在请求正文中指定“objectId”以避免此类冲突。<Br/>
|
| DeleteAsync(ISnapshotOperations, Guid, CancellationToken) |
根据 snapshotId 删除现有快照。 快照中的所有对象数据和信息也将被删除。 只有获取快照的源订阅才能删除快照。 如果用户未使用此 API 删除快照，快照仍会在创建后的 48 小时内自动删除。 |
| GetAsync(ISnapshotOperations, Guid, CancellationToken) |
检索有关快照的信息。 只有获取快照的源订阅才能访问快照，以及快照 - 拍摄中的 applyScope 中包含的目标订阅。 |
| GetOperationStatusAsync(ISnapshotOperations, Guid, CancellationToken) |
检索采取/应用快照操作的状态。 |
| ListAsync(ISnapshotOperations, Nullable<SnapshotObjectType>, IList<Guid>, CancellationToken) |
列出包含相关信息的所有可访问快照，包括用户创建的快照，或要应用于用户的快照， (订阅 ID 包含在快照 - 拍摄) 的 applyScope 中。 |
| TakeAsync(ISnapshotOperations, SnapshotObjectType, String, IList<Guid>, String, CancellationToken) |
使用用户指定的快照类型、源对象 ID、应用范围和可选用户数据提交操作，以快照人脸列表、大型人脸列表、人员组或大型人员组。<br /> 快照接口供用户将其人脸数据从同一区域或跨区域备份和还原到另一个人脸订阅。 工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。 快照存储在每个 Azure 实例) (集中位置，以便可以跨帐户和区域应用快照。<br /> 采取快照是一个异步操作。 可以从响应标头中的“操作位置”字段获取操作 ID，该 ID 在 OperationStatus - Get 中用于跟踪创建快照的进度。 操作状态为“成功”时，快照 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。<br /> 快照花费的时间取决于源对象中的人和人脸条目数。 对于 1，000，000 张多张脸的人，它可以在几秒钟内，或者长达几个小时。<br /> 快照将在快照 - 拍摄创建后的 48 小时内自动过期并清理快照。 用户可以在过期前的任意时间使用 Snapshot - Delete 自行删除快照。<br /> 获取特定对象的快照不会阻止针对该对象的任何其他操作。 (Get/List 和 Identify/FindSimilar/Verify) 的所有只读操作都可以照常执行。 对于所有可写操作（包括添加/更新/删除源对象或其人员/人脸）和训练，它们不会被阻止，但不建议这样做，因为可写更新在获取过程中可能不会反映在快照上。 完成快照后，所有可读和可写操作都可以正常工作。 快照还将包括源对象的训练结果，这意味着应用快照的目标订阅在调用 Identify/FindSimilar 之前不需要重新训练目标对象。<Br/>
|
| UpdateAsync(ISnapshotOperations, Guid, IList<Guid>, String, CancellationToken) |
更新快照的信息。 只有获取快照的源订阅才能更新快照。 |
