次の方法で共有


IPersonGroupOperations.CreateWithHttpMessagesAsync メソッド

定義

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

適用対象