Face List Operations - Update Large Face List Face

Tjänst:

Azure AI Services

API-version:

v1.1-preview.1

Uppdatera ett angivet ansiktes userData-fält i en stor ansiktslista med dess persistedFaceId.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
apiVersion	path	True	string	API-version
endpoint	path	True	string uri	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Giltigt tecken är bokstav i gemener eller siffror eller "-" eller "_", maxlängden är 64. Reguljärt uttrycksmönster: ^[a-z0-9-_]+$
persistedFaceId	path	True	string uuid	Ansikts-ID för ansiktet.

Begärandetext

Name	Typ	Description
userData	string	Användardefinierade data som är kopplade till ansiktet. Längdgränsen är 1K.

Svar

Name	Typ	Description
200 OK		Begäran har slutförts.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Ansiktsprenumeration på Azure AI.

Typ: apiKey
I: header

AADToken

Azure Active Directory OAuth2-flödet

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

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

Exempel

Update Face in LargeFaceList

Exempelbegäran

HTTP

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

{
  "userData": "your_user_data"
}

Exempelsvar

Statuskod:

200

Definitioner

Name	Description
FaceError	Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.

FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
message	string	En mänsklig läsbar representation av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.