SnapshotOperationsExtensions.TakeAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Soumettez une opération pour prendre une instantané de liste de visages, de grandes listes de visages, de groupes de personnes ou de grands groupes de personnes, avec le type de instantané spécifié par l’utilisateur, l’ID d’objet source, l’étendue d’application et les données utilisateur facultatives.< 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 /> Prendre 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 la création du instantané. L’ID de instantané est inclus dans le champ « resourceLocation » dans OperationStatus - Obtenir la réponse lorsque l’opération status est « réussie ».< Br /> Capture instantanée prenant du temps dépend du nombre d’entrées de personne et de visage dans l’objet source. Il peut s’agir de quelques secondes ou de plusieurs heures pour 1 000 000 de personnes à 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’utilisateur peut supprimer le instantané à l’aide de l’instantané - Supprimer par lui-même à tout moment avant l’expiration.< br /> La prise de instantané pour un certain objet ne bloque pas d’autres opérations sur l’objet. Toutes les opérations en lecture seule (Get/List et Identifier/FindSimilar/Verify) peuvent être effectuées comme d’habitude. Pour toutes les opérations accessibles en écriture, notamment Ajouter/Mettre à jour/Supprimer l’objet source ou ses personnes/visages et Entraîner, elles ne sont pas bloquées, mais non recommandées, car les mises à jour accessibles en écriture peuvent ne pas être répercutées sur le instantané lors de son exécution. Une fois instantané effectuée, toutes les opérations lisibles et accessibles en écriture 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éentraîner l’objet cible avant d’appeler Identifier/FindSimilar.< Br/>
- Quota d’abonnement de niveau gratuit : 100 opérations par mois.
- Quota d’abonnement de niveau S0 : 100 opérations par jour.
public static System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders> TakeAsync (this Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations operations, Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType type, string objectId, System.Collections.Generic.IList<Guid> applyScope, string userData = default, System.Threading.CancellationToken cancellationToken = default);
static member TakeAsync : Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>
<Extension()>
Public Function TakeAsync (operations As ISnapshotOperations, type As SnapshotObjectType, objectId As String, applyScope As IList(Of Guid), Optional userData As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SnapshotTakeHeaders)
Paramètres
- operations
- ISnapshotOperations
Groupe d’opérations pour cette méthode d’extension.
- type
- SnapshotObjectType
Type spécifié par l’utilisateur pour l’objet source à partir duquel prendre instantané. Actuellement, FaceList, PersonGroup, LargeFaceList et LargePersonGroup sont pris en charge. Les valeurs possibles sont les suivantes : « FaceList », « LargeFaceList », « LargePersonGroup », « PersonGroup »
- objectId
- String
ID d’objet source spécifié par l’utilisateur à partir duquel instantané.
Tableau spécifié par l’utilisateur d’ID d’abonnement Visage cible pour le instantané. Pour chaque instantané, seuls les abonnements inclus dans le applyScope d’instantané - Take peuvent l’appliquer.
- userData
- String
L’utilisateur a spécifié des données sur le instantané à n’importe quelle fin. La longueur ne doit pas dépasser 16 Ko.
- cancellationToken
- CancellationToken
Jeton d'annulation.
Retours
S’applique à
Azure SDK for .NET