Person Group Operations - Get Large Person Group

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Haal de gegevens van een Large Person Group op, inclusief de naam, userData en recognitionModel. Deze API retourneert alleen informatie over grote personengroep, gebruik in plaats daarvan 'Groep personen van grote personen ophalen' om persoonsgegevens op te halen onder de groep Grote personen.

GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

Met optionele parameters:

GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}?returnRecognitionModel={returnRecognitionModel}

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string (uri)	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
largePersonGroupId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	Id van de container.
returnRecognitionModel	query		boolean	Retourneer 'recognitionModel' of niet. De standaardwaarde is onwaar.

Antwoorden

Name	Type	Description
200 OK	LargePersonGroup	Een geslaagde aanroep retourneert de informatie van de Large Person Group.
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

Get LargePersonGroup

Voorbeeldaanvraag

HTTP

GET {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id?returnRecognitionModel=True

Voorbeeldrespons

Statuscode:

200

{
  "name": "your_large_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01",
  "largePersonGroupId": "your_large_person_group_id"
}

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.
LargePersonGroup	De container van de geüploade persoonsgegevens, inclusief gezichtsherkenningsfunctie en maximaal 1.000.000 personen.
RecognitionModel	Het herkenningsmodel voor het gezicht.

FaceError

Object

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

Object

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

LargePersonGroup

Object

De container van de geüploade persoonsgegevens, inclusief gezichtsherkenningsfunctie en maximaal 1.000.000 personen.

Name	Type	Description
largePersonGroupId	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	Id van de container.
name	string minLength: 1 maxLength: 128	Door de gebruiker gedefinieerde naam, de maximale lengte is 128.
recognitionModel	RecognitionModel	Naam van het herkenningsmodel. Het herkenningsmodel wordt gebruikt wanneer de gezichtsfuncties worden geëxtraheerd en gekoppeld aan gedetecteerde faceIds.
userData	string maxLength: 16384	Optionele door de gebruiker gedefinieerde gegevens. De lengte mag niet groter zijn dan 16.000.

RecognitionModel

Inventarisatie

Het herkenningsmodel voor het gezicht.

Waarde	Description
recognition_01	Het standaardherkenningsmodel voor 'Detecteren'. Al deze faceIds die vóór 2019 maart zijn gemaakt, worden gekoppeld aan dit herkenningsmodel.
recognition_02	Het herkenningsmodel is uitgebracht in maart 2019.
recognition_03	Het herkenningsmodel is uitgebracht in 2020.
recognition_04	Het herkenningsmodel is uitgebracht in 2021 februari. Het is raadzaam om dit herkenningsmodel te gebruiken voor betere nauwkeurigheid van herkenning.