Freigeben über

Face List Operations - Update Large Face List Face

  • Referenz
Dienst:
Azure AI Services
API-Version:
v1.2-preview.1

Aktualisieren Sie das UserData-Feld eines angegebenen Gesichts in einer großen Gesichtsliste anhand der persistedFaceId.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
apiVersion
 path True

string

API-Version
endpoint
 path True

string

uri

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId
 path True

string

Gültiges Zeichen ist Buchstabe in Kleinbuchstaben oder Ziffern oder "-" oder "_", die maximale Länge beträgt 64.

RegEx-Muster: ^[a-z0-9-_]+$
persistedFaceId
 path True

string

uuid

Gesichts-ID des Gesichts.

Anforderungstext

Name Typ Beschreibung
userData

string

Vom Benutzer bereitgestellte Daten, die an das Gesicht angefügt sind. Die Längenbeschränkung beträgt 1 KB.

Antworten

Name Typ Beschreibung
200 OK

Die Anforderung ist erfolgreich.
Other Status Codes

FaceErrorResponse

Unerwartete Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiche

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

Beispiele

Update Face in LargeFaceList

Beispielanforderung

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

{
  "userData": "your_user_data"
}

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

Name Typ Beschreibung
code

string

Eine serverdefinierte Gruppe von Fehlercodes.
message

string

Eine lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name Typ Beschreibung
error

FaceError

Das Fehlerobjekt.