API Management调用Azure Blob List接口报查询参数无效错误

核心配置错误出在set-backend-service策略的使用上：

• 该策略的base-url属性仅支持配置后端服务的基础路径，不支持直接携带查询字符串。你将restype=directory&comp=list&prefix=globalpackages/1.0这串查询参数直接写入base-url后，APIM转发请求时会对这部分参数做错误的拼接、转义处理，最终传到Blob存储的comp参数格式不符合接口要求，触发InvalidQueryParameterValue错误。
• 额外注意：如果你使用的是普通通用v2存储账户（未启用分层命名空间），列出容器内Blob的官方接口要求restype取值为container而非directory；如果是启用了ADLS Gen2的存储账户要列目录内容，你当前配置的x-ms-version: 2017-11-09版本过低，不支持Gen2的目录操作接口。

按以下步骤调整inbound节点内的策略即可：

• 修正后端服务基础地址配置，移除base-url中所有查询参数，仅保留到容器级路径：

  <set-backend-service base-url="https://<storageaccount>.blob.core.windows.net/files" />
  

• 新增查询参数设置策略，单独声明所有需要传给Blob存储的查询参数，避免拼接异常：

  <!-- 普通Blob存储用restype=container，ADLS Gen2列目录可改为restype=directory -->
  <set-query-parameter name="restype" exists-action="override">
      <value>container</value>
  </set-query-parameter>
  <set-query-parameter name="comp" exists-action="override">
      <value>list</value>
  </set-query-parameter>
  <set-query-parameter name="prefix" exists-action="override">
      <value>globalpackages/1.0</value>
  </set-query-parameter>
  

• 如果你使用的是ADLS Gen2存储账户，将x-ms-version调整为支持Gen2接口的稳定版本，例如：

  <set-header name="x-ms-version" exists-action="override">
      <value>2020-10-02</value>
  </set-header>
  

调整后APIM会按照标准格式拼接查询参数转发给Blob存储，不会再出现参数识别错误的问题。如果后续需要动态传入prefix值，只需要把对应参数的value改为从请求上下文读取即可，不需要硬编码。

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