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

SnapshotOperations.TakeWithHttpMessagesAsync 方法

参考

定义

命名空间:: Microsoft.Azure.CognitiveServices.Vision.Face

程序集:: Microsoft.Azure.CognitiveServices.Vision.Face.dll

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

Source:: SnapshotOperations.cs

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

使用用户指定的快照类型、源对象 ID、应用范围和可选用户数据提交操作，以快照人脸列表、大型人脸列表、人员组或大型人员组。 快照接口供用户将其人脸数据从同一区域或跨区域备份和还原到另一个人脸订阅。工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。快照存储在每个 Azure 实例) (集中位置，以便可以跨帐户和区域应用快照。 采取快照是一个异步操作。可以从响应标头中的“操作位置”字段获取操作 ID，该 ID 在 OperationStatus - Get 中用于跟踪创建快照的进度。操作状态为“成功”时，快照 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。 快照花费的时间取决于源对象中的人和人脸条目数。对于 1，000，000 张多张脸的人，它可以在几秒钟内，或者长达几个小时。 快照将在快照 - 拍摄创建后的 48 小时内自动过期并清理快照。用户可以在过期前的任意时间使用 Snapshot - Delete 自行删除快照。 获取特定对象的快照不会阻止针对该对象的任何其他操作。 (Get/List 和 Identify/FindSimilar/Verify) 的所有只读操作都可以照常执行。对于所有可写操作（包括添加/更新/删除源对象或其人员/人脸）和训练，它们不会被阻止，但不建议这样做，因为可写更新在获取过程中可能不会反映在快照上。完成快照后，所有可读和可写操作都可以正常工作。快照还将包括源对象的训练结果，这意味着应用快照的目标订阅在调用 Identify/FindSimilar 之前不需要重新训练目标对象。

免费层订阅配额：每月 100 个执行操作。
S0 层订阅配额：每天 100 个执行操作。

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>> TakeWithHttpMessagesAsync (Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType type, string objectId, System.Collections.Generic.IList<Guid> applyScope, string userData = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member TakeWithHttpMessagesAsync : Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>>
override this.TakeWithHttpMessagesAsync : Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>>

Public Function TakeWithHttpMessagesAsync (type As SnapshotObjectType, objectId As String, applyScope As IList(Of Guid), Optional userData As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationHeaderResponse(Of SnapshotTakeHeaders))