LargeFaceListOperations.CreateWithHttpMessagesAsync メソッド

定義

名前空間:

Microsoft.Azure.CognitiveServices.Vision.Face

アセンブリ:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

パッケージ:

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

ソース:

LargeFaceListOperations.cs

ユーザー指定の largeFaceListId、name、および省略可能な userData と recognitionModel を使用して空の大規模顔リストを作成します。 <br /> Large face list は、顔のリストであり、最大 1,000,000 の顔で、 Face - Find Similar で使用されます。 <br /> 作成後、ユーザーは LargeFaceList Face - Add を使用して顔をインポートし、 LargeFaceList - Train を使用して Face - FindSimilar の準備を整える必要があります。 LargeFaceList - Delete が呼び出されるまで、顔はサーバーに格納されます。 <br /> Find Similar は、有名人のような顔の検索、似た顔のフィルター処理、または光の方法での顔識別などのシナリオに使用されます。 ただし、実際に個人を識別する場合は、PersonGroupLargePersonGroup / と Face - Identify を使用してください。 <Br/>

• Free レベルのサブスクリプション クォータ: 64 個の大きな顔リスト。
• S0 レベルのサブスクリプション クォータ: 1,000,000 個の大きな顔リスト。 <この大きな顔リストに関連付けるには、br /> 'recognitionModel' を指定する必要があります。 'recognitionModel' の既定値は 'recognition_01' です。最新のモデルが必要な場合は、このパラメーターで必要なモデルを明示的に指定してください。 既存の大きな顔リストに追加された新しい顔は、コレクションに既に関連付けられている認識モデルを使用します。 大きな顔リスト内の既存の顔の特徴を、別のバージョンの認識モデルによって抽出された特徴に更新することはできません。

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse> CreateWithHttpMessagesAsync (string largeFaceListId, string name, string userData = default, string recognitionModel = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateWithHttpMessagesAsync : string * string * string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse>
override this.CreateWithHttpMessagesAsync : string * string * string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse>

Public Function CreateWithHttpMessagesAsync (largeFaceListId As String, name As String, Optional userData As String = Nothing, Optional recognitionModel As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse)

パラメーター

largeFaceListId

String

特定の大きな顔リストを参照する ID。

name

String

ユーザー定義の名前。最大長は 128 です。

userData

String

ユーザーが指定したデータ。 長さは 16 KB を超えないようにしてください。

recognitionModel

String

使用できる値は、'recognition_01'、'recognition_02' です。

customHeaders

Dictionary<String,List<String>>

要求に追加されるヘッダー。

cancellationToken

CancellationToken

キャンセル トークン。

戻り値

Task<HttpOperationResponse>

実装

CreateWithHttpMessagesAsync(String, String, String, String, Dictionary<String,List<String>>, CancellationToken)

例外

APIErrorException

操作が無効な状態コードを返したときにスローされます

ValidationException

必須パラメーターが null の場合にスローされます

ArgumentNullException

必須パラメーターが null の場合にスローされます