SnapshotOperationsExtensions.TakeAsync Methode

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:

SnapshotOperationsExtensions.cs

Übermitteln Sie einen Vorgang, um eine Momentaufnahme der Gesichtsliste, einer großen Gesichtsliste, einer Personengruppe oder einer großen Personengruppe mit benutzerspezifischem Momentaufnahme Typ, Quellobjekt-ID, Gültigkeitsbereich und optionalen Benutzerdaten zu erstellen.< br /> Die Momentaufnahme Schnittstellen dienen dazu, dass Benutzer ihre Gesichtsdaten aus einem Gesichtsabonnement in einem anderen, innerhalb derselben Region oder regionsübergreifend sichern und wiederherstellen können. Der Workflow enthält zwei Phasen. Der Benutzer ruft zunächst Snapshot – Take auf, um eine Kopie des Quellobjekts zu erstellen und es als Momentaufnahme zu speichern, und ruft dann Momentaufnahme – Anwenden auf, um die Momentaufnahme in das Zielabonnement einzufügen. Die Momentaufnahmen werden an einem zentralen Speicherort (gemäß 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 der Momentaufnahme verwendet werden soll. Die Momentaufnahme-ID wird im Feld "resourceLocation" unter OperationStatus – Abrufen der Antwort angezeigt, wenn der Vorgang status "erfolgreich" ist.< br /> Die 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 in 48 Stunden bereinigt, nachdem sie von Snapshot – Take erstellt wurden. Der Benutzer kann die Momentaufnahme mithilfe von Momentaufnahme – Löschen selbst jederzeit vor Ablauf löschen.< br /> Wenn sie Momentaufnahme für ein bestimmtes Objekt übernehmen, werden keine anderen Vorgänge für das Objekt blockiert. Alle schreibgeschützten Vorgänge (Get/List und Identify/FindSimilar/Verify) können wie gewohnt ausgeführt werden. Für alle schreibbaren Vorgänge, einschließlich Hinzufügen/Aktualisieren/Löschen des Quellobjekts oder seiner Personen/Gesichter und Trainieren, werden sie nicht blockiert, aber nicht empfohlen, da beschreibbare Updates während der Aufnahme möglicherweise nicht auf dem Momentaufnahme widerzuspiegeln sind. Nachdem Momentaufnahme Einnahme abgeschlossen ist, können alle lesbaren und schreibbaren Vorgänge wie gewohnt funktionieren. Die Momentaufnahme enthält auch die Trainingsergebnisse des Quellobjekts. Dies bedeutet, dass das Zielabonnement, auf das Momentaufnahme angewendet wurde, das Zielobjekt vor dem Aufruf von Identify/FindSimilar nicht erneut trainiert werden muss.< Br/>

• Free-Tarif-Abonnementkontingent: 100 Take-Vorgänge pro Monat.
• S0-Tarif-Abonnementkontingent: 100 Vorgänge pro Tag.

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)

Parameter

operations

ISnapshotOperations

Die Vorgangsgruppe für diese Erweiterungsmethode.

type

SnapshotObjectType

Vom Benutzer angegebener 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, von der Momentaufnahme.

applyScope

IList<Guid>

Vom Benutzer angegebenes Array von Zielabonnement-IDs 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.

cancellationToken

CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<SnapshotTakeHeaders>