PersonGroupOperations Класс
Операции PersonGroupOperations.
Не следует создавать экземпляр этого класса напрямую, а создать экземпляр Client, который создаст его для вас и прикрепит его к атрибуту.
- Наследование
-
builtins.objectPersonGroupOperations
Конструктор
PersonGroupOperations(client, config, serializer, deserializer)
Параметры
- client
Клиент для запросов на обслуживание.
- config
Настройка клиента службы.
- serializer
Сериализатор объектной модели.
- deserializer
Десериализатор объектной модели.
Методы
create |
Создайте группу пользователей с указанными personGroupId, именем, предоставленным пользователем userData и recognitionModel.
|
delete |
Удаление существующей группы пользователей. Сохраненные признаки лиц всех пользователей в группе пользователей также будут удалены. |
get |
Получение имени группы пользователей, userData и recognitionModel. Чтобы получить сведения о пользователе в этой группе personGroup, используйте PersonGroup Person — List. |
get_training_status |
Получение состояния обучения группы пользователей (завершенных или текущих). |
list |
Перечисление personGroupId, name, userData и recognitionModel для групп пользователей.
|
train |
Постановка задачи обучения группы пользователей в очередь. Задача обучения может быть запущена не сразу. |
update |
Обновление отображаемого имени и userData существующей группы пользователей. Свойства, которые не отображаются в тексте запроса, не обновляются. |
create
Создайте группу пользователей с указанными personGroupId, именем, предоставленным пользователем userData и recognitionModel.
Группа пользователей — это контейнер отправленных данных о пользователях, включая функции распознавания лиц.
После создания используйте PersonGroup Person - Create , чтобы добавить пользователей в группу, а затем вызовите PersonGroup - Train , чтобы подготовить эту группу к распознаванию лиц - идентификации.
Образ не будет сохранен. На сервере будут храниться только извлеченные признаки лица и userData, пока не будет вызван метод PersonGroup Person — Delete или PersonGroup — Delete .
Для связи с этой группой пользователей следует указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, укажите необходимую модель в этом параметре. Новые лица, добавленные в существующую группу пользователей, будут использовать модель распознавания, уже связанную с коллекцией. Существующие функции распознавания лиц в группе пользователей нельзя обновить до функций, извлеченных другой версией модели распознавания.
Квота группы пользователей:
- Квота подписки уровня "Бесплатный": 1000 групп пользователей. Каждый из них содержит до 1000 человек.
- Квота на подписку уровня S0: 1 000 000 групп пользователей. В каждом из них содержится до 10 000 человек.
- Чтобы решить проблему с идентификацией лиц в большом масштабе, рассмотрите возможность использования LargePersonGroup.
create(person_group_id, name, user_data=None, recognition_model='recognition_01', custom_headers=None, raw=False, **operation_config)
Параметры
- user_data
- str
Данные, указанные пользователем. Длина не должна превышать 16 КБ.
- recognition_model
- str или RecognitionModel
Возможные значения: "recognition_01", "recognition_02", "recognition_03", "recognition_04".
- operation_config
Переопределения конфигурации операций.
Возвращаемое значение
None или ClientRawResponse, если raw=true
Возвращаемый тип
Исключения
delete
Удаление существующей группы пользователей. Сохраненные признаки лиц всех пользователей в группе пользователей также будут удалены.
delete(person_group_id, custom_headers=None, raw=False, **operation_config)
Параметры
- operation_config
Переопределения конфигурации операций.
Возвращаемое значение
None или ClientRawResponse, если raw=true
Возвращаемый тип
Исключения
get
Получение имени группы пользователей, userData и recognitionModel. Чтобы получить сведения о пользователе в этой группе personGroup, используйте PersonGroup Person — List.
get(person_group_id, return_recognition_model=False, custom_headers=None, raw=False, **operation_config)
Параметры
- return_recognition_model
- bool
Значение , указывающее, должна ли операция возвращать в ответ "recognitionModel".
- operation_config
Переопределения конфигурации операций.
Возвращаемое значение
PersonGroup или ClientRawResponse, если raw=true
Возвращаемый тип
Исключения
get_training_status
Получение состояния обучения группы пользователей (завершенных или текущих).
get_training_status(person_group_id, custom_headers=None, raw=False, **operation_config)
Параметры
- operation_config
Переопределения конфигурации операций.
Возвращаемое значение
TrainingStatus или ClientRawResponse, если raw=true
Возвращаемый тип
Исключения
list
Перечисление personGroupId, name, userData и recognitionModel для групп пользователей.
- Группы пользователей хранятся в алфавитном порядке personGroupId.
- Параметр start (string, необязательный) — это предоставленное пользователем значение personGroupId, возвращаемое записями с большими идентификаторами по сравнению со строками. Для параметра "start" задано пустое значение, указывающее на возврат из первого элемента.
- Параметр top (int, необязательный) указывает количество возвращаемых записей. В одном вызове можно вернуть не более 1000 записей. Чтобы получить дополнительные сведения, можно указать "start" с идентификатором последнего возвращенного элемента текущего вызова.
Например, всего 5 групп пользователей: "group1", ..., "group5".
"start=&top=" возвращает все 5 групп.
"start=&top=2" возвращает "group1", "group2".
"start=group2&top=3" возвращает "group3", "group4", "group5". .
list(start=None, top=1000, return_recognition_model=False, custom_headers=None, raw=False, **operation_config)
Параметры
- start
- str
Вывод списка групп пользователей из наименьшего значения personGroupId, превышающего значение start.
- return_recognition_model
- bool
Значение , указывающее, должна ли операция возвращать в ответ "recognitionModel".
- operation_config
Переопределения конфигурации операций.
Возвращаемое значение
list или ClientRawResponse, если raw=true
Возвращаемый тип
Исключения
train
Постановка задачи обучения группы пользователей в очередь. Задача обучения может быть запущена не сразу.
train(person_group_id, custom_headers=None, raw=False, **operation_config)
Параметры
- operation_config
Переопределения конфигурации операций.
Возвращаемое значение
None или ClientRawResponse, если raw=true
Возвращаемый тип
Исключения
update
Обновление отображаемого имени и userData существующей группы пользователей. Свойства, которые не отображаются в тексте запроса, не обновляются.
update(person_group_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)
Параметры
- name
- str
Определяемое пользователем имя, максимальная длина составляет 128.
- user_data
- str
Данные, указанные пользователем. Длина не должна превышать 16 КБ.
- operation_config
Переопределения конфигурации операций.
Возвращаемое значение
None или ClientRawResponse, если raw=true
Возвращаемый тип
Исключения
Атрибуты
models
models = <module 'azure.cognitiveservices.vision.face.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\vision\\face\\models\\__init__.py'>
Azure SDK for Python
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по