你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

SnapshotOperations 类

定义

命名空间:

Microsoft.Azure.CognitiveServices.Vision.Face

程序集:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

包:

Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3

Source:

SnapshotOperations.cs

SnapshotOperations 操作。

public class SnapshotOperations : Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations, Microsoft.Rest.IServiceOperations<Microsoft.Azure.CognitiveServices.Vision.Face.FaceClient>

type SnapshotOperations = class
    interface IServiceOperations<FaceClient>
    interface ISnapshotOperations

Public Class SnapshotOperations
Implements IServiceOperations(Of FaceClient), ISnapshotOperations

继承

Object

SnapshotOperations

实现

ISnapshotOperations IServiceOperations<FaceClient>

构造函数

SnapshotOperations(FaceClient)

初始化 SnapshotOperations 类的新实例。

属性

Client

获取对 FaceClient 的引用

方法

ApplyWithHttpMessagesAsync(Guid, String, SnapshotApplyMode, Dictionary<String,List<String>>, CancellationToken)	提交操作以将快照应用到当前订阅。 对于每个快照，只有 Snapshot - Take 的 applyScope 中包含的订阅才能应用它。<br /> 快照接口供用户将其人脸数据从一个人脸订阅备份和还原到另一个人脸订阅，位于同一区域或跨区域。 工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。 快照存储在一个集中位置， (每个 Azure 实例) ，以便可以跨帐户和区域应用快照。<br /> 应用快照是一种异步操作。 可以从响应标头中的“Operation-Location”字段获取操作 ID，以便在 OperationStatus - Get 中用于跟踪应用快照的进度。 当操作状态为“成功”时，目标对象 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。<br/> 快照应用时间取决于快照对象中的个人和人脸条目数。 它可以在几秒钟内，或长达1小时，1，000，000人有多个人脸。<br /> 快照将在快照 - 拍摄创建后的 48 小时内自动过期和清理。 因此，目标订阅需要在创建后的 48 小时内应用快照。<br/> 应用快照不会阻止针对目标对象的任何其他操作，但不建议这样做，因为在应用快照期间无法保证正确性。 完成快照应用后，针对目标对象的所有操作都可以正常工作。 快照还包括源对象的训练结果，这意味着快照应用到的目标订阅不需要在调用 Identify/FindSimilar 之前重新训练目标对象。<br /> 一个快照可以并行应用多次，而目前仅支持 CreateNew 应用模式，这意味着如果目标订阅已包含同一类型的对象并使用同一 objectId，则应用操作将失败。 用户可以在请求正文中指定“objectId”以避免此类冲突。<Br/> 免费层订阅配额：每月 100 个应用操作。 S0 层订阅配额：每天 100 个应用操作。
DeleteWithHttpMessagesAsync(Guid, Dictionary<String,List<String>>, CancellationToken)	根据 snapshotId 删除现有快照。 快照中的所有对象数据和信息也将被删除。 只有获取快照的源订阅才能删除快照。 如果用户未使用此 API 删除快照，则快照仍将在创建后的 48 小时内自动删除。
GetOperationStatusWithHttpMessagesAsync(Guid, Dictionary<String,List<String>>, CancellationToken)	检索接受/应用快照操作的状态。
GetWithHttpMessagesAsync(Guid, Dictionary<String,List<String>>, CancellationToken)	检索有关快照的信息。 只有获取快照的源订阅才能访问快照，以及快照 - 拍摄中的 applyScope 中包含的目标订阅。
ListWithHttpMessagesAsync(Nullable<SnapshotObjectType>, IList<Guid>, Dictionary<String,List<String>>, CancellationToken)	列出包含相关信息的所有可访问快照，包括用户拍摄的快照，或要应用于用户的快照， (快照 - 拍摄) 的 applyScope 中包含订阅 ID。
TakeWithHttpMessagesAsync(SnapshotObjectType, String, IList<Guid>, String, Dictionary<String,List<String>>, CancellationToken)	使用用户指定的快照类型、源对象 ID、应用范围和可选用户数据提交操作，以快照人脸列表、大型人脸列表、人员组或大型人员组。<br /> 快照接口供用户将其人脸数据从一个人脸订阅备份和还原到另一个人脸订阅，位于同一区域或跨区域。 工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。 快照存储在一个集中位置， (每个 Azure 实例) ，以便可以跨帐户和区域应用快照。<br /> 获取快照是一个异步操作。 可以从响应标头中的“Operation-Location”字段获取操作 ID，用于在 OperationStatus - Get 中跟踪创建快照的进度。 当操作状态为“成功”时，快照 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。<br/> 快照拍摄时间取决于源对象中的人和人脸条目数。 对于拥有多张人脸的 1，000，000 人，它可以在几秒钟内，也可能长达几个小时。<br /> 快照将在快照 - 拍摄创建后的 48 小时内自动过期和清理。 用户可以在过期前随时使用 Snapshot - Delete 自行删除快照。<br/> 获取特定对象的快照不会阻止针对该对象的任何其他操作。 (Get/List 和 Identify/FindSimilar/Verify) 的所有只读操作都可以照常执行。 对于所有可写操作，包括添加/更新/删除源对象或其人员/人脸和训练，它们不会被阻止，但不建议这样做，因为可写更新在获取期间可能不会反映在快照上。 完成快照后，所有可读和可写操作都可以正常工作。 快照还将包括源对象的训练结果，这意味着快照应用到的目标订阅不需要在调用 Identify/FindSimilar 之前重新训练目标对象。<Br/> 免费层订阅配额：每月 100 个执行操作。 S0 层订阅配额：每天执行 100 个操作。
UpdateWithHttpMessagesAsync(Guid, IList<Guid>, String, Dictionary<String,List<String>>, CancellationToken)	更新快照的信息。 只有获取快照的源订阅才能更新快照。

