Azure AI 臉部 API 錯誤碼
常見的錯誤碼
任何臉部 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。 |
由無效的字串格式或左/上/高度/寬度值無效所造成。 |
| 不正確的要求 (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 |
不支援功能，缺少下列一或多個功能的核准：識別、驗證。 |
藉由提交 註冊窗體來註冊存取權。 |
| 衝突 (409) |
ConcurrentOperationConflict |
資源 <resourceName>上有衝突作業，請稍後再試一次。 |
|
| 要求太多 （429） |
429 |
超過速率限制。 |
|
臉部偵測錯誤碼
臉部偵測作業可以傳回這些錯誤碼。
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
無效的引數 returnFaceAttributes。 |
|
| 不正確的要求 (400) |
BadArgument |
detection_02 不支援 'returnFaceAttributes'。 |
|
| 不正確的要求 (400) |
BadArgument |
detection_02 不支援 'returnLandmarks'。 |
|
| 禁止 (403) |
UnsupportedFeature |
傳回屬性（情緒、性別、年齡、微笑、臉部頭髮、頭髮和化妝）已被取代，不再受到支援。 |
如果您有負責任的使用案例，可受益於使用任何有限功能，請傳送電子郵件 給 Azure Face 小組 。 |
臉部即時會話錯誤碼
臉部 Liveness 會話作業可以傳回這些錯誤碼。
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
Start 參數無效。 請指定最後一個專案的 [標識符] 字段，以繼續列出程式。 |
|
| 不正確的要求 (400) |
BadArgument |
Top 參數無效。 有效範圍介於 1 到 1000 之間。 |
|
| 不正確的要求 (400) |
InvalidRequestBody |
提供不正確的要求本文。 請檢查作業架構，然後再試一次。 |
|
| 不正確的要求 (400) |
InvalidTokenLifetime |
指定的 authTokenTimeToLiveInSeconds 無效。 必須介於 60 到 86400 以內。 |
|
| 不正確的要求 (400) |
InvalidLivenessOperationMode |
指定的 livenessOperationMode 無效。 必須是「被動」。 |
|
| 不正確的要求 (400) |
InvalidDeviceCorrelationId |
在會話建立或會話啟動期間，要求本文中需要裝置相互關聯標識碼。 不得為 Null 或空白，且不可超過 64 個字元。 |
|
| 找不到 (404) |
SessionNotFound |
找不到會話標識碼。 會話標識碼已過期或不存在。 |
|
臉部識別錯誤碼
臉部識別作業可以傳回這些錯誤碼。
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
'recognitionModel' 不兼容。 |
|
| 不正確的要求 (400) |
BadArgument |
人員群組標識碼無效。 |
|
| 不正確的要求 (400) |
BadArgument |
大型人員群組標識碼無效。 |
|
| 不正確的要求 (400) |
BadArgument |
動態人員群組標識碼無效。 |
|
| 不正確的要求 (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 |
大型人員群組標識碼和人員群組標識碼都不是 Null。 |
|
| 不正確的要求 (400) |
PersonGroupIdAndLargePersonGroupIdBothNull |
大型人員群組標識碼和人員群組標識碼都是 Null。 |
|
| 不正確的要求 (400) |
MissingIdentificationScopeParameters |
要求中沒有識別範圍參數。 |
|
| 不正確的要求 (400) |
IncompatibleIdentificationScopeParametersCombination |
要求中有不相容的識別範圍參數。 |
|
| 衝突 (409) |
PersonGroupTrainingNotFinished |
人員群組正在接受訓練。 |
|
| 衝突 (409) |
LargePersonGroupTrainingNotFinished |
大型人員群組正在接受訓練。 |
|
臉部驗證錯誤碼
臉部驗證作業可以傳回這些錯誤碼。
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
'recognitionModel' 不兼容。 |
|
| 不正確的要求 (400) |
BadArgument |
臉部標識碼無效。 |
有效的faceId來自臉部 - 偵測。 |
| 不正確的要求 (400) |
BadArgument |
人員標識碼無效。 |
有效的 personId 是從建立人員群組人員、建立大型人員群組人員或人員目錄 - 建立人員產生。 |
| 不正確的要求 (400) |
BadArgument |
人員群組標識碼無效。 |
|
| 不正確的要求 (400) |
BadArgument |
大型人員群組標識碼無效。 |
|
| 不正確的要求 (400) |
PersonNotFound |
找不到人員。 |
|
| 不正確的要求 (400) |
PersonGroupNotFound |
找不到人員群組。 |
|
| 不正確的要求 (400) |
LargePersonGroupNotFound |
找不到大型人員群組。 |
|
| 找不到 (404) |
FaceNotFound |
找不到臉部。 |
|
| 找不到 (404) |
PersonNotFound |
找不到人員。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到人員持續存在的臉部。 |
|
尋找類似的錯誤碼
臉部尋找類似作業可以傳回這些錯誤碼。
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
'recognitionModel' 不兼容。 |
|
| 不正確的要求 (400) |
BadArgument |
模式無效。 |
|
| 不正確的要求 (400) |
BadArgument |
臉部清單標識碼無效。 |
|
| 不正確的要求 (400) |
BadArgument |
大型臉部清單標識碼無效。 |
|
| 不正確的要求 (400) |
BadArgument |
LargeFaceListId、faceListId 和 faceIds，不完全是其中一個有效。 |
|
| 不正確的要求 (400) |
BadArgument |
LargeFaceListId、faceListId 和 faceId 全都是 Null。 |
|
| 不正確的要求 (400) |
BadArgument |
2 或更多 largeFaceListId、faceListId 和 faceIds 不是 Null。 |
|
| 不正確的要求 (400) |
BadArgument |
自變數 maxNumOfCandidatesReturned 無效。 |
有效範圍介於 [1， 1000] 之間。 |
| 不正確的要求 (400) |
BadArgument |
faceIds 的長度不在有效範圍內。 |
有效範圍介於 [1， 1000] 之間。 |
| 不正確的要求 (400) |
FaceNotFound |
找不到臉部。 |
|
| 不正確的要求 (400) |
FaceListNotFound |
找不到臉部清單。 |
|
| 不正確的要求 (400) |
LargeFaceListNotFound |
找不到大型臉部清單。 |
|
| 不正確的要求 (400) |
LargeFaceListNotTrained |
未定型大型臉部清單。 |
|
| 不正確的要求 (400) |
FaceListNotReady |
臉部清單是空的。 |
|
| 衝突 (409) |
LargeFaceListTrainingNotFinished |
大型臉部清單正在訓練中。 |
|
臉部群組錯誤碼
臉部群組作業可以傳回這些錯誤碼。
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
'recognitionModel' 不兼容。 |
|
| 不正確的要求 (400) |
BadArgument |
faceIds 的長度不在有效範圍內。 |
有效範圍介於 [2， 1000] 之間。 |
人員群組作業
人員群組作業可以傳回這些錯誤碼。
人員群組錯誤碼
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
人員群組標識碼無效。 |
有效字元是小寫、數位、'-' 或 '_' 中的英文字母。 最大長度為 64。 |
| 禁止 (403) |
QuotaExceeded |
人員群組號碼達到訂用帳戶層級限制。 |
|
| 禁止 (403) |
QuotaExceeded |
人員人數達到個人群組層級限制。 |
|
| 禁止 (403) |
QuotaExceeded |
人員人數達到訂用帳戶層級限制。 |
|
| 禁止 (403) |
QuotaExceeded |
持續性臉部號碼已達限制。 |
|
| 找不到 (404) |
PersonGroupNotFound |
找不到人員群組。 |
|
| 找不到 (404) |
PersonGroupNotFound |
人員群組標識碼無效。 |
|
| 找不到 (404) |
PersonNotFound |
找不到人員 <personId> 。 |
|
| 找不到 (404) |
PersonNotFound |
人員標識碼無效。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到保存的臉部。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到保存的臉部 <faceId> 。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
保存的臉部標識碼無效。 |
|
| 找不到 (404) |
PersonGroupNotTrained |
未訓練人員群組。 |
此錯誤會出現在取得從未定型之群組的訓練狀態上。 |
| 衝突 (409) |
PersonGroupExists |
人員群組已經存在。 |
|
| 衝突 (409) |
PersonGroupTrainingNotFinished |
人員群組正在接受訓練。 |
訓練完成後再試一次。 |
大型人員群組錯誤碼
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
大型人員群組標識碼無效。 |
有效字元是小寫、數位、'-' 或 '_' 中的英文字母。 最大長度為 64。 |
| 不正確的要求 (400) |
BadArgument |
'name' 和 'userData' 都是空的。 |
|
| 禁止 (403) |
QuotaExceeded |
大型人員群組號碼達到訂用帳戶層級限制。 |
|
| 禁止 (403) |
QuotaExceeded |
人員人數達到大型人員群組層級限制。 |
|
| 禁止 (403) |
QuotaExceeded |
人員人數達到訂用帳戶層級限制。 |
|
| 禁止 (403) |
QuotaExceeded |
持續性臉部號碼已達限制。 |
|
| 找不到 (404) |
LargePersonGroupNotFound |
找不到大型人員群組。 |
|
| 找不到 (404) |
LargePersonGroupNotFound |
大型人員群組標識碼無效。 |
|
| 找不到 (404) |
PersonNotFound |
找不到人員 <personId> 。 |
|
| 找不到 (404) |
PersonNotFound |
人員標識碼無效。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到保存的臉部。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到保存的臉部 <faceId> 。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
保存的臉部標識碼無效。 |
|
| 找不到 (404) |
LargePersonGroupNotTrained |
大型人員群組未接受訓練。 |
此錯誤會出現在取得從未定型之群組的訓練狀態上。 |
| 衝突 (409) |
LargePersonGroupExists |
大型人員群組已經存在。 |
|
| 衝突 (409) |
LargePersonGroupTrainingNotFinished |
大型人員群組正在接受訓練。 |
訓練完成後再試一次。 |
臉部清單作業
臉部清單作業可以傳回這些錯誤碼。
臉部清單錯誤碼
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
臉部清單標識碼無效。 |
有效字元是小寫、數位、'-' 或 '_' 中的英文字母。 最大長度為 64。 |
| 禁止 (403) |
QuotaExceeded |
持續性臉部號碼已達限制。 |
|
| 找不到 (404) |
FaceListNotFound |
找不到臉部清單。 |
|
| 找不到 (404) |
FaceListNotFound |
臉部清單標識碼無效。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到保存的臉部。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
保存的臉部標識碼無效。 |
|
| 衝突 (409) |
FaceListExists |
臉部清單已經存在。 |
|
大型臉部清單錯誤碼
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
大型臉部清單標識碼無效。 |
有效字元是小寫、數位、'-' 或 '_' 中的英文字母。 最大長度為 64。 |
| 不正確的要求 (400) |
BadArgument |
'name' 和 'userData' 都是空的。 |
|
| 禁止 (403) |
QuotaExceeded |
大型臉部清單號碼已達限制。 |
|
| 禁止 (403) |
QuotaExceeded |
持續性臉部號碼已達限制。 |
|
| 找不到 (404) |
LargeFaceListNotFound |
找不到大型臉部清單。 |
|
| 找不到 (404) |
LargeFaceListNotFound |
大型臉部清單標識碼無效。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到大型臉部清單臉部 <faceId> 。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
保存的臉部標識碼無效。 |
|
| 找不到 (404) |
LargeFaceListNotTrained |
未定型大型臉部清單。 |
此錯誤會出現在取得從未訓練過之大型臉部清單的訓練狀態上。 |
| 衝突 (409) |
LargeFaceListExists |
大型臉部清單已經存在。 |
|
| 衝突 (409) |
LargeFaceListTrainingNotFinished |
大型臉部清單正在訓練中。 |
訓練完成後再試一次。 |
人員目錄作業
人員目錄作業可以傳回這些錯誤碼。
人員目錄錯誤碼
| Http 狀態代碼 |
錯誤碼 |
錯誤訊息 |
描述 |
| 不正確的要求 (400) |
BadArgument |
此功能不支持辨識模型。 |
|
| 不正確的要求 (400) |
BadArgument |
'start' 不是有效的人員標識符。 |
|
| 不正確的要求 (400) |
BadArgument |
'name' 和 'userData' 都是空的。 |
|
| 不正確的要求 (400) |
DynamicPersonGroupNotFound |
動態人員群組標識碼無效。 |
|
| 禁止 (403) |
QuotaExceeded |
人員人數達到訂用帳戶層級限制。 |
|
| 禁止 (403) |
QuotaExceeded |
持續性臉部號碼已達限制。 |
|
| 找不到 (404) |
DynamicPersonGroupNotFound |
找不到動態人員群組。 |
|
| 找不到 (404) |
DynamicPersonGroupNotFound |
找不到 DynamicPersonGroupPersonReference <groupId> 。 |
|
| 找不到 (404) |
PersonNotFound |
找不到人員。 |
|
| 找不到 (404) |
PersonNotFound |
人員標識碼無效。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到保存的臉部。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
找不到保存的臉部 <faceId> 。 |
|
| 找不到 (404) |
PersistedFaceNotFound |
保存的臉部標識碼無效。 |
|
| 衝突 (409) |
DynamicPersonGroupExists |
動態人員群組標識碼 <groupId> 已經存在。 |
|
下一步