Share via


CreatePersonGroup interface

Methods

delete(RequestParameters)

Delete an existing Person Group with specified personGroupId. Persisted data in this Person Group will be deleted.

get(GetPersonGroupParameters)

Retrieve Person Group name, userData and recognitionModel. To get person information under this personGroup, use "Get Person Group Persons".

patch(UpdatePersonGroupParameters)

Update an existing Person Group's name and userData. The properties keep unchanged if they are not in request body.

put(CreatePersonGroupParameters)

A Person Group is a container holding the uploaded person data, including face recognition features.

After creation, use "Create Person Group Person" to add persons into the group, and then call "Train Person Group" to get this group ready for "Identify From Person Group".

No image will be stored. Only the person's extracted face feature(s) and userData will be stored on server until "Delete Person Group Person" or "Delete Person Group" is called.

'recognitionModel' should be specified to associate with this Person Group. The default value for 'recognitionModel' is 'recognition_01', if the latest model needed, please explicitly specify the model you need in this parameter. New faces that are added to an existing Person Group will use the recognition model that's already associated with the collection. Existing face feature(s) in a Person Group can't be updated to features extracted by another version of recognition model.

Note

    • Free-tier subscription quota: 1,000 Person Groups. Each holds up to 1,000 persons.
    • S0-tier subscription quota: 1,000,000 Person Groups. Each holds up to 10,000 persons.
    • to handle larger scale face identification problem, please consider using Large Person Group.

Method Details

delete(RequestParameters)

Delete an existing Person Group with specified personGroupId. Persisted data in this Person Group will be deleted.

function delete(options?: RequestParameters): StreamableMethod<DeletePersonGroup200Response | DeletePersonGroupDefaultResponse>

Parameters

Returns

get(GetPersonGroupParameters)

Retrieve Person Group name, userData and recognitionModel. To get person information under this personGroup, use "Get Person Group Persons".

function get(options?: GetPersonGroupParameters): StreamableMethod<GetPersonGroup200Response | GetPersonGroupDefaultResponse>

Parameters

Returns

patch(UpdatePersonGroupParameters)

Update an existing Person Group's name and userData. The properties keep unchanged if they are not in request body.

function patch(options: UpdatePersonGroupParameters): StreamableMethod<UpdatePersonGroup200Response | UpdatePersonGroupDefaultResponse>

Parameters

Returns

put(CreatePersonGroupParameters)

A Person Group is a container holding the uploaded person data, including face recognition features.

After creation, use "Create Person Group Person" to add persons into the group, and then call "Train Person Group" to get this group ready for "Identify From Person Group".

No image will be stored. Only the person's extracted face feature(s) and userData will be stored on server until "Delete Person Group Person" or "Delete Person Group" is called.

'recognitionModel' should be specified to associate with this Person Group. The default value for 'recognitionModel' is 'recognition_01', if the latest model needed, please explicitly specify the model you need in this parameter. New faces that are added to an existing Person Group will use the recognition model that's already associated with the collection. Existing face feature(s) in a Person Group can't be updated to features extracted by another version of recognition model.

Note

    • Free-tier subscription quota: 1,000 Person Groups. Each holds up to 1,000 persons.
    • S0-tier subscription quota: 1,000,000 Person Groups. Each holds up to 10,000 persons.
    • to handle larger scale face identification problem, please consider using Large Person Group.
function put(options: CreatePersonGroupParameters): StreamableMethod<CreatePersonGroup200Response | CreatePersonGroupDefaultResponse>

Parameters

Returns