使用Microsoft Purview API时持续出现ResourceNotFound错误求助

1. 核对API端点拼写与正确性 #

你提到最初记录的端点是https://fhvidev.purview.azre.com/catalog（注意azre拼写错误），虽然请求中用了azure.com，但仍需在Azure Portal的Purview账户概述页确认官方提供的「目录API端点」，确保格式为https://{账户名}.purview.azure.com/catalog/api/atlas/v2/开头，没有遗漏catalog或路径层级错误。

2. 验证服务主体权限 #

• 确认服务主体pureviewap被直接授予Purview Data Catalog Contributor或更高权限（如Purview Data Catalog Administrator），权限需绑定到目标Purview账户，而非仅父资源组/订阅（继承权限可能存在延迟）。
• 权限分配后需等待5-30分钟让Azure RBAC同步，避免因权限未生效导致的访问问题。

3. 检查OAuth2令牌的有效性 #

• 解码获取的令牌，确认aud（受众）字段值为https://purview.azure.com，iss（颁发者）为你的Azure AD租户地址（格式如https://login.microsoftonline.com/{租户ID}/v2.0），受众错误会导致API拒绝请求。

4. 验证API路径与基础请求 #

• 尝试调用更基础的API测试，比如获取内置类型的请求：

  GET https://fhvidev.purview.azure.com/catalog/api/atlas/v2/types/typedefs/builtins
  

  若该请求仍返回404，说明端点或账户存在问题；若成功，则排查原请求的路径细节。

5. 确认Purview账户状态 #

• 在Azure Portal检查fhvidev账户是否处于运行中状态，无暂停、删除等异常；同时确认账户区域与端点匹配（主权云环境需对应特殊端点格式）。

6. 排查网络与防火墙限制 #

• 若Purview账户配置了防火墙，确保Postman所在IP在允许访问列表内，可临时关闭防火墙测试请求是否正常。
• 排除代理、VPN等网络工具的干扰，尝试直接在本地网络发起请求。

内容的提问来源于stack exchange，提问作者Vincent Diallo-Nort