Edit

Troubleshoot ClientOtherErrors in Azure Files

  • Artikel

This article lists the ClientOtherErrors you might encounter when using SMB Azure file shares. In general, ClientOtherErrors are mostly harmless and expected errors. Requests fail, but the system continues to behave as expected. It's normal to see a significant amount of these errors logged.

Applies to

File share type SMB NFS
Standard file shares (GPv2), LRS/ZRS
Standard file shares (GPv2), GRS/GZRS
Premium file shares (FileStorage), LRS/ZRS

What are ClientOtherErrors?

ClientOtherError usually means expected client-side errors, such as "not found" and "resource already exists." In the server-side storage log files, these operations are recorded with a transaction status of ClientOtherErrors.

For example, the Windows SMB client that interacts with remote file systems doesn't always know the capabilities of the remote file system. It could be Windows Server, Azure Files, or some other SMB server implementation. Therefore, the SMB client will make calls to the remote file server with certain APIs. If these APIs fail, it will fall back to using a different API or even just ignore these errors. Depending on the request/response protocol of SMB, a large number of requests are expected to fail even though the system has behaved correctly. This can be due to authorization failures, attempts to create a file with a name that already exists, or attempts to open a file that doesn't exist.

Logging and reporting

To troubleshoot ClientOtherErrors, you can create a diagnostic setting and use Azure Monitor for reporting. You can also analyze logs to view failed requests, including ClientOtherErrors, or use Kusto queries.

You can also collect a ProcMon trace from a client that matches the IP address shown in the logs. Add a filter to see only traffic to Azure Files.

Common ClientOtherErrors

The following table lists common ClientOtherErrors, along with an explanation of each error.

Operation Status Explanation of error
QueryFullEaInformation STATUS_NOT_IMPLEMENTED This failure is returned because Azure Files doesn't implement this API. Azure Files doesn't support extended attributes currently.
UnknownFileClass=48 STATUS_NOT_SUPPORTED This is the FileNormalizedNameInformation API call. This is new support for Windows Server, and currently Azure Files doesn't support this API.
FileOpen 492 STATUS_ACCESS_DENIED The caller doesn't have the required permissions to open the file. In the case of Kerberos access, the ACL denies the caller access.
FileOpen 257 STATUS_OBJECT_NAME_INVALID The path for the open request is invalid (for example, the path is too long or too deep).
FileOpen 12 STATUS_FILE_IS_ADIRECTORY The caller is opening a directory without using the correct CreateFile parameters (for example, Backup intent).
FileOpen 8 STATUS_SHARING_VIOLATION The caller is opening a file that's already opened with restrictions (for example, exclusive or others can only read).
FileOpen 6 STATUS_OBJECT_NAME_NOT_FOUND The caller is opening a file that doesn't exist.
FSCTL_QUERY_NETWORK_INTERFACE_INFO (IOCTL) STATUS_INVALID_DEVICE_REQUEST This is used only for Azure Files when customers have enabled the multichannel feature. In other cases, it's not needed, and we return an invalid device request when queried from the client.
QueryStreamInformation STATUS_NOT_IMPLEMENTED Some file systems have the concept of alternate data streams or other streams like reparse point stream. Azure Files doesn't have this concept, so we don't support the API.
Unexpected (IOCTL) STATUS_INVALID_DEVICE_REQUEST This is FSCTL_QUERY_FILE_REGIONS, a region concept that's specific to NTFS/refs and doesn't make sense in relation to Azure Files. So we don't implement this FSCTL code.
ChangeNotify STATUS_CANCELLED Applications like Windows Shell Explorer subscribe to change notifications for files. This way, when properties change on a file, Windows Shell Explorer automatically updates in the view. The client can choose to cancel this subscription (for example, if the user has changed views in Explorer and no longer needs it). In that case, we send STATUS_CANCELLED back to the client to acknowledge that the subscription has been canceled.
FSCTL_DFS_GET_REFERRALS (IOCTL) STATUS_FS_DRIVER_REQUIRED This is a DFS referral request. Azure Files doesn't support DFS, and this is the correct status to return when the system doesn't support DFS.
FileSupersede STATUS_ACCESS_DENIED File supersede is an operation where an existing file is deleted and a new file is put in its place. If the caller doesn't have permission to delete the existing file, the call will fail.
FileCreate 7 STATUS_OBJECT_NAME_INVALID This happens when a request to create a new file has an invalid requested name (for example, using unsupported characters).
FileCreate 3 STATUS_OBJECT_NAME_COLLISION This happens when a request to create a new file has a requested name that matches an existing file.
Read STATUS_ACCESS_DENIED This happens when a read request is done on a file with a handle that doesn't have the granted access of read (for example, the file was opened with the desired write access).
TreeConnect STATUS_ACCESS_DENIED In the context of Kerberos authentication, the caller doesn't have share-level permissions assigned via RBAC or the "Default Share Permissions" feature. If the "Default Share Permissions" feature isn't set, callers who are computer identities will consistently get this access failure on the share.

See also

Contact us for help

If you have questions or need help, create a support request, or ask Azure community support. You can also submit product feedback to Azure feedback community.