FaceListOperations.CreateWithHttpMessagesAsync メソッド

定義

名前空間:

Microsoft.Azure.CognitiveServices.Vision.Face

アセンブリ:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

パッケージ:

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

ソース:

FaceListOperations.cs

ユーザーが指定した faceListId、name、および省略可能な userData と recognitionModel を使用して空の顔リストを作成します。 1 つのサブスクリプションで最大 64 個の顔リストを使用できます。 <br /> Face リストは、顔のリストであり、最大 1,000 個の顔で、 Face - Find Similar で使用されます。 <br /> 作成後、ユーザーは FaceList - Add Face を使用して顔をインポートする必要があります。 FaceList - Delete が呼び出されるまで、顔はサーバーに格納されます。 <br /> Find Similar は、有名人のような顔の検索、似た顔のフィルター処理、または光の方法での顔識別などのシナリオに使用されます。 ただし、実際に個人を識別する場合は、PersonGroupLargePersonGroup / と Face - Identify を使用してください。 <br /> 顔番号が大きい場合は LargeFaceList を検討してください。 最大 1,000,000 人の顔をサポートできます。 この顔リストに関連付けるには、'recognitionModel' を指定する必要があります。 'recognitionModel' の既定値は 'recognition_01' です。最新のモデルが必要な場合は、このパラメーターで必要なモデルを明示的に指定してください。 既存の顔リストに追加された新しい顔は、コレクションに既に関連付けられている認識モデルを使用します。 顔リスト内の既存の顔の特徴を、別のバージョンの認識モデルによって抽出された特徴に更新することはできません。

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse> CreateWithHttpMessagesAsync (string faceListId, 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 (faceListId 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)

パラメーター

faceListId

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 の場合にスローされます