Large Face List - Update Face

永続化された顔の userData フィールドを更新します。

PATCH {Endpoint}/face/v1.0/largefacelists/{largeFaceListId}/persistedfaces/{persistedFaceId}

URI パラメーター

名前 / 必須 説明
Endpoint
path True

string

サポートされている Cognitive Services エンドポイント (プロトコルとホスト名、例: https://westus.api.cognitive.microsoft.com)。

largeFaceListId
path True

string

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

特定の大きな顔リストを参照する ID。

persistedFaceId
path True

string (uuid)

既存の顔の特定の永続化されたFaceId を参照する ID。

要求ヘッダー

名前 必須 説明
Ocp-Apim-Subscription-Key True

string

要求本文

名前 説明
userData

string

maxLength: 1024

顔にアタッチされたユーザー指定のデータ。 サイズ制限は 1 KB です。

応答

名前 説明
200 OK

呼び出しが成功すると、空の応答本文が返されます。

Other Status Codes

APIError

エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

型: apiKey
/: header

Update face example

要求のサンプル

PATCH {Endpoint}/face/v1.0/largefacelists/abc/persistedfaces/62004fa7-1ac0-478e-9d5a-b38f9e7fbc68


{
  "userData": "User-provided data attached to the face."
}

応答のサンプル

定義

名前 説明
APIError

API によって返されるエラー情報

Error

エラー本文。

UpdateFaceRequest

顔データの更新を要求します。

APIError

API によって返されるエラー情報

名前 説明
error

Error

エラー本文。

Error

エラー本文。

名前 説明
code

string

message

string

UpdateFaceRequest

顔データの更新を要求します。

名前 説明
userData

string

maxLength: 1024

顔にアタッチされたユーザー指定のデータ。 サイズ制限は 1 KB です。