Person Group Operations - Create Large Person Group Person

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Maak een nieuwe persoon in een opgegeven large person-groep. Als u een gezicht aan deze persoon wilt toevoegen, belt u 'Gezicht van grote persoon groep toevoegen'.

Notitie

• • Quotum voor gratis abonnementen:
    • 1.000 personen in alle Grote Personen Groepen.
  • Quotum voor S0-laagabonnement:
    • 1.000.000 personen per Large Person Group.
    • 1.000.000 groepen grote personen.
    • 1.000.000.000 personen in alle grote personengroepen.

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

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	Id van de container. Regex-patroon: ^[a-z0-9-_]+$

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	CreatePersonResult	Een geslaagde aanroep retourneert een nieuwe personId die is gemaakt.
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 Person in LargePersonGroup

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
CreatePersonResult	Antwoord van een persoon maken.
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.

CreatePersonResult

Antwoord van een persoon maken.

Name	Type	Description
personId	string	Persoons-id van de persoon.

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.