SnapshotOperationsExtensions.TakeAsync メソッド

定義

ユーザー指定のスナップショットの種類、ソース オブジェクト ID、適用スコープ、およびオプションのユーザー データを使用して、顔リスト、大きな顔リスト、人物グループ、または大きな人物グループのスナップショットを取得する操作を送信します。<br /> スナップショット インターフェイスは、ユーザーが顔のデータをバックアップし、同じリージョン内またはリージョン間で、ある顔サブスクリプションから別の顔のサブスクリプションに復元するためのインターフェイスです。 ワークフローには 2 つのフェーズが含まれています。ユーザーは最初に Snapshot - Take を呼び出してソース オブジェクトのコピーを作成し、それをスナップショットとして格納し、Snapshot - Apply を呼び出してターゲット サブスクリプションにスナップショットを貼り付けます。 スナップショットは一元化された場所 (Azure インスタンスごと) に格納されるため、クロス アカウントとリージョンに適用できます。<br /> taking スナップショットは非同期操作です。 操作 ID は、応答ヘッダーの "Operation-Location" フィールドから取得でき、OperationStatus - Get で使用して、スナップショットの作成の進行状況を追跡できます。 スナップショット ID は、OperationStatus - 操作の状態が "成功" の場合に応答を取得するの "resourceLocation" フィールドに含まれます。<br /> Snapshot の時間は、ソース オブジェクト内の人物と顔のエントリの数によって異なります。 数秒で、または複数の顔を持つ 1,000,000 人の場合は最大数時間です。<br /> Snapshots は、スナップショット - Take によって作成された後、48 時間以内に自動的に期限切れになり、クリーンアップされます。 ユーザーは、有効期限の前にいつでもスナップショット - 削除を使用してスナップショットを削除できます。<br /> 特定のオブジェクトに対してスナップショットを取得しても、オブジェクトに対する他の操作はブロックされません。 すべての読み取り専用操作 (Get/List および Identify/FindSimilar/Verify) は、通常どおりに実行できます。 ソース オブジェクトまたはその人物/顔の追加/更新/削除、トレーニングなど、すべての書き込み可能な操作ではブロックされませんが、書き込み可能な更新プログラムが実行中にスナップショットに反映されない可能性があるため、推奨されません。 スナップショットの取得が完了すると、すべての読み取り可能な操作と書き込み可能な操作を通常どおりに動作させることができます。 スナップショットには、ソース オブジェクトのトレーニング結果も含まれます。つまり、スナップショット適用先のターゲット サブスクリプションは、Identify/FindSimilar を呼び出す前にターゲット オブジェクトを再トレーニングする必要はありません。<Br/>

  • Free レベルのサブスクリプション クォータ: 1 か月あたり 100 回の操作を受け取ります。
  • S0 レベルのサブスクリプション クォータ: 1 日あたり 100 回の操作を受け取ります。
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)

パラメーター

operations
ISnapshotOperations

この拡張メソッドの操作グループ。

type
SnapshotObjectType

スナップショットを取得するソース オブジェクトのユーザー指定型。 現在、FaceList、PersonGroup、LargeFaceList、LargePersonGroup がサポートされています。 使用できる値は、'FaceList'、'LargeFaceList'、'LargePersonGroup'、'PersonGroup' です。

objectId
String

スナップショットを取得するユーザー指定のソース オブジェクト ID。

applyScope
IList<Guid>

スナップショットのターゲット Face サブスクリプション ID のユーザー指定配列。 スナップショットごとに、スナップショットの applyScope - Take に含まれるサブスクリプションのみが適用できます。

userData
String

ユーザーが任意の目的でスナップショットに関するデータを指定しました。 長さは 16 KB を超えないようにしてください。

cancellationToken
CancellationToken

キャンセル トークン。

戻り値

適用対象