Face List Operations - Get Large Face List Face

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Haal persistent gezicht op in Large Face List door largeFaceListId en persistentedFaceId.

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces/{persistedFaceId}

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).
largeFaceListId	path	True	string	Geldig teken is een letter in kleine letters of cijfers of '-' of '_', de maximumlengte is 64. Regex-patroon: ^[a-z0-9-_]+$
persistedFaceId	path	True	string uuid	Face ID van het gezicht.

Antwoorden

Name	Type	Description
200 OK	LargeFaceListFace	Een geslaagde aanroep retourneert de doelgegevens van het gezicht (persistentedFaceId en userData).
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 Face from LargeFaceList

Voorbeeldaanvraag

HTTP

GET {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Voorbeeldrespons

Statuscode:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
  "userData": "your_user_data"
}

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.
LargeFaceListFace	Gezichtsresource voor een grote gezichtslijst.

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.

LargeFaceListFace

Gezichtsresource voor een grote gezichtslijst.

Name	Type	Description
persistedFaceId	string	Face ID van het gezicht.
userData	string	Door de gebruiker verstrekte gegevens die aan het gezicht zijn gekoppeld. De lengtelimiet is 1K.