调用Databricks API创建Repo时遇权限及路径问题求助

1. 权限错误：permission_denied missing required permissions view on node with id '0' #

这个错误指向Workspace根节点（node id '0'）的权限缺失，说明请求身份（Bearer token对应的服务主体/用户）没有Workspace根目录的View权限，同时可能缺少Repo操作权限：

• 检查服务主体是否已添加到Databricks Workspace：在Workspace的Admin Console > Users & Groups中确认该SP存在，且至少拥有Workspace Access权限（基础View权限）。
• 分配Repo操作权限：在Admin Console > Permissions > Repos中，给该SP分配Can Manage Repos权限（或至少Can Read+Can Create权限）。
• 确认Git凭据关联：确保创建的Git凭据关联到该服务主体，且凭据拥有Azure DevOps仓库的克隆权限。

2. 路径不识别错误：无法识别/Repos或/Repos/{Folder} #

Databricks Repos的路径有严格格式要求：必须是/Repos/<identity-email>/<repo-target-name>，其中：

• <identity-email>是请求身份（服务主体或用户）的邮箱地址，服务主体的邮箱通常为{sp-client-id}@{tenant-id}.onmicrosoft.com。
• <repo-target-name>是你要在Databricks中创建的Repo文件夹名称，/Repos是根容器，每个身份的Repo必须放在专属子目录下，不能直接作为目标路径。
  示例正确路径：/Repos/sp-dev@contoso.onmicrosoft.com/MyProjectRepo

3. GET REPOS接口返回空结果 #

• 权限限制：当前请求身份没有权限查看已创建的Repo，比如Repo在其他用户的/Repos/<user-email>/目录下，而你没有该目录的访问权限。
• 身份不一致：确保GET请求使用的Bearer token和创建Repo时的身份一致，只有创建者或拥有权限的身份才能查看对应Repo。

4. Python请求报400 Bad Request #

常见原因及修复：

• JSON序列化错误：使用requests.post()时，需传json=payload参数，而非data=payload（后者会将数据按表单提交，导致格式错误）。
• 参数格式错误：检查sparse_checkout.patterns的格式，确保为数组类型，且路径符合Git稀疏检出规则。
• 请求头问题：必须携带Content-Type: application/json和有效的Bearer <token>头；Azure SP的两个专属头（X-Databricks-Azure-SP-Management-Token、X-Databricks-Azure-Workspace-Resource-Id）仅在服务主体直接认证时需要，若已使用通过SP获取的Databricks Bearer token，则无需重复添加。

额外验证步骤 #

• UI手动创建Repo：先在Databricks UI中尝试克隆同一个Azure DevOps仓库，确认Git凭据和权限是否正常，排除仓库本身的访问问题。
• 验证token有效性：调用GET /api/2.0/workspace/list接口并传入根路径/，若返回权限错误，说明token对应的身份确实没有Workspace访问权限。

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