針對多變量 API 進行疑難排解
重要
從 2023 年 9 月 20 日起，您將無法建立新的異常偵測器資源。 異常偵測器服務將於 2026 年 10 月 1 日淘汰。
本文提供相關指引，說明在使用 Azure AI 異常偵測程式多變量 API 時如何對常見的錯誤訊息進行疑難排解和補救。
多變量錯誤碼
下表列出多變量錯誤碼。
常見錯誤
| 錯誤碼 |
HTTP 錯誤碼 |
錯誤訊息 |
註解 |
SubscriptionNotInHeaders |
400 |
在標頭中找不到 apim-subscription-id。 |
在標頭中新增您的 APIM 訂用帳戶識別碼。 範例標頭為 {"apim-subscription-id": <Your Subscription ID>}。 |
FileNotExist |
400 |
檔案<來源>不存在。 |
檢查 Blob 共用存取簽章的有效性。 請確定簽章並未過期。 |
InvalidBlobURL |
400 |
|
您的 Blob 共用存取簽章不是有效的共用存取簽章。 |
StorageWriteError |
403 |
|
此錯誤可能是由權限問題引起的。 我們的服務無法將資料寫入至由客戶自控金鑰加密的 Blob。 請移除客戶自控金鑰，或再次授與服務的存取權。 如需詳細資訊，請參閱設定 Azure AI 服務的 Azure Key Vault 客戶自控金鑰。 |
StorageReadError |
403 |
|
與 StorageWriteError 相同。 |
UnexpectedError |
500 |
|
與我們聯繫，以便取得詳細的錯誤資訊。 您可以從 Azure AI 服務支援與說明選項取得支援選項，或傳送電子郵件至 AnomalyDetector@microsoft.com。 |
定型多變量異常偵測模型
| 錯誤碼 |
HTTP 錯誤碼 |
錯誤訊息 |
註解 |
TooManyModels |
400 |
此訂用帳戶已達到模型的最大數目。 |
每個 APIM 訂用帳戶識別碼都可以有 300 個作用中模型。 在您定型新模型之前，請先刪除未使用的模型。 |
TooManyRunningModels |
400 |
此訂用帳戶已達到執行中模型的最大數目。 |
每個 APIM 訂用帳戶識別碼都可以同時定型五個模型。 在先前的模型完成定型程序後，將新模型定型。 |
InvalidJsonFormat |
400 |
無效的 JSON 格式。 |
定型要求不是有效的 JSON。 |
InvalidAlignMode |
400 |
'alignMode' 欄位必須是下列其中一項：'Inner' 或 'Outer'。 |
檢查 'alignMode' 的值，其應為 'Inner' 或 'Outer' (區分大小寫)。 |
InvalidFillNAMethod |
400 |
'fillNAMethod' 欄位中必須是下列其中一項：'Previous'、'Subsequent'、'Linear'、'Zero'、'Fixed'、'NotFill'。 當 'alignMode' 為 'Outer' 時，該欄位就不能是 'NotFill'。 |
檢查 'fillNAMethod' 的值。 如需詳細資訊，請參閱使用異常偵測器多變量 API 的最佳作法。 |
RequiredPaddingValue |
400 |
當 'fillNAMethod' 為 'Fixed' 時，要求中必須要有 'paddingValue' 欄位。 |
當 'fillNAMethod' 為 'Fixed' 時，您必須提供有效的填補值。 如需詳細資訊，請參閱使用異常偵測器多變量 API 的最佳作法。 |
RequiredSource |
400 |
要求中必須要有 'source' 欄位。 |
您的定型要求未指定 'source' 欄位的值。 例如 {"source": <Your Blob SAS>}。 |
RequiredStartTime |
400 |
要求中必須要有 'startTime' 欄位。 |
您的定型要求未指定 'startTime' 欄位的值。 例如 {"startTime": "2021-01-01T00:00:00Z"}。 |
InvalidTimestampFormat |
400 |
無效的時間戳記格式。 <timestamp> 格式不是有效的格式。 |
要求本文中的時間戳記格式不正確。 嘗試用 import pandas as pd; pd.to_datetime(timestamp) 進行驗證。 |
RequiredEndTime |
400 |
要求中必須要有 'endTime' 欄位。 |
您的定型要求未指定 'startTime' 欄位的值。 例如 {"endTime": "2021-01-01T00:00:00Z"}。 |
InvalidSlidingWindow |
400 |
'slidingWindow' 欄位必須是 28 與 2880 之間的整數。 |
'slidingWindow' 欄位中必須是 28 與 2880 之間的整數 (含此二數)。 |
使用模型識別碼取得多變量模型
| 錯誤碼 |
HTTP 錯誤碼 |
錯誤訊息 |
註解 |
ModelNotExist |
404 |
模型不存在。 |
具有對應模型識別碼的模型不存在。 檢查要求 URL 中的模型識別碼。 |
列出多變量模型
| 錯誤碼 |
HTTP 錯誤碼 |
錯誤訊息 |
註解 |
InvalidRequestParameterError |
400 |
$skip 或 $top 的值無效。 |
檢查兩個參數的值是否為數值。 $skip 和 $top 值可用來列出具有分頁的模型。 由於 API 只會傳回 10 個最近更新的模型，您可以使用 $skip 和 $top 來取得先前更新的模型。 |
使用已定型的模型進行異常偵測
| 錯誤碼 |
HTTP 錯誤碼 |
錯誤訊息 |
註解 |
ModelNotExist |
404 |
模型不存在。 |
用於推斷的模型不存在。 檢查要求 URL 中的模型識別碼。 |
ModelFailed |
400 |
模型無法定型。 |
模型未成功定型。 使用模型識別碼取得模型，以取得詳細資訊。 |
ModelNotReady |
400 |
模型尚未就緒。 |
模型尚未就緒。 稍候片刻，靜待定型程序完成。 |
InvalidFileSize |
413 |
檔案 <file> 超過檔案大小限制 (<size limit> 位元組)。 |
推斷資料的大小超過上限，其目前為 2GB。 使用較少的資料進行推斷。 |
取得偵測結果
| 錯誤碼 |
HTTP 錯誤碼 |
錯誤訊息 |
註解 |
ResultNotExist |
404 |
結果不存在。 |
個別要求的結果不存在。 可能是推斷未完成，或結果已到期。 到期時間為七天。 |
資料處理錯誤
下列錯誤碼沒有相關聯的 HTTP 錯誤碼。
| 錯誤碼 |
錯誤訊息 |
註解 |
NoVariablesFound |
找不到任何變數。 確認您的檔案已依據指示整理。 |
在資料來源中找不到任何 CSV 檔案。 此錯誤通常是由於檔案的組織有誤所致。 請參閱範例資料以了解所需的結構。 |
DuplicatedVariables |
有多個具有相同名稱的變數。 |
有重複的變數名稱。 |
FileNotExist |
檔案 <filename> 不存在。 |
此錯誤通常發生在推斷期間。 變數出現在定型資料中，但在推斷資料中遺漏。 |
RedundantFile |
檔案 <filename> 是冗餘檔案。 |
此錯誤通常發生在推斷期間。 變數不在定型資料中，但出現在推斷資料中。 |
FileSizeTooLarge |
檔案 <filename> 的大小太大。 |
單一 CSV 檔案 <filename> 的大小超過限制。 使用較少的資料進行定型。 |
ReadingFileError |
讀取 <filename> 時發生錯誤。 <錯誤訊息> |
無法讀取檔案 <filename>。 如需詳細資訊，請參閱<錯誤訊息>，或在本機環境中以 pd.read_csv(filename) 進行驗證。 |
FileColumnsNotExist |
檔案 <filename> 中的時間戳記或值資料行不存在。 |
每個 CSV 檔案都必須具有名稱分別是 timestamp 和 value 的兩個資料行 (區分大小寫)。 |
VariableParseError |
變數 <variable> 會剖析 <error message> 錯誤。 |
因為執行階段錯誤，所以無法處理 <variable>。 如需詳細資訊，請參閱<錯誤訊息>，或與我們連絡並提供<錯誤訊息>。 |
MergeDataFailed |
無法合併資料。 檢查資料格式。 |
資料合併失敗。 此錯誤可能是因為資料格式有誤或檔案的組織有誤所致。 請參閱目前檔案結構的範例資料。 |
ColumnNotFound |
在合併的資料中找不到資料行 <column>。 |
合併後遺漏資料行。 Verify the data. |
NumColumnsMismatch |
合併資料的資料行數目不符合變數數目。 |
Verify the data. |
TooManyData |
資料點太多。 每個變數的最大數目為 1000000 個。 |
減少輸入資料的大小。 |
NoData |
沒有有效的資料。 |
處理之後，沒有可供定型/推斷的資料。 檢查開始時間和結束時間。 |
DataExceedsLimit. |
時間戳記介於 startTime 與 endTime 之間的資料長度超過限制 (<limit>)。 |
處理之後的資料大小超過限制。 處理後的資料目前沒有限制。 |
NotEnoughInput |
資料不足。 資料的長度是 <data length>，但最小長度應大於滑動視窗大小 <sliding window size>。 |
推斷的資料點數目下限是滑動視窗的大小。 請嘗試提供更多資料來進行推斷。 |