ISnapshotOperations.TakeWithHttpMessagesAsync Méthode

Référence

Définition

Espace de noms:: Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:: Microsoft.Azure.CognitiveServices.Vision.Face.dll

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

Source:: ISnapshotOperations.cs

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’application de l’étendue et une donnée utilisateur facultative. Les interfaces instantané permettent aux utilisateurs de sauvegarder et de restaurer leurs données faciales d’un abonnement visage à un autre, à l’intérieur d’une même région ou d’une région à l’autre. Le flux de travail 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é (selon Azure instance), afin qu’ils puissent être appliqués entre les comptes et les régions. 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 ». La prise de 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 personnes à visages multiples. Les instantanés seront automatiquement expirés et nettoyés dans les 48 heures après leur création par Capture instantanée - Prise. L’utilisateur peut supprimer le instantané à l’aide de Capture instantanée - Supprimer par lui-même à tout moment avant l’expiration. La prise de instantané pour un objet donné 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, y compris 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 reflétées sur l’instantané lors de leur prise. 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.

Quota d’abonnement de niveau gratuit : 100 opérations de prise par mois.
Quota d’abonnement de niveau S0 : 100 opérations de prise par jour.

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>>

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))

Paramètres

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 prendre instantané.

applyScope: IList<Guid>

Tableau spécifié par l’utilisateur des ID d’abonnement Visage cible pour le instantané. Pour chaque instantané, seuls les abonnements inclus dans le applyScope of Snapshot - Take peuvent l’appliquer.