使用Azure Data Lake Storage Gen2 REST API与C#设置ACL权限遇必填头缺失错误

错误原因分析 #

你遇到的错误主要由以下几个问题导致：

• URL参数格式错误：action= setAccessControl中的空格会使服务无法正确识别setAccessControl操作，进而误判为缺少必填请求头。
• 请求体格式错误：将ACL配置包装为数组[{"acl": "..."}]不符合API要求，官方规定应为单个JSON对象。
• 冗余请求头：x-ms-date在Bearer令牌认证场景下非必填；若目标资源未设置租约，x-ms-lease-action头也无需添加，否则可能引发额外异常。

修正后的C#代码 #

static async Task SetUpPermissions(string accessToken)
{
    // Replace with your values
    string accountName = "<account-name>";
    string filesystem = "<container-name>";
    string directoryOrFile = "<file-name-with-path>";
    string userObjectId = "<user-object-id>";

    // 修正：移除action参数中的空格
    string url = $"https://{accountName}.dfs.core.windows.net/{filesystem}/{directoryOrFile}?action=setAccessControl";

    using (HttpClient client = new HttpClient())
    {
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
        client.DefaultRequestHeaders.Add("x-ms-version", "2023-08-03");
        // 修正：仅当资源有租约时添加x-ms-lease-action，否则移除
        // client.DefaultRequestHeaders.Add("x-ms-lease-action", "acquire-release");
        client.DefaultRequestHeaders.Add("x-ms-client-request-id", Guid.NewGuid().ToString());

        // Body with ACL settings
        string aclString = $"user:{userObjectId}:rwx,group::r-x,other::r--,mask::rwx,default:user:{userObjectId}:rwx,default:group::r-x,default:other::r--";
        // 修正：改为单个JSON对象而非数组
        string body = $"{{\"acl\": \"{aclString}\"}}";

        HttpContent content = new StringContent(body, Encoding.UTF8, "application/json");
        HttpResponseMessage response = await client.PatchAsync(url, content);

        if (response.IsSuccessStatusCode)
        {
            Console.WriteLine("ACL set successfully");
        }
        else
        {
            string responseBody = await response.Content.ReadAsStringAsync();
            Console.WriteLine($"Failed to set ACL: {response.StatusCode} {responseBody}");
        }
    }
}

额外注意事项 #

• 确保你的Bearer令牌拥有Storage Blob Data Owner或Storage Blob Data Contributor权限，且已授予目标存储账户的相应权限。
• 若目标目录/文件已存在租约，需保留x-ms-lease-action头，并确保租约ID正确（如果是已存在的租约，需使用x-ms-lease-id头指定）。

内容的提问来源于stack exchange，提问作者suisgrand