Jaa


Common REST API error codes

An operation on any of the Azure Storage services can return the following error codes:

Error code HTTP status code User message
NoAuthenticationInformation Unauthorized (401) Server failed to authenticate the request. Please refer to the information in the www-authenticate header.
InvalidAuthenticationInfo Unauthorized (401) Server failed to authenticate the request. Please refer to the information in the www-authenticate header.
AccountAlreadyExists Conflict (409) The specified account already exists.
AccountBeingCreated Conflict (409) The specified account is in the process of being created.
AccountIsDisabled Forbidden (403) The specified account is disabled.
AccountProtectedFromDeletion Conflict (409) Account <accountName> Containers <containerName> have <have legal hold\locked immutability policy>.
AuthenticationFailed Forbidden (403) Server failed to authenticate the request. Make sure the value of the Authorization header is formed correctly including the signature.
ConditionHeadersNotSupported BadRequest (400) Condition headers aren't supported.
ConditionNotMet Not Modified (304) The condition specified in the conditional header(s) was not met for a read operation.
ConditionNotMet Precondition Failed (412) The condition specified in the conditional header(s) was not met for a write operation.
EmptyMetadataKey Bad Request (400) The key for one of the metadata key-value pairs is empty.
InsufficientAccountPermissions Forbidden (403) Read operations are currently disabled.
InsufficientAccountPermissions Forbidden (403) Write operations aren't allowed.
InsufficientAccountPermissions Forbidden (403) The account being accessed doesn't have sufficient permissions to execute this operation.
InternalError Internal Server Error (500) The server encountered an internal error. Please retry the request.
InvalidAuthenticationInfo Bad Request (400) The authentication information wasn't provided in the correct format. Verify the value of Authorization header.
InvalidHeaderValue Bad Request (400) The value provided for one of the HTTP headers was not in the correct format.
InvalidHttpVerb Bad Request (400) The HTTP verb specified was not recognized by the server.
InvalidInput Bad Request (400) One of the request inputs is not valid.
InvalidMd5 Bad Request (400) The MD5 value specified in the request is invalid. The MD5 value must be 128 bits and Base64-encoded.
InvalidMetadata Bad Request (400) The specified metadata is invalid. It includes characters that aren't permitted.
InvalidQueryParameterValue Bad Request (400) An invalid value was specified for one of the query parameters in the request URI.
InvalidRange Requested Range Not Satisfiable (416) The range specified is invalid for the current size of the resource.
InvalidResourceName Bad Request (400) The specified resource name contains invalid characters.
InvalidUri Bad Request (400) The requested URI doesn't represent any resource on the server.
InvalidXmlDocument Bad Request (400) The specified XML is not syntactically valid.
InvalidXmlNodeValue Bad Request (400) The value provided for one of the XML nodes in the request body was not in the correct format.
KeyVaultAccessTokenCannotBeAcquired Forbidden (403) Unable to acquire an access token for key vault from Microsoft Entra using the identity of this resource.
KeyVaultEncryptionKeyNotFound Forbidden (403) The key vault key is not found to unwrap the encryption key.
KeyVaultVaultNotFound Forbidden (403) The key vault vault is not found.
Md5Mismatch Bad Request (400) The MD5 value specified in the request did not match the MD5 value calculated by the server.
MetadataTooLarge Bad Request (400) The size of the specified metadata exceeds the maximum size permitted.
MissingContentLengthHeader Length Required (411) The Content-Length header was not specified.
MissingRequiredQueryParameter Bad Request (400) A required query parameter was not specified for this request.
MissingRequiredHeader Bad Request (400) A required HTTP header wasn't specified.
MissingRequiredXmlNode Bad Request (400) A required XML node wasn't specified in the request body.
MultipleConditionHeadersNotSupported Bad Request (400) Multiple condition headers aren't supported.
OperationTimedOut Internal Server Error (500) The operation could not be completed within the permitted time. The operation may or may not have succeeded on the server side. Please query the server state before retrying the operation.
OutOfRangeInput Bad Request (400) One of the request inputs is out of range.
OutOfRangeQueryParameterValue Bad Request (400) A query parameter specified in the request URI is outside the permissible range.
RequestBodyTooLarge Request Entity Too Large (413) The size of the request body exceeds the maximum size permitted.
ResourceTypeMismatch Conflict (409) The specified resource type doesn't match the type of the existing resource.
RequestUrlFailedToParse Bad Request (400) The url in the request could not be parsed.
ResourceAlreadyExists Conflict (409) The specified resource already exists.
ResourceNotFound Not Found (404) The specified resource doesn't exist.
ServerBusy Service Unavailable (503) The server is currently unable to receive requests. Please retry your request.
ServerBusy Service Unavailable (503) Ingress is over the account limit.
ServerBusy Service Unavailable (503) Egress is over the account limit.
ServerBusy Service Unavailable (503) Operations per second is over the account limit.
UnsupportedHeader Bad Request (400) One of the HTTP headers specified in the request isn't supported.
UnsupportedXmlNode Bad Request (400) One of the XML nodes specified in the request body isn't supported.
UnsupportedQueryParameter Bad Request (400) One of the query parameters specified in the request URI isn't supported.
UnsupportedHttpVerb Method Not Allowed (405) The resource doesn't support the specified HTTP verb.

See also

Blob Storage error codes
Queue Storage error codes
Table Storage error codes
Azure Files error codes
Troubleshoot API operations
HttpStatusCode enumeration
Azure Storage REST API reference