IPersonGroupOperations.CreateWithHttpMessagesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された 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>
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
キャンセル トークン。
戻り値
例外
操作が無効な状態コードを返したときにスローされます
必須パラメーターが null の場合にスローされます
適用対象
Azure SDK for .NET