Azure按标签过滤资源时OR运算符失效，报错如何解决？

问题背景 #

使用Azure SDK for .NET编写C#代码按标签列出资源时，使用AND运算符过滤标签可正常运行，但使用OR运算符（如filterTags = "tagName eq 'asdf' or tagValue eq '1234'"）时，服务器返回400错误（错误码InvalidFilterInQueryString），提示过滤器无效。IntelliSense文档仅提供AND运算符的使用示例，需确认是否真的不支持OR运算符。

代码示例 #

using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Veeam.Core.Extensions;

string clientId = "...";
string tenantId = "...";
var clientSecret = "...";
string subscriptionId = "...";

// 使用AND运算符正常，OR运算符失效
var filterTags = "tagName eq 'asdf' or tagValue eq '1234'";

var e = ArmEnvironment.AzurePublicCloud;
var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
var armClient = new ArmClient(credential);
var subscription = armClient.GetSubscriptionResource(new ResourceIdentifier("/subscriptions/" + subscriptionId));
var resourcesPageable= subscription.GetGenericResourcesAsync(filter: filterTags);
var tempResources = await resourcesPageable.ToListAsync();
Console.WriteLine(tempResources.Count);

服务器响应 #

Status: 400 (Bad Request)
ErrorCode: InvalidFilterInQueryString

Content:
{"error":{"code":"InvalidFilterInQueryString","message":"Invalid $filter 'tagName eq 'asdf' and tagValue '1234'' specified in the query string."}}

IntelliSense文档说明 #

示例：要按标签名称和值过滤，使用$filter=tagName eq 'tag1' and tagValue eq 'Value1'。按标签名称和值过滤时，结果中不会返回资源的标签。

解答 #

Azure Resource Manager（ARM）的资源列表API确实不支持在标签过滤中使用OR运算符，仅支持AND组合tagName和tagValue的过滤条件。这是ARM API本身的限制，Azure SDK只是对底层API的封装，因此IntelliSense文档仅提供AND运算符的示例。

如果需要实现OR逻辑的标签过滤，只能通过客户端侧处理：分别获取符合每个单个条件的资源，再合并去重。示例代码如下：

// 分别获取两个条件的资源
var filter1 = "tagName eq 'asdf'";
var filter2 = "tagValue eq '1234'";

var resources1 = await subscription.GetGenericResourcesAsync(filter: filter1).ToListAsync();
var resources2 = await subscription.GetGenericResourcesAsync(filter: filter2).ToListAsync();

// 合并并去重（通过资源ID判断唯一性）
var combinedResources = resources1.Concat(resources2)
                                  .GroupBy(r => r.Id)
                                  .Select(g => g.First())
                                  .ToList();

Console.WriteLine(combinedResources.Count);

注意：这种方式会发起两次API请求，如果订阅内资源量较大，可能会影响性能，需根据实际场景评估是否适用。

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