Face List Operations - Get Large Face List Face
largeFaceListId と persistedFaceId を使用して、Large Face List の永続化された顔を取得します。
GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces/{persistedFaceId}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
api
|
path | True |
string |
API バージョン |
endpoint
|
path | True |
string uri |
サポートされている Cognitive Services エンドポイント (プロトコルとホスト名(例: https://{resource-name}.cognitiveservices.azure.com)。 |
large
|
path | True |
string |
有効な文字は小文字、数字、'-' または '_' の文字で、最大長は 64 です。 Regex pattern: |
persisted
|
path | True |
string uuid |
顔の顔 ID。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
呼び出しが成功すると、ターゲットの永続化された顔の情報 (persistedFaceId と userData) が返されます。 |
|
Other Status Codes |
予期しないエラー応答。 Headers x-ms-error-code: string |
セキュリティ
Ocp-Apim-Subscription-Key
Azure AI Face サブスクリプションの秘密鍵。
Type:
apiKey
In:
header
AADToken
Azure Active Directory OAuth2 フロー
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
名前 | 説明 |
---|---|
https://cognitiveservices.azure.com/.default |
例
Get Face from LargeFaceList
Sample Request
GET {endpoint}/face/v1.1-preview.1/largefacelists/your_large_face_list_id/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055
Sample Response
{
"persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
"userData": "your_user_data"
}
定義
名前 | 説明 |
---|---|
Face |
error オブジェクト。 Face Service によって返されるエラー コードとメッセージの包括的な詳細については、次のリンクを参照してください。 https://aka.ms/face-error-codes-and-messages |
Face |
エラーの詳細を含む応答。 |
Large |
大規模な顔リストの顔リソース。 |
FaceError
error オブジェクト。 Face Service によって返されるエラー コードとメッセージの包括的な詳細については、次のリンクを参照してください。 https://aka.ms/face-error-codes-and-messages
名前 | 型 | 説明 |
---|---|---|
code |
string |
サーバー定義のエラー コードのセットの 1 つ。 |
message |
string |
エラーの人間が判読できる表現。 |
FaceErrorResponse
エラーの詳細を含む応答。
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
LargeFaceListFace
大規模な顔リストの顔リソース。
名前 | 型 | 説明 |
---|---|---|
persistedFaceId |
string |
顔の顔 ID。 |
userData |
string |
顔にアタッチされたユーザー指定のデータ。 長さの制限は 1K です。 |