Partager via


SnapshotOperations.ApplyWithHttpMessagesAsync Méthode

Définition

Envoyez une opération pour appliquer une instantané à l’abonnement actuel. Pour chaque instantané, seuls les abonnements inclus dans le applyScope de Snapshot - Take peuvent l’appliquer.< br /> Les interfaces instantané permettent aux utilisateurs de sauvegarder et de restaurer leurs données faciales d’un abonnement face à un autre, dans la même région ou entre régions. Le workflow contient deux phases : l’utilisateur appelle d’abord Instantané - Prendre pour créer une copie de l’objet source et le stocker en tant que instantané, puis appelle Instantané - Appliquer pour coller le instantané à l’abonnement cible. Les instantanés sont stockés dans un emplacement centralisé (par instance Azure), afin qu’ils puissent être appliqués entre les comptes et les régions.< br /> L’application de instantané est une opération asynchrone. Un ID d’opération peut être obtenu à partir du champ « Operation-Location » dans l’en-tête de réponse, à utiliser dans OperationStatus - Get pour suivre la progression de l’application de la instantané. L’ID d’objet cible est inclus dans le champ « resourceLocation » dans OperationStatus - Obtenir la réponse lorsque l’opération status est « réussie ».< br /> La durée d’application de l’instantané dépend du nombre d’entrées de personne et de visage dans l’objet instantané. Il peut être en secondes, ou jusqu’à 1 heure pour 1 000 000 de personnes avec plusieurs visages.< br /> Les instantanés sont automatiquement expirés et nettoyés dans les 48 heures après leur création par Instantané - Prendre. L’abonnement cible doit donc appliquer le instantané dans les 48 heures depuis sa création.< br /> L’application d’un instantané ne bloque pas d’autres opérations sur l’objet cible, mais elle n’est pas recommandée, car l’exactitude ne peut pas être garantie pendant instantané l’application. Une fois instantané application terminée, toutes les opérations vers l’objet cible peuvent fonctionner normalement. L’instantané inclut également les résultats d’apprentissage de l’objet source, ce qui signifie que l’abonnement cible auquel le instantané appliqué n’a pas besoin de réentreîner l’objet cible avant d’appeler Identifier/FindSimilar.< br /> Un instantané peut être appliqué plusieurs fois en parallèle, alors qu’actuellement, seul le mode CreateNew apply est pris en charge, ce qui signifie que l’opération d’application échoue si l’abonnement cible contient déjà un objet du même type et utilise le même objectId. Les utilisateurs peuvent spécifier l'« objectId » dans le corps de la demande pour éviter de tels conflits.< Br/>

  • Quota d’abonnement de niveau gratuit : 100 opérations d’application par mois.
  • Quota d’abonnement de niveau S0 : 100 opérations d’application par jour.
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))

Paramètres

snapshotId
Guid

ID faisant référence à un instantané particulier.

objectId
String

L’utilisateur a spécifié l’ID d’objet cible à créer à partir du instantané.

mode
SnapshotApplyMode

Mode d’application d’instantané. Actuellement, seul CreateNew est pris en charge, ce qui signifie que l’opération d’application échoue si l’abonnement cible contient déjà un objet du même type et utilise le même objectId. Les utilisateurs peuvent spécifier l'« objectId » dans le corps de la demande pour éviter de tels conflits. Les valeurs possibles sont les suivantes : « CreateNew »

customHeaders
Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la requête.

cancellationToken
CancellationToken

Jeton d'annulation.

Retours

Implémente

Exceptions

Levée lorsque l’opération a retourné un code status non valide

Levée lorsqu’un paramètre requis a la valeur Null

Levée lorsqu’un paramètre requis a la valeur Null

S’applique à