Troubleshooting notes - MissingRequiredHeader: x-ms-file-request-intent Error - Azure File Share Authentication

Azure File Share access issue - Missing Intent

An HTTP header that’s mandatory for this request is not specified. RequestId:38183809-a01a-00d5–4a98-c8ae50000000 Time:2026–04–10T03:16:22.7035119Z Status: 400 (An HTTP header that’s mandatory for this request is not specified. ) ErrorCode: MissingRequiredHeader Additional Information: HeaderName: x-ms-file-request-intent Content:

MissingRequiredHeader

An HTTP header that’s mandatory for this request is not specified. RequestId:38183809-a01a-00d5–4a98-c8ae50000000 Time:2026–04–10T03:16:22.7035119Z x-ms-file-request-intent Headers: Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: 38183809-a01a-00d5–4a98-c8ae50000000 x-ms-client-request-id: 0aa9dd72–8222–4569-bc57–84f7815ca73d x-ms-version: 2026–02–06 x-ms-error-code: MissingRequiredHeader Date: Fri, 10 Apr 2026 03:16:22 GMT Content-Length: 305 Content-Type: application/xml

Azure File Share + OAuth/Managed Identity requires ShareTokenIntent.Backup set in ShareClientOptions. This is not needed for key-based access and is not automatically injected by the SDK. Forgetting it produces a 400 MissingRequiredHeader: x-ms-file-request-intent error. The enum value name is misleading - it is not backup-specific, it is the mandatory OAuth intent declaration for all file share data-plane operations.