扩展方法

ApplyAsync(ISnapshotOperations, Guid, String, SnapshotApplyMode, CancellationToken)	提交操作以将快照应用到当前订阅。 对于每个快照，只有 Snapshot - Take 的 applyScope 中包含的订阅才能应用它。<br /> 快照接口供用户将其人脸数据从一个人脸订阅备份和还原到另一个人脸订阅，位于同一区域或跨区域。 工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。 快照存储在一个集中位置， (每个 Azure 实例) ，以便可以跨帐户和区域应用快照。<br /> 应用快照是一种异步操作。 可以从响应标头中的“Operation-Location”字段获取操作 ID，以便在 OperationStatus - Get 中用于跟踪应用快照的进度。 当操作状态为“成功”时，目标对象 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。<br/> 快照应用时间取决于快照对象中的个人和人脸条目数。 它可以在几秒钟内，或长达1小时，1，000，000人有多个人脸。<br /> 快照将在快照 - 拍摄创建后的 48 小时内自动过期和清理。 因此，目标订阅需要在创建后的 48 小时内应用快照。<br/> 应用快照不会阻止针对目标对象的任何其他操作，但不建议这样做，因为在应用快照期间无法保证正确性。 完成快照应用后，针对目标对象的所有操作都可以正常工作。 快照还包括源对象的训练结果，这意味着快照应用到的目标订阅不需要在调用 Identify/FindSimilar 之前重新训练目标对象。<br /> 一个快照可以并行应用多次，而目前仅支持 CreateNew 应用模式，这意味着如果目标订阅已包含同一类型的对象并使用同一 objectId，则应用操作将失败。 用户可以在请求正文中指定“objectId”以避免此类冲突。<Br/> 免费层订阅配额：每月 100 个应用操作。 S0 层订阅配额：每天 100 个应用操作。
DeleteAsync(ISnapshotOperations, Guid, CancellationToken)	根据 snapshotId 删除现有快照。 快照中的所有对象数据和信息也将被删除。 只有获取快照的源订阅才能删除快照。 如果用户未使用此 API 删除快照，则快照仍将在创建后的 48 小时内自动删除。
GetAsync(ISnapshotOperations, Guid, CancellationToken)	检索有关快照的信息。 只有获取快照的源订阅才能访问快照，以及快照 - 拍摄中的 applyScope 中包含的目标订阅。
GetOperationStatusAsync(ISnapshotOperations, Guid, CancellationToken)	检索接受/应用快照操作的状态。
ListAsync(ISnapshotOperations, Nullable<SnapshotObjectType>, IList<Guid>, CancellationToken)	列出包含相关信息的所有可访问快照，包括用户拍摄的快照，或要应用于用户的快照， (快照 - 拍摄) 的 applyScope 中包含订阅 ID。
TakeAsync(ISnapshotOperations, SnapshotObjectType, String, IList<Guid>, String, CancellationToken)	使用用户指定的快照类型、源对象 ID、应用范围和可选用户数据提交操作，以快照人脸列表、大型人脸列表、人员组或大型人员组。<br /> 快照接口供用户将其人脸数据从一个人脸订阅备份和还原到另一个人脸订阅，位于同一区域或跨区域。 工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。 快照存储在一个集中位置， (每个 Azure 实例) ，以便可以跨帐户和区域应用快照。<br /> 获取快照是一个异步操作。 可以从响应标头中的“Operation-Location”字段获取操作 ID，用于在 OperationStatus - Get 中跟踪创建快照的进度。 当操作状态为“成功”时，快照 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。<br/> 快照拍摄时间取决于源对象中的人和人脸条目数。 对于拥有多张人脸的 1，000，000 人，它可以在几秒钟内，也可能长达几个小时。<br /> 快照将在快照 - 拍摄创建后的 48 小时内自动过期和清理。 用户可以在过期前随时使用 Snapshot - Delete 自行删除快照。<br/> 获取特定对象的快照不会阻止针对该对象的任何其他操作。 (Get/List 和 Identify/FindSimilar/Verify) 的所有只读操作都可以照常执行。 对于所有可写操作，包括添加/更新/删除源对象或其人员/人脸和训练，它们不会被阻止，但不建议这样做，因为可写更新在获取期间可能不会反映在快照上。 完成快照后，所有可读和可写操作都可以正常工作。 快照还将包括源对象的训练结果，这意味着快照应用到的目标订阅不需要在调用 Identify/FindSimilar 之前重新训练目标对象。<Br/> 免费层订阅配额：每月 100 个执行操作。 S0 层订阅配额：每天执行 100 个操作。
UpdateAsync(ISnapshotOperations, Guid, IList<Guid>, String, CancellationToken)	更新快照的信息。 只有获取快照的源订阅才能更新快照。