无法通过REST API为Azure DevOps管道授予安全文件权限

我有一个Azure DevOps管道，会将安全文件发布到管道库。希望通过REST API立即为指定管道授予该文件的权限，避免手动操作。参考了官方的Pipeline Permissions更新API，但请求返回200 OK但count为0，权限未设置成功。

我的PATCH请求 #

curl --location --request PATCH 'https://dev.azure.com/{myOrganization}/{myProject}/_apis/pipelines/pipelinepermissions?api-version=7.0-preview.1' \
--header 'Authorization: Basic {myAuth}' \
--header 'Content-Type: application/json' \
--data-raw '[
  {
    "resource": {
      "type": "secureFile",
      "id": "{mySecureFileId}"
    },
    "pipelines": [
      {
        "id": {myPipelineId},
        "authorized": true
      }
    ]
  }
]'

相关ID来源 #

• 安全文件ID：取自库中安全文件详情页URL的secureFileId参数
• 管道ID：取自管道详情页URL的definitionId参数

请求返回结果 #

Status: 200 OK

{
    "count": 0,
    "value": []
}

已确认修改不存在的secureFileId或pipelineId会返回404，说明资源ID和请求语法无错误，但权限始终未设置成功，以下是排查思路：

• 检查API版本兼容性：尝试更换为更新的API版本，比如7.1-preview.1，旧预览版可能存在功能缺陷。
• 验证Pipeline ID类型：确保pipelines.id是纯数字（无引号包裹），API要求该字段为整数类型。
• 取消权限继承：如果安全文件权限设置为继承自项目，需先在UI中取消继承，再通过API设置单独权限。
• 确认账号权限：发起请求的账号需拥有管理安全文件权限的权限（如项目管理员、库管理员），否则无法修改权限。
• 明确覆盖全局规则：在请求体中添加"allPipelines": {"authorized": false}，指定仅授权目标管道，避免继承规则干扰，修改后的请求体示例：

  [
    {
      "resource": {
        "type": "secureFile",
        "id": "{mySecureFileId}"
      },
      "allPipelines": {
        "authorized": false
      },
      "pipelines": [
        {
          "id": {myPipelineId},
          "authorized": true
        }
      ]
    }
  ]
  

• 查询当前权限状态：调用GET接口https://dev.azure.com/{org}/{proj}/_apis/pipelines/pipelinepermissions?api-version=7.0-preview.1，查看安全文件的现有权限配置，确认是否存在规则冲突。
• 校验JSON格式：使用JSON校验工具检查请求体，确保无语法错误（如逗号遗漏、引号不匹配）。

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