SnapshotOperations.TakeWithHttpMessagesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザー指定のスナップショットの種類、ソース オブジェクト 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 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))パラメーター
- type
- SnapshotObjectType
スナップショットを取得するソース オブジェクトのユーザー指定型。 現在、FaceList、PersonGroup、LargeFaceList、LargePersonGroup がサポートされています。 使用できる値は、'FaceList'、'LargeFaceList'、'LargePersonGroup'、'PersonGroup' です。
- objectId
- String
スナップショットを取得するユーザー指定のソース オブジェクト ID。
スナップショットのターゲット Face サブスクリプション ID のユーザー指定配列。 スナップショットごとに、スナップショットの applyScope - Take に含まれるサブスクリプションのみが適用できます。
- userData
- String
ユーザーが任意の目的でスナップショットに関するデータを指定しました。 長さは 16 KB を超えないようにしてください。
- customHeaders
- Dictionary<String,List<String>>
要求に追加されるヘッダー。
- cancellationToken
- CancellationToken
キャンセル トークン。
戻り値
実装
例外
操作が無効な状態コードを返したときにスローされます
必須パラメーターが null の場合にスローされます
必須パラメーターが null の場合にスローされます
適用対象
Azure SDK for .NET