PersonGroupOperations.CreateWithHttpMessagesAsync メソッド

定義

名前空間:

Microsoft.Azure.CognitiveServices.Vision.Face

アセンブリ:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

パッケージ:

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

ソース:

PersonGroupOperations.cs

指定された personGroupId、name、ユーザー指定の userData と recognitionModel を使用して新しい人物グループを作成します。 <br /> 人物グループは、顔画像や顔認識機能を含む、アップロードされた人物データのコンテナーです。 <br /> 作成後、 PersonGroup Person - Create を使用してグループにユーザーを追加し、 PersonGroup - Train を呼び出して、このグループを Face - Identify の準備にします。 <br />PersonGroup Person - Delete または PersonGroup -Delete が呼び出されるまで、ユーザーの顔、画像、および userData がサーバーに格納されます。 <Br/>

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

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

パラメーター

personGroupId

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