Person Group Operations - Create Large Person Group Person

Служба:

Azure AI Services

Версия API:

v1.1-preview.1

Create нового пользователя в указанной группе больших пользователей. Чтобы добавить лицо для этого пользователя, вызовите команду "Add Large Person Group Person Face".

Примечание

• • Квота подписки уровня "Бесплатный":
    • 1000 человек во всех крупных Группы.
  • Квота подписки уровня S0:
    • 1 000 000 человек на группу больших людей.
    • 1 000 000 Группы большого человека.
    • 1 000 000 000 человек во всех крупных Группы.

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons

Параметры URI

Имя	В	Обязательно	Тип	Описание
apiVersion	path	True	string	Версия API
endpoint	path	True	string uri	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя_ресурса}.cognitiveservices.azure.com).
largePersonGroupId	path	True	string	Идентификатор контейнера. Шаблон регулярного выражения: ^[a-z0-9-_]+$

Текст запроса

Имя	Обязательно	Тип	Описание
name	True	string	Имя, определенное пользователем, максимальная длина — 128.
userData		string	Необязательные пользовательские данные. Длина не должна превышать 16 КБ.

Ответы

Имя	Тип	Описание
200 OK	CreatePersonResult	При успешном вызове возвращается новый созданный идентификатор personId.
Other Status Codes	FaceErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Безопасность

Ocp-Apim-Subscription-Key

Секретный ключ для подписки Azure AI Face.

Тип: apiKey
В: header

AADToken

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://api.example.com/oauth2/authorize
URL-адрес токена: https://api.example.com/oauth2/token

Области

Имя	Описание
https://cognitiveservices.azure.com/.default

Примеры

Create Person in LargePersonGroup

Образец запроса

HTTP

POST {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id/persons

{
  "name": "your_large_person_group_person_name",
  "userData": "your_user_data"
}

Пример ответа

Код состояния:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1"
}

Определения

Имя	Описание
CreatePersonResult	Ответ создания пользователя.
FaceError	Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ответ, содержащий сведения об ошибке.

CreatePersonResult

Ответ создания пользователя.

Имя	Тип	Описание
personId	string	Идентификатор пользователя.

FaceError

Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.

Имя	Тип	Описание
code	string	Один из определяемого сервером набора кодов ошибок.
message	string	Удобочитаемое представление ошибки.

FaceErrorResponse

Ответ, содержащий сведения об ошибке.

Имя	Тип	Описание
error	FaceError	Объект error.