Azure Purview API返回404错误求助(使用AD用户身份)
排查Purview Glossary API 404错误的步骤
针对你用Azure AD用户调用Purview术语表API返回404的问题,按以下步骤排查:
1. 确认API路径是否正确
你当前调用的是GET {endpoint}/datamap/api/atlas/v2/glossary,这个接口是获取默认术语表的专属接口。如果你的订阅中仅创建了自定义术语表、未配置默认术语表,调用该接口就会返回404。要列出所有术语表,需使用正确的列表接口:
GET {endpoint}/datamap/api/atlas/v2/glossary/glossaries
在官方文档的Try It工具中替换路径后重试即可。
2. 验证端点格式是否正确
确保{endpoint}替换为你的Purview账户完整域名,格式必须严格为:
https://<你的Purview账户名>.purview.azure.com
不要添加多余后缀或错误路径,比如避免/purview这类无效后缀。
3. 检查身份验证Token的权限有效性
在Try It工具中,确认登录的AD用户已获取到包含Purview权限的有效Token:
- 授权环节需勾选Purview相关权限范围(通常为
https://purview.azure.com/.default) - 可通过jwt.ms解码Token,检查
roles或scp声明是否包含你的Purview角色权限,确认权限已正确映射到Token中。
4. 确认术语表归属集合与权限匹配
虽然你持有Collection Admin等角色,仍需确认:
- 术语表所在的集合,你确实被分配了对应权限(可在Purview Studio中查看集合的权限分配记录)
- 若术语表位于子集合,需确保你的权限是直接分配或通过继承覆盖到该子集合的。
5. 确认术语表状态正常
在Purview Studio中检查目标术语表:
- 术语表确实存在,未被软删除
- 术语表状态为正常可用,无创建中或异常状态
内容的提问来源于stack exchange,提问作者user3766691
相关产品推荐
相关产品推荐

