Bagikan melalui


Person Group Operations - Update Large Person Group Person

Perbarui nama atau userData seseorang.

PATCH {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons/{personId}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
apiVersion
path True

string

Versi API

endpoint
path True

string

uri

Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://{resource-name}.cognitiveservices.azure.com).

largePersonGroupId
path True

string

ID kontainer.

Regex pattern: ^[a-z0-9-_]+$

personId
path True

string

uuid

ID orang tersebut.

Isi Permintaan

Nama Jenis Deskripsi
name

string

Nama yang ditentukan pengguna, panjang maksimum adalah 128.

userData

string

Data yang ditentukan pengguna opsional. Panjang tidak boleh melebihi 16K.

Respons

Nama Jenis Deskripsi
200 OK

Permintaan telah berhasil.

Other Status Codes

FaceErrorResponse

Respons kesalahan yang tidak terduga.

Headers

x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Kunci rahasia untuk langganan Azure AI Face Anda.

Type: apiKey
In: header

AADToken

Alur OAuth2 Azure Active Directory

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

Scopes

Nama Deskripsi
https://cognitiveservices.azure.com/.default

Contoh

Update Person in LargePersonGroup

Sample Request

PATCH {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1

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

Sample Response

Definisi

Nama Deskripsi
FaceError

Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Respons yang berisi detail kesalahan.

FaceError

Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

Nama Jenis Deskripsi
code

string

Salah satu set kode kesalahan yang ditentukan server.

message

string

Representasi kesalahan yang dapat dibaca manusia.

FaceErrorResponse

Respons yang berisi detail kesalahan.

Nama Jenis Deskripsi
error

FaceError

Objek kesalahan.