Azure AI Face API のエラー コード
- [アーティクル]
-
-
一般的なエラー コード
これらのエラー コードは、任意の Face API 呼び出しで返すことができます。
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
要求本文が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
JSON 解析エラー。 |
不適切または認識できない要求 JSON 本文。 |
| 正しくない要求 (400) |
BadArgument |
'recognitionModel' が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
'detectionModel' が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
'name' は空です。 |
|
| 正しくない要求 (400) |
BadArgument |
'name' が長すぎます。 |
|
| 正しくない要求 (400) |
BadArgument |
'userData' が長すぎます。 |
|
| 正しくない要求 (400) |
BadArgument |
'start' が長すぎます。 |
|
| 正しくない要求 (400) |
BadArgument |
'top' は無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
引数 targetFace が範囲外です。 |
|
| 正しくない要求 (400) |
BadArgument |
引数 targetFace が無効です。 |
文字列形式が無効であるか、left/top/height/width 値が無効です。 |
| 正しくない要求 (400) |
InvalidURL |
無効なイメージ URL です。 |
サポートされている形式は、JPEG、PNG、GIF (最初のフレーム)、BMP です。 |
| 正しくない要求 (400) |
InvalidURL |
無効なイメージ URL またはターゲット サーバーからのダウンロードエラー。 リモート サーバー エラーが返されました:"要求の送信中にエラーが発生しました。" |
|
| 正しくない要求 (400) |
InvalidImage |
デコード エラー、イメージ形式はサポートされていません。 |
|
| 正しくない要求 (400) |
InvalidImage |
画像に顔が検出されません。 |
|
| 正しくない要求 (400) |
InvalidImage |
画像には 1 つ以上の顔があります。 |
|
| 正しくない要求 (400) |
InvalidImageSize |
画像サイズが小さすぎます。 |
有効なイメージ ファイル サイズは、1 KB 以上にする必要があります。 |
| 正しくない要求 (400) |
InvalidImageSize |
画像のサイズが大きすぎます。 |
有効なイメージ ファイル サイズは 6 MB 以下にする必要があります。 |
| 承認されていません (401) |
401 |
無効なサブスクリプション キーまたは間違った API エンドポイントが原因でアクセスが拒否されました。 アクティブなサブスクリプションに対して有効なキーを指定し、リソースに適切なリージョン API エンドポイントを使用してください。 |
|
| 許可されていません (403) |
UnsupportedFeature |
機能はサポートされていません。1 つ以上の機能の承認がありません:識別、検証。 |
登録フォームを送信して、アクセスに 登録します。 |
| Conflict (409) |
ConcurrentOperationConflict |
リソース <resourceName>に競合操作があります。後で試してください。 |
|
| 要求が多すぎます (429) |
429 |
レート制限を超過しています。 |
|
顔検出エラー コード
これらのエラー コードは、顔検出操作で返すことができます。
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
引数 returnFaceAttributes が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
'returnFaceAttributes' は、detection_02ではサポートされていません。 |
|
| 正しくない要求 (400) |
BadArgument |
'returnLandmarks' は、detection_02ではサポートされていません。 |
|
| 許可されていません (403) |
UnsupportedFeature |
返品属性 (感情、性別、年齢、笑顔、顔の髪、髪、メイク) は非推奨となり、サポートされなくなりました。 |
この決定について詳しくは、こちらをご覧ください。 |
Face Liveness Session のエラー コード
これらのエラー コードは、Face Liveness Session 操作によって返される可能性があります。
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
Start パラメーターが無効です。 登録プロセスを続行するには、最後のエントリの 'Id' フィールドを指定してください。 |
|
| 正しくない要求 (400) |
BadArgument |
Top パラメーターが無効です。 有効な範囲は 1 ~ 1000 です。 |
|
| 正しくない要求 (400) |
InvalidRequestBody |
指定された要求本文が正しくありません。 操作スキーマを確認して、もう一度やり直してください。 |
|
| 正しくない要求 (400) |
InvalidTokenLifetime |
無効な authTokenTimeToLiveInSeconds が指定されています。 60 ~ 86400 以内である必要があります。 |
|
| 正しくない要求 (400) |
InvalidLivenessOperationMode |
livenessOperationMode が無効です。 'パッシブ' である必要があります。 |
|
| 正しくない要求 (400) |
InvalidDeviceCorrelationId |
セッションの作成またはセッションの開始中に、要求本文にデバイスの関連付け ID が必要です。 null または空でなく、64 文字以下にする必要があります。 |
|
| Not Found (404) |
SessionNotFound |
セッション ID が見つかりません。 セッション ID の有効期限が切れているか、存在しません。 |
|
Face Identify エラー コード
これらのエラー コードは、Face Identify 操作で返すことができます。
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
'recognitionModel' には互換性がありません。 |
|
| 正しくない要求 (400) |
BadArgument |
ユーザー グループ ID が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
大きなユーザー グループ ID が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
動的人物グループ ID が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
引数 maxNumOfCandidatesReturned が無効です。 |
有効な範囲は [1, 100] です。 |
| 正しくない要求 (400) |
BadArgument |
引数 confidenceThreshold が無効です。 |
有効な範囲は [0, 1] です。 |
| 正しくない要求 (400) |
BadArgument |
faceIds の長さが有効な範囲内にありません。 |
有効な範囲は [1, 10] です。 |
| 正しくない要求 (400) |
FaceNotFound |
顔が見つかりません。 |
|
| 正しくない要求 (400) |
PersonGroupNotFound |
人物グループが見つかりません。 |
|
| 正しくない要求 (400) |
LargePersonGroupNotFound |
大規模なユーザー グループが見つかりません。 |
|
| 正しくない要求 (400) |
DynamicPersonGroupNotFound |
動的人物グループが見つかりません。 |
|
| 正しくない要求 (400) |
PersonGroupNotTrained |
トレーニングされていないユーザー グループ。 |
|
| 正しくない要求 (400) |
LargePersonGroupNotTrained |
トレーニングされていない大規模なユーザー グループ。 |
|
| 正しくない要求 (400) |
PersonGroupIdAndLargePersonGroupIdBothNotNull |
大きい人物グループ ID と個人グループ ID はどちらも null ではありません。 |
|
| 正しくない要求 (400) |
PersonGroupIdAndLargePersonGroupIdBothNull |
大きい人物グループ ID と個人グループ ID の両方が null です。 |
|
| 正しくない要求 (400) |
MissingIdentificationScopeParameters |
要求に識別スコープ パラメーターがありません。 |
|
| 正しくない要求 (400) |
IncompatibleIdentificationScopeParametersCombination |
要求には、互換性のない識別スコープ パラメーターが存在します。 |
|
| Conflict (409) |
PersonGroupTrainingNotFinished |
人物グループはトレーニング中です。 |
|
| Conflict (409) |
LargePersonGroupTrainingNotFinished |
大規模人物グループはトレーニング中です。 |
|
Face Verify のエラー コード
これらのエラー コードは、Face Verify 操作で返すことができます。
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
'recognitionModel' には互換性がありません。 |
|
| 正しくない要求 (400) |
BadArgument |
Face ID が無効です。 |
有効な faceId は Face - Detect から取得されます。 |
| 正しくない要求 (400) |
BadArgument |
ユーザー ID が無効です。 |
有効な personId は、個人グループユーザーの作成、大規模人物グループユーザーの作成、または人物ディレクトリの作成 - ユーザーの作成から生成されます。 |
| 正しくない要求 (400) |
BadArgument |
ユーザー グループ ID が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
大きなユーザー グループ ID が無効です。 |
|
| 正しくない要求 (400) |
PersonNotFound |
人物が見つかりません。 |
|
| 正しくない要求 (400) |
PersonGroupNotFound |
人物グループが見つかりません。 |
|
| 正しくない要求 (400) |
LargePersonGroupNotFound |
大規模人物グループが見つかりません。 |
|
| Not Found (404) |
FaceNotFound |
顔が見つかりません。 |
|
| Not Found (404) |
PersonNotFound |
人物が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
人の永続的な顔が見つかりません。 |
|
類似するエラー コードを検索する
これらのエラー コードは、Face Find Similar 操作で返すことができます。
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
'recognitionModel' には互換性がありません。 |
|
| 正しくない要求 (400) |
BadArgument |
モードが無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
顔リスト ID が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
大きな顔リスト ID が無効です。 |
|
| 正しくない要求 (400) |
BadArgument |
LargeFaceListId、faceListId、faceId は、そのうちの 1 つが有効ではありません。 |
|
| 正しくない要求 (400) |
BadArgument |
LargeFaceListId、faceListId、faceId はすべて null です。 |
|
| 正しくない要求 (400) |
BadArgument |
2 つ以上の largeFaceListId、faceListId、faceId は null ではありません。 |
|
| 正しくない要求 (400) |
BadArgument |
引数 maxNumOfCandidatesReturned が無効です。 |
有効な範囲は [1, 1000] です。 |
| 正しくない要求 (400) |
BadArgument |
faceIds の長さが有効な範囲内にありません。 |
有効な範囲は [1, 1000] です。 |
| 正しくない要求 (400) |
FaceNotFound |
顔が見つかりません。 |
|
| 正しくない要求 (400) |
FaceListNotFound |
顔リストが見つかりません。 |
|
| 正しくない要求 (400) |
LargeFaceListNotFound |
大きな顔リストが見つかりません。 |
|
| 正しくない要求 (400) |
LargeFaceListNotTrained |
大規模な顔リストはトレーニングされていません。 |
|
| 正しくない要求 (400) |
FaceListNotReady |
顔リストが空です。 |
|
| Conflict (409) |
LargeFaceListTrainingNotFinished |
大きな顔リストはトレーニング中です。 |
|
Face Group のエラー コード
これらのエラー コードは、Face Group 操作で返すことができます。
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
'recognitionModel' には互換性がありません。 |
|
| 正しくない要求 (400) |
BadArgument |
faceIds の長さが有効な範囲内にありません。 |
有効な範囲は [2, 1000] です。 |
人物グループの操作
これらのエラー コードは、ユーザー グループの操作によって返される可能性があります。
人物グループのエラー コード
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
ユーザー グループ ID が無効です。 |
有効な文字は、小文字、数字、'-' または '_' の英字です。 最大長は 64 です。 |
| 許可されていません (403) |
QuotaExceeded |
ユーザー グループ番号がサブスクリプション レベルの制限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
ユーザー数がユーザー グループ レベルの制限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
ユーザー数がサブスクリプション レベルの制限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
保持される顔の数が制限に達しました。 |
|
| Not Found (404) |
PersonGroupNotFound |
人物グループが見つかりません。 |
|
| Not Found (404) |
PersonGroupNotFound |
ユーザー グループ ID が無効です。 |
|
| Not Found (404) |
PersonNotFound |
人物 <personId> が見つかりません。 |
|
| Not Found (404) |
PersonNotFound |
ユーザー ID が無効です。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔 <faceId> が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔 ID が無効です。 |
|
| Not Found (404) |
PersonGroupNotTrained |
トレーニングされていないユーザー グループ。 |
このエラーは、トレーニングされていないグループのトレーニング状態を取得すると表示されます。 |
| Conflict (409) |
PersonGroupExists |
ユーザー グループは既に存在します。 |
|
| Conflict (409) |
PersonGroupTrainingNotFinished |
人物グループはトレーニング中です。 |
トレーニングが完了したら、もう一度やり直してください。 |
大規模人物グループのエラー コード
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
大きなユーザー グループ ID が無効です。 |
有効な文字は、小文字、数字、'-' または '_' の英字です。 最大長は 64 です。 |
| 正しくない要求 (400) |
BadArgument |
'name' と 'userData' の両方が空です。 |
|
| 許可されていません (403) |
QuotaExceeded |
大規模なユーザー グループ番号がサブスクリプション レベルの制限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
人数が大きいユーザー グループ レベルの制限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
ユーザー数がサブスクリプション レベルの制限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
保持される顔の数が制限に達しました。 |
|
| Not Found (404) |
LargePersonGroupNotFound |
大規模なユーザー グループが見つかりません。 |
|
| Not Found (404) |
LargePersonGroupNotFound |
大きなユーザー グループ ID が無効です。 |
|
| Not Found (404) |
PersonNotFound |
人物 <personId> が見つかりません。 |
|
| Not Found (404) |
PersonNotFound |
ユーザー ID が無効です。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔 <faceId> が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔 ID が無効です。 |
|
| Not Found (404) |
LargePersonGroupNotTrained |
トレーニングされていない大規模なユーザー グループ。 |
このエラーは、トレーニングされていないグループのトレーニング状態を取得すると表示されます。 |
| Conflict (409) |
LargePersonGroupExists |
大規模な人物グループは既に存在します。 |
|
| Conflict (409) |
LargePersonGroupTrainingNotFinished |
大規模人物グループはトレーニング中です。 |
トレーニングが完了したら、もう一度やり直してください。 |
Face List 操作
これらのエラー コードは、Face List 操作で返すことができます。
Face List のエラー コード
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
顔リスト ID が無効です。 |
有効な文字は、小文字、数字、'-' または '_' の英字です。 最大長は 64 です。 |
| 許可されていません (403) |
QuotaExceeded |
保持される顔の数が制限に達しました。 |
|
| Not Found (404) |
FaceListNotFound |
顔リストが見つかりません。 |
|
| Not Found (404) |
FaceListNotFound |
顔リスト ID が無効です。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔 ID が無効です。 |
|
| Conflict (409) |
FaceListExists |
顔リストは既に存在します。 |
|
大きな顔リストのエラー コード
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
大きな顔リスト ID が無効です。 |
有効な文字は、小文字、数字、'-' または '_' の英字です。 最大長は 64 です。 |
| 正しくない要求 (400) |
BadArgument |
'name' と 'userData' の両方が空です。 |
|
| 許可されていません (403) |
QuotaExceeded |
顔リストの数が上限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
保持される顔の数が制限に達しました。 |
|
| Not Found (404) |
LargeFaceListNotFound |
大きな顔リストが見つかりません。 |
|
| Not Found (404) |
LargeFaceListNotFound |
大きな顔リスト ID が無効です。 |
|
| Not Found (404) |
PersistedFaceNotFound |
大きな顔リストの顔 <faceId> が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔 ID が無効です。 |
|
| Not Found (404) |
LargeFaceListNotTrained |
トレーニングされていない大きな顔リスト。 |
このエラーは、トレーニングされていない大規模な顔リストのトレーニング状態を取得すると表示されます。 |
| Conflict (409) |
LargeFaceListExists |
大きな顔リストは既に存在します。 |
|
| Conflict (409) |
LargeFaceListTrainingNotFinished |
大きな顔リストはトレーニング中です。 |
トレーニングが完了したら、もう一度やり直してください。 |
Person Directory の操作
これらのエラー コードは、Person Directory 操作によって返される可能性があります。
Person Directory のエラー コード
| HTTP 状態コード |
エラー コード |
エラー メッセージ |
説明 |
| 正しくない要求 (400) |
BadArgument |
認識モデルは、この機能ではサポートされていません。 |
|
| 正しくない要求 (400) |
BadArgument |
'start' は有効なユーザー ID ではありません。 |
|
| 正しくない要求 (400) |
BadArgument |
'name' と 'userData' の両方が空です。 |
|
| 正しくない要求 (400) |
DynamicPersonGroupNotFound |
動的人物グループ ID が無効です。 |
|
| 許可されていません (403) |
QuotaExceeded |
ユーザー数がサブスクリプション レベルの制限に達しました。 |
|
| 許可されていません (403) |
QuotaExceeded |
保持される顔の数が制限に達しました。 |
|
| Not Found (404) |
DynamicPersonGroupNotFound |
動的人物グループが見つかりませんでした。 |
|
| Not Found (404) |
DynamicPersonGroupNotFound |
DynamicPersonGroupPersonReference <groupId> が見つかりません。 |
|
| Not Found (404) |
PersonNotFound |
人物が見つかりません。 |
|
| Not Found (404) |
PersonNotFound |
ユーザー ID が無効です。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された顔 <faceId> が見つかりません。 |
|
| Not Found (404) |
PersistedFaceNotFound |
永続化された Face ID が無効です。 |
|
| Conflict (409) |
DynamicPersonGroupExists |
動的人物グループ ID <groupId> は既に存在します。 |
|
次のステップ