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

SnapshotOperations.ApplyWithHttpMessagesAsync 方法

参考

定义

命名空间:: 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 不作任何明示或暗示的担保。

提交操作以将快照应用到当前订阅。对于每个快照，只有 Snapshot - Take 的 applyScope 中包含的订阅才能应用它。 快照接口供用户将其人脸数据从同一区域或跨区域备份和还原到另一个人脸订阅。工作流包含两个阶段：用户首先调用 Snapshot - Take 来创建源对象的副本并将其存储为快照，然后调用 Snapshot - Apply 将快照粘贴到目标订阅。快照存储在每个 Azure 实例) (集中位置，以便可以跨帐户和区域应用快照。 应用快照是一种异步操作。可以从响应标头中的“操作位置”字段获取操作 ID，该 ID 在 OperationStatus - Get 中用于跟踪应用快照的进度。当操作状态为“成功”时，目标对象 ID 将包含在 OperationStatus - 获取响应的“resourceLocation”字段中。 快照应用时间取决于快照对象中的人和人脸条目数。对于多张脸的 1，000，000 人，它可能以秒为单位，或者最多 1 小时。 快照将在快照 - 拍摄创建后的 48 小时内自动过期并清理快照。因此，目标订阅需要在创建后的 48 小时内应用快照。 应用快照不会阻止针对目标对象的任何其他操作，但不建议这样做，因为在应用快照期间无法保证正确性。完成快照应用后，针对目标对象的所有操作都可以正常工作。快照还包括源对象的训练结果，这意味着应用快照的目标订阅在调用 Identify/FindSimilar 之前不需要重新训练目标对象。 一个快照可以并行应用多次，而目前仅支持 CreateNew apply 模式，这意味着如果目标订阅已包含相同类型的对象且使用相同的 objectId，则应用操作将失败。用户可以在请求正文中指定“objectId”以避免此类冲突。

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

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyHeaders>> ApplyWithHttpMessagesAsync (Guid snapshotId, string objectId, Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode mode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ApplyWithHttpMessagesAsync : Guid * string * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode * 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.SnapshotApplyHeaders>>
override this.ApplyWithHttpMessagesAsync : Guid * string * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode * 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.SnapshotApplyHeaders>>

Public Function ApplyWithHttpMessagesAsync (snapshotId As Guid, objectId As String, Optional mode As SnapshotApplyMode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationHeaderResponse(Of SnapshotApplyHeaders))