Person Directories - Update Face

Szolgáltatás:

Azure AI Services

API-verzió:

2025-05-01-preview

Frissítse az arctulajdonságokat, például módosítsa a személyhez való társítást.

PATCH {endpoint}/contentunderstanding/personDirectories/{personDirectoryId}/faces/{faceId}?api-version=2025-05-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	Tartalomértés szolgáltatásvégpont.
faceId	path	True	string pattern: ^[a-zA-Z0-9._-]{1,64}$	Az arc egyedi azonosítója.
personDirectoryId	path	True	string pattern: ^[a-zA-Z0-9._-]{1,64}$	A személyjegyzék egyedi azonosítója.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Media Types: "application/merge-patch+json"

Name	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A kérés átlátszatlan, globálisan egyedi, ügyfél által generált sztringazonosítója.

Kérelem törzse

Media Types: "application/merge-patch+json"

Name	Típus	Description
personId	string	Az archoz kapcsolódó személy, ha van ilyen.

Válaszok

Name	Típus	Description
200 OK	PersonDirectoryFace	A kérés sikeres volt. Fejlécek x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/token

Hatókörök

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

Példák

Update Face in Person Directory

Mintakérelem

HTTP

PATCH {endpoint}/contentunderstanding/personDirectories/myDirectory/faces/7a87f162-8dd5-4aea-8810-373e36b96b38?api-version=2025-05-01-preview

{
  "personId": "19323b77-2012-487b-b131-09c318dc23df"
}

Mintaválasz

Állapotkód:

200

{
  "faceId": "7a87f162-8dd5-4aea-8810-373e36b96b38",
  "personId": "19323b77-2012-487b-b131-09c318dc23df",
  "boundingBox": {
    "left": 33,
    "top": 73,
    "width": 262,
    "height": 324
  },
  "imageReferenceId": "face1.jpg"
}

Definíciók

Name	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Microsoft One API irányelvei szerint – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
BoundingBox	Határolókeret egy képen.
PersonDirectoryFace	Arc egy személyi könyvtárban.
PersonDirectoryFaceUpdate	Arc egy személyi könyvtárban.

Azure.Core.Foundations.Error

Objektum

A hibaobjektum.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Objektum

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Objektum

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Microsoft One API irányelvei szerint – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

BoundingBox

Objektum

Határolókeret egy képen.

Name	Típus	Description
height	integer (int32)	A határolókeret magassága.
left	integer (int32)	A határolókeret bal oldali koordinátája.
top	integer (int32)	A határolókeret felső koordinátája.
width	integer (int32)	A határolókeret szélessége.

PersonDirectoryFace

Objektum

Arc egy személyi könyvtárban.

Name	Típus	Description
boundingBox	BoundingBox	A forrásképen lévő arc határolókerete.
faceId	string pattern: ^[a-zA-Z0-9._-]{1,64}$	Az arc egyedi azonosítója.
imageReferenceId	string	A felhasználó által megadott azonosító a forrásképhez.
personId	string	Az archoz kapcsolódó személy, ha van ilyen.

PersonDirectoryFaceUpdate

Objektum

Arc egy személyi könyvtárban.

Name	Típus	Description
personId	string	Az archoz kapcsolódó személy, ha van ilyen.