你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

IPersonGroupOperations 接口

定义

命名空间:

Microsoft.Azure.CognitiveServices.Vision.Face

程序集:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

包:

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

PersonGroupOperations 操作。

public interface IPersonGroupOperations

type IPersonGroupOperations = interface

Public Interface IPersonGroupOperations

派生

Microsoft.Azure.CognitiveServices.Vision.Face.PersonGroupOperations

方法

CreateWithHttpMessagesAsync(String, String, String, String, Dictionary<String,List<String>>, CancellationToken)	使用指定的 personGroupId、名称以及用户提供的 userData 和 recognitionModel 创建新的人员组。 <br/> 人员组是上传的人员数据的容器，包括人脸图像和人脸识别功能。 <br /> 创建后，使用 PersonGroup Person - Create 将人员添加到组中，然后调用 PersonGroup - Train 使此组准备好进行 人脸 - 识别。 <br /> 人员的人脸、图像和 userData 将存储在服务器上，直到调用 PersonGroup Person - Delete 或 PersonGroup - Delete 。 <Br/> 免费层订阅配额：1，000 人组。 每人最多容纳1，000人。 S0 层订阅配额：1，000，000 人组。 每人最多容纳10，000人。 若要处理更大规模的人脸识别问题，请考虑使用 LargePersonGroup。 <应指定 br/> “recognitionModel”以与此人员组相关联。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请在此参数中显式指定所需的模型。 添加到现有人员组的新人脸将使用已与集合关联的识别模型。 无法将人员组中的现有人脸特征更新为由其他版本的识别模型提取的特征。
DeleteWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)	删除现有人员组。 人员组中所有人员的持久人脸特征也将被删除。
GetTrainingStatusWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)	检索已完成或正在进行的) (人员组的训练状态。
GetWithHttpMessagesAsync(String, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)	检索人员组名称，userData 和 recognitionModel。 若要获取此 personGroup 下的人员信息，请使用 [PersonGroup Person List] (/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395241) 。
ListWithHttpMessagesAsync(String, Nullable<Int32>, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)	列出人员组的 personGroupId、name、userData 和 recognitionModel。<Br/> 人员组按 personGroupId 的字母顺序存储。 “start”参数 (字符串，可选) 是用户提供的 personGroupId 值，通过字符串比较返回的条目具有较大的 ID。 “start”设置为空以指示从第一项返回。 “top”参数 (int，可选) 指定要返回的条目数。 在一次调用中可以返回最大 1000 个条目。 若要提取更多内容，可以使用当前调用的最后一个重新调整条目的 ID 指定“start”。 <br /> 例如，总共 5 个人组：“group1”， ...， “group5”。 <br /> “start=&top=” 将返回所有 5 个组。 <br /> “start=&top=2” 将返回“group1”、“group2”。 <br /> “start=group2&top=3” 将返回“group3”、“group4”、“group5”。
TrainWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)	将人员组训练任务排入队列，训练任务可能不会立即启动。
UpdateWithHttpMessagesAsync(String, String, String, Dictionary<String,List<String>>, CancellationToken)	更新现有人员组的显示名称和 userData。 不会更新请求正文中未显示的属性。

扩展方法

CreateAsync(IPersonGroupOperations, String, String, String, String, CancellationToken)	使用指定的 personGroupId、名称以及用户提供的 userData 和 recognitionModel 创建新的人员组。 <br/> 人员组是上传的人员数据的容器，包括人脸图像和人脸识别功能。 <br /> 创建后，使用 PersonGroup Person - Create 将人员添加到组中，然后调用 PersonGroup - Train 使此组准备好进行 人脸 - 识别。 <br /> 人员的人脸、图像和 userData 将存储在服务器上，直到调用 PersonGroup Person - Delete 或 PersonGroup - Delete 。 <Br/> 免费层订阅配额：1，000 人组。 每人最多容纳1，000人。 S0 层订阅配额：1，000，000 人组。 每人最多容纳10，000人。 若要处理更大规模的人脸识别问题，请考虑使用 LargePersonGroup。 <应指定 br/> “recognitionModel”以与此人员组相关联。 “recognitionModel”的默认值为“recognition_01”，如果需要最新的模型，请在此参数中显式指定所需的模型。 添加到现有人员组的新人脸将使用已与集合关联的识别模型。 无法将人员组中的现有人脸特征更新为由其他版本的识别模型提取的特征。
DeleteAsync(IPersonGroupOperations, String, CancellationToken)	删除现有人员组。 人员组中所有人员的持久人脸特征也将被删除。
GetAsync(IPersonGroupOperations, String, Nullable<Boolean>, CancellationToken)	检索人员组名称，userData 和 recognitionModel。 若要获取此 personGroup 下的人员信息，请使用 PersonGroup 人员 - 列表。
GetTrainingStatusAsync(IPersonGroupOperations, String, CancellationToken)	检索已完成或正在进行的) (人员组的训练状态。
ListAsync(IPersonGroupOperations, String, Nullable<Int32>, Nullable<Boolean>, CancellationToken)	列出人员组的 personGroupId、name、userData 和 recognitionModel。<Br/> 人员组按 personGroupId 的字母顺序存储。 “start”参数 (字符串，可选) 是用户提供的 personGroupId 值，通过字符串比较返回的条目具有较大的 ID。 “start”设置为空以指示从第一项返回。 “top”参数 (int，可选) 指定要返回的条目数。 在一次调用中可以返回最大 1000 个条目。 若要提取更多内容，可以使用当前调用的最后一个重新调整条目的 ID 指定“start”。 <br /> 例如，总共 5 个人组：“group1”， ...， “group5”。 <br /> “start=&top=” 将返回所有 5 个组。 <br /> “start=&top=2” 将返回“group1”、“group2”。 <br /> “start=group2&top=3” 将返回“group3”、“group4”、“group5”。
TrainAsync(IPersonGroupOperations, String, CancellationToken)	将人员组训练任务排入队列，训练任务可能不会立即启动。
UpdateAsync(IPersonGroupOperations, String, String, String, CancellationToken)	更新现有人员组的显示名称和 userData。 不会更新请求正文中未显示的属性。