Freigeben über

SnapshotOperations.TakeWithHttpMessagesAsync Methode

  • Referenz

Definition

Namespace:
Microsoft.Azure.CognitiveServices.Vision.Face
Assembly:
Microsoft.Azure.CognitiveServices.Vision.Face.dll
Paket:
Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3
Quelle:
SnapshotOperations.cs

Übermitteln Sie einen Vorgang, um eine Momentaufnahme der Gesichtsliste, einer großen Gesichtsliste, einer Personengruppe oder einer großen Personengruppe mit vom Benutzer angegebenen Momentaufnahme Typ, Quellobjekt-ID, Anwendungsbereich und optionalen Benutzerdaten zu übernehmen.< br /> Die Momentaufnahme Schnittstellen dienen dazu, dass Benutzer ihre Gesichtsdaten von einem Gesichtsabonnement in einem anderen, innerhalb derselben Region oder regionenübergreifend sichern und wiederherstellen können. Der Workflow enthält zwei Phasen. Der Benutzer ruft zunächst Momentaufnahme – Erstellen auf, um eine Kopie des Quellobjekts zu erstellen und es als Momentaufnahme zu speichern, und ruft dann Momentaufnahme – Anwenden auf, um den Momentaufnahme in das Zielabonnement einzufügen. Die Momentaufnahmen werden an einem zentralen Speicherort (pro Azure instance) gespeichert, sodass sie konten- und regionsübergreifend angewendet werden können.< br /> Nehmen Momentaufnahme ist ein asynchroner Vorgang. Eine Vorgangs-ID kann aus dem Feld "Operation-Location" im Antwortheader abgerufen werden, das in OperationStatus – Get zum Nachverfolgen des Fortschritts beim Erstellen des Momentaufnahme verwendet werden soll. Die Momentaufnahme-ID wird im Feld "resourceLocation" in OperationStatus – Antwort abrufen enthalten, wenn der Vorgang status "erfolgreich" ist.< br /> Momentaufnahmezeit hängt von der Anzahl der Personen- und Gesichtseinträge im Quellobjekt ab. Es kann in Sekunden oder bis zu mehreren Stunden für 1.000.000 Personen mit mehreren Gesichtern sein.< br /> Snapshots werden automatisch abgelaufen und bereinigt in 48 Stunden, nachdem sie von Snapshot - Take erstellt wurden. Der Benutzer kann die Momentaufnahme mithilfe von Momentaufnahme – Selbst löschen jederzeit vor Ablauf löschen.< br /> Das Momentaufnahme für ein bestimmtes Objekt blockiert keine anderen Vorgänge für das Objekt. Alle schreibgeschützten Vorgänge (Get/List und Identify/FindSimilar/Verify) können wie gewohnt ausgeführt werden. Für alle beschreibbaren Vorgänge, einschließlich Hinzufügen/Aktualisieren/Löschen des Quellobjekts oder seiner Personen/Gesichter und Train, werden sie nicht blockiert, aber nicht empfohlen, da beschreibbare Updates während der Aufnahme möglicherweise nicht im Momentaufnahme reflektiert werden. Nachdem Momentaufnahme Einnahme abgeschlossen ist, können alle lesbaren und beschreibbaren Vorgänge wie gewohnt funktionieren. Die Momentaufnahme enthält auch die Trainingsergebnisse des Quellobjekts. Das bedeutet, dass das Zielabonnement, auf das das Momentaufnahme angewendet wird, das Zielobjekt vor dem Aufrufen von Identify/FindSimilar nicht erneut trainiert werden muss.< Br/>

  • Abonnementkontingent des kostenlosen Tarifs: 100 Take-Vorgänge pro Monat.
  • S0-Tarif-Abonnementkontingent: 100 Vorgänge pro Tag.
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))

Parameter

type
SnapshotObjectType

Vom Benutzer angegebene Typ für das Quellobjekt, aus dem Momentaufnahme. Derzeit werden FaceList, PersonGroup, LargeFaceList und LargePersonGroup unterstützt. Mögliche Werte: "FaceList", "LargeFaceList", "LargePersonGroup", "PersonGroup"

objectId
String

Vom Benutzer angegebene Quellobjekt-ID, aus der Momentaufnahme werden soll.

applyScope
IList<Guid>

Vom Benutzer angegebenes Array von Ziel-Gesichtserkennungsabonnements für die Momentaufnahme. Für jede Momentaufnahme können nur Abonnements angewendet werden, die im applyScope of Snapshot – Take enthalten sind.

userData
String

Vom Benutzer angegebene Daten über die Momentaufnahme für jeden Zweck. Die Länge sollte 16 KB nicht überschreiten.

customHeaders
Dictionary<String,List<String>>

Header, die der Anforderung hinzugefügt werden.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<HttpOperationHeaderResponse<SnapshotTakeHeaders>>

Implementiert

TakeWithHttpMessagesAsync(SnapshotObjectType, String, IList<Guid>, String, Dictionary<String,List<String>>, CancellationToken)

Ausnahmen

APIErrorException

Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.

ValidationException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

ArgumentNullException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

Gilt für: