Person Group Operations - Create Person Group Person

Service:

Azure AI Services

API Version:

v1.1-preview.1

Létrehozás egy adott személycsoportban lévő új személyt. Ha arcot szeretne hozzáadni ehhez a személyhez, hívja fel a "Személycsoportos személy arc hozzáadása" parancsot.

Megjegyzés

• • Ingyenes szintű előfizetési kvóta:
    • 1000 személy minden Személy Csoportok.
  • S0 szintű előfizetési kvóta:
    • Személycsoportonként 10 000 személy.
    • 1 000 000 személy Csoportok.
    • 100.000.000 személy minden Személy Csoportok.

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons

URI-paraméterek

Name	In	Kötelező	Típus	Description
apiVersion	path	True	string	API-verzió
endpoint	path	True	string uri	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com).
personGroupId	path	True	string	A tároló azonosítója. Regex pattern: ^[a-z0-9-_]+$

Kérelem törzse

Name	Kötelező	Típus	Description
name	True	string	Felhasználó által definiált név, a maximális hossz 128.
userData		string	Nem kötelező, felhasználó által megadott adatok. A hossz nem haladhatja meg a 16 000-t.

Válaszok

Name	Típus	Description
200 OK	CreatePersonResult	A sikeres hívás egy létrehozott új personId azonosítót ad vissza.
Other Status Codes	FaceErrorResponse	Váratlan hibaválasz. Headers x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Az Azure AI Face-előfizetés titkos kulcsa.

Type: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2-folyamat

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Példák

Create Person in PersonGroup

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons

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

Sample Response

Status code:

200

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

Definíciók

Name	Description
CreatePersonResult	A létrehozási személy válasza.
FaceError	A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	A hiba részleteit tartalmazó válasz.

CreatePersonResult

A létrehozási személy válasza.

Name	Típus	Description
personId	string	A személy személyazonosítója.

FaceError

A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
message	string	A hiba emberi olvasásra alkalmas ábrázolása.

FaceErrorResponse

A hiba részleteit tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.