Person Directory Operations - Create Dynamic Person Group

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Hiermee maakt u een nieuwe dynamische persoonsgroep met de opgegeven dynamicPersonGroupId, naam en door de gebruiker verstrekte userData.
Een dynamische persoonsgroep is een container die verwijst naar persoonsdirectory 'Create Person'. Gebruik na het maken de personenlijst 'Dynamische personengroep bijwerken' om personen toe te voegen aan/te verwijderen uit de groep Dynamische personen.

Dynamische persoonsgroep en gebruikersgegevens worden opgeslagen op de server totdat de persoonsdirectory Dynamische persoonsgroep verwijderen wordt aangeroepen. Gebruik 'Identificeren van dynamische persoonsgroep' met de parameter dynamicPersonGroupId om te identificeren tegen personen.

Er wordt geen installatiekopieën opgeslagen. Alleen de uitgepakte gezichtsfuncties van de persoon en userData worden op de server opgeslagen totdat persoonsmap 'Persoon verwijderen' of 'Gezicht van persoon verwijderen' wordt aangeroepen.

'recognitionModel' hoeft niet te worden opgegeven met dynamische persoonsgroepen. Dynamische personengroepen zijn verwijzingen naar persoonsdirectory 'Persoon maken' en werken daarom met de meeste 'recognitionModels'. De faceId's die tijdens 'Identificeren' worden verstrekt, bepalen het gebruikte recognitionModel.

PUT {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
dynamicPersonGroupId	path	True	string	Id van de dynamische persoonsgroep. Regex-patroon: ^[a-z0-9-_]+$
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).

Aanvraagbody

Name	Vereist	Type	Description
name	True	string	Door de gebruiker gedefinieerde naam, de maximale lengte is 128.
userData		string	Optionele door de gebruiker gedefinieerde gegevens. De lengte mag niet groter zijn dan 16.000.

Antwoorden

Name	Type	Description
200 OK		De aanvraag is voltooid.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

Name	Description
https://cognitiveservices.azure.com/.default

Voorbeelden

Create DynamicPersonGroup

Voorbeeldaanvraag

HTTP

PUT {endpoint}/face/v1.2-preview.1/dynamicpersongroups/your_dynamic_person_group_id

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

Voorbeeldrespons

Statuscode:

200

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.