Person Directories - Update Person

Szolgáltatás:

Azure AI Services

API-verzió:

2025-05-01-preview

Személy tulajdonságainak frissítése.

PATCH {endpoint}/contentunderstanding/personDirectories/{personDirectoryId}/persons/{personId}?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.
personDirectoryId	path	True	string pattern: ^[a-zA-Z0-9._-]{1,64}$	A személyjegyzék egyedi azonosítója.
personId	path	True	string pattern: ^[a-zA-Z0-9._-]{1,64}$	A személy 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
faceIds	string[]	A személyhez társított arcok listája.
tags	object	A személyhez társított címkék.

Válaszok

Name	Típus	Description
200 OK	PersonDirectoryPerson	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 Person in Person Directory

Mintakérelem

HTTP

PATCH {endpoint}/contentunderstanding/personDirectories/myDirectory/persons/4f66b612-e57d-4d17-9ef7-b951aea2cf0f?api-version=2025-05-01-preview

{
  "tags": {
    "age": null
  },
  "faceIds": [
    "6995a5ae-83fa-4c64-a8b7-23aefc6cf0fc"
  ]
}

Mintaválasz

Állapotkód:

200

{
  "personId": "4f66b612-e57d-4d17-9ef7-b951aea2cf0f",
  "tags": {
    "name": "Paul"
  },
  "faceIds": [
    "7a87f162-8dd5-4aea-8810-373e36b96b38",
    "f28b3cda-4005-44b6-8518-6fcddef108cb",
    "6995a5ae-83fa-4c64-a8b7-23aefc6cf0fc"
  ]
}

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.
PersonDirectoryPerson	Személy egy személyi címtárban.
PersonDirectoryPersonUpdate	Személy egy személyi címtá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.

PersonDirectoryPerson

Objektum

Személy egy személyi címtárban.

Name	Típus	Description
faceIds	string[]	A személyhez társított arcok listája.
personId	string pattern: ^[a-zA-Z0-9._-]{1,64}$	A személy egyedi azonosítója.
tags	object	A személyhez társított címkék.

PersonDirectoryPersonUpdate

Objektum

Személy egy személyi címtárban.

Name	Típus	Description
faceIds	string[]	A személyhez társított arcok listája.
tags	object	A személyhez társított címkék.