常見的 REST API 錯誤碼
任何 Azure 儲存體服務的作業都可以傳回下列錯誤碼：
| 錯誤碼 | HTTP 狀態碼 | 使用者訊息 |
|---|---|---|
| NoAuthenticationInformation | 未經授權 (401) | 伺服器無法驗證要求。 請參閱 www-authenticate 標頭中的資訊。 |
| InvalidAuthenticationInfo | 未經授權 (401) | 伺服器無法驗證要求。 請參閱 www-authenticate 標頭中的資訊。 |
| AccountAlreadyExists | 衝突 (409) | 指定的帳戶已經存在。 |
| AccountBeingCreated | 衝突 (409) | 正在建立指定的帳戶。 |
| AccountIsDisabled | 禁止 (403) | 已停用指定的帳戶。 |
| AccountProtectedFromDeletion | 衝突 (409) | 帳戶 <accountName> 容器 <containerName> 具有 <have legal hold\locked immutability policy> 。 |
| AuthenticationFailed | 禁止 (403) | 伺服器無法驗證要求。 請確定 Authorization 標頭的值採用正確的格式並包含簽章。 |
| ConditionHeadersNotSupported | BadRequest (400) | 不支援條件標頭。 |
| ConditionNotMet | 未修改 (304) | 不符合條件式標頭中所指定的條件，因此無法進行讀取作業。 |
| ConditionNotMet | 先決條件失敗 (412) | 不符合條件式標頭中所指定的條件，因此無法進行寫入作業。 |
| EmptyMetadataKey | 不正確的要求 (400) | 其中一個中繼資料索引鍵/值組的索引鍵為空白。 |
| InsufficientAccountPermissions | 禁止 (403) | 讀取作業目前已停用。 |
| InsufficientAccountPermissions | 禁止 (403) | 不允許寫入作業。 |
| InsufficientAccountPermissions | 禁止 (403) | 存取的帳戶沒有足夠的許可權可執行這項作業。 |
| InternalError | 內部伺服器錯誤 (500) | 伺服器發生內部錯誤。 請重試要求。 |
| InvalidAuthenticationInfo | 不正確的要求 (400) | 驗證資訊的格式不正確。 請確認 Authorization 標頭的值。 |
| InvalidHeaderValue | 不正確的要求 (400) | 其中一個 HTTP 標頭提供之值的格式不正確。 |
| InvalidHttpVerb | 不正確的要求 (400) | 伺服器無法辨識指定的 HTTP 動詞命令。 |
| InvalidInput | 不正確的要求 (400) | 其中一個要求輸入無效。 |
| InvalidMd5 | 不正確的要求 (400) | 要求中所指定的 MD5 值無效。 MD5 值必須是 128 位元並以 Base64 編碼。 |
| InvalidMetadata | 不正確的要求 (400) | 指定的中繼資料無效。 其中包含不允許的字元。 |
| InvalidQueryParameterValue | 不正確的要求 (400) | 要求 URI 中的其中一個查詢參數所指定的值無效。 |
| InvalidRange | 無法滿足的要求範圍 (416) | 指定的範圍對於資源的目前大小無效。 |
| InvalidResourceName | 不正確的要求 (400) | 指定的資源名稱包含不正確字元。 |
| InvalidUri | 不正確的要求 (400) | 要求的 URI 不代表伺服器上的任何資源。 |
| InvalidXmlDocument | 不正確的要求 (400) | 指定之 XML 檔案的語法無效。 |
| InvalidXmlNodeValue | 不正確的要求 (400) | 要求主體中其中一個 XML 節點提供之值的格式不正確。 |
| KeyVaultAccessTokenCannotBeAcquired | 禁止 (403) | 無法使用此資源的身分識別，從 Azure Active Directory 取得金鑰保存庫的存取權杖。 |
| KeyVaultEncryptionKeyNotFound | 禁止 (403) | 找不到金鑰保存庫金鑰來解除包裝加密金鑰。 |
| KeyVaultVaultNotFound | 禁止 (403) | 找不到金鑰保存庫保存庫。 |
| Md5Mismatch | 不正確的要求 (400) | 要求中指定的 MD5 值不符合伺服器計算的 MD5 值。 |
| MetadataTooLarge | 不正確的要求 (400) | 指定的中繼資料大小超過允許的大小上限。 |
| MissingContentLengthHeader | 必要的長度 (411) | 未指定 Content-Length 標頭。 |
| MissingRequiredQueryParameter | 不正確的要求 (400) | 此要求未指定必要的查詢參數。 |
| MissingRequiredHeader | 不正確的要求 (400) | 未指定必要的 HTTP 標頭。 |
| MissingRequiredXmlNode | 不正確的要求 (400) | 要求主體中未指定必要的 XML 節點。 |
| MultipleConditionHeadersNotSupported | 不正確的要求 (400) | 不支援多個條件標頭。 |
| OperationTimedOut | 內部伺服器錯誤 (500) | 無法在允許的時間內完成作業。 作業可能或可能已在伺服器端成功。 請先查詢伺服器狀態，再重試作業。 |
| OutOfRangeInput | 不正確的要求 (400) | 其中一個要求輸入超出範圍。 |
| OutOfRangeQueryParameterValue | 不正確的要求 (400) | 要求 URI 中指定的查詢參數超出允許的範圍。 |
| RequestBodyTooLarge | 要求實體太大 (413) | 要求主體的大小超過允許的大小上限。 |
| ResourceTypeMismatch | 衝突 (409) | 指定的資源類型不符合現有資源的類型。 |
| RequestUrlFailedToParse | 不正確的要求 (400) | 無法剖析要求中的 URL。 |
| ResourceAlreadyExists | 衝突 (409) | 指定的資源已經存在。 |
| ResourceNotFound | 找不到 (404) | 指定的資源不存在。 |
| ServerBusy | 服務無法使用 (503) | 伺服器目前無法接收要求。 請重試您的要求。 |
| ServerBusy | 服務無法使用 (503) | 輸入超過帳戶限制。 |
| ServerBusy | 服務無法使用 (503) | 輸出超過帳戶限制。 |
| ServerBusy | 服務無法使用 (503) | 每秒的作業數超過帳戶限制。 |
| UnsupportedHeader | 不正確的要求 (400) | 不支援要求中指定的其中一個 HTTP 標頭。 |
| UnsupportedXmlNode | 不正確的要求 (400) | 不支援要求主體中指定的其中一個 XML 節點。 |
| UnsupportedQueryParameter | 不正確的要求 (400) | 不支援要求 URI 中指定的其中一個查詢參數。 |
| UnsupportedHttpVerb | 不允許的方法 (405) | 資源不支援指定的 HTTP 動詞命令。 |
另請參閱
Blob 儲存體錯誤碼
佇列儲存體錯誤碼
資料表儲存體錯誤碼
Azure 檔案儲存體錯誤碼
針對 API 作業進行疑難排解
HttpStatusCode 列舉
Azure 儲存體 REST API 參考