使用Azure Face API时出现Resource Not Found错误的问题咨询

你提供的配置参考截图如下：

• 调用请求的API Key与URI配置：
  
• Azure门户Face API资源配置：
  

常见报错原因与对应解决方案 #

• 端点区域与资源创建区域不匹配
  这是该报错最常见的触发原因：Azure Face API的端点必须和你创建资源时选择的区域完全对应，比如你在「东亚」区域创建的资源，就不能使用「美国东部」的端点，手动拼接端点时很容易出现区域缩写拼写错误（比如把japaneast写成japanwest）、或者误用通用端点的问题。
  解决方法：进入Azure门户对应Face API资源的「概述」页面，直接复制官方提供的完整端点值，不要手动拼接，确保调用请求的URI前缀和复制的端点完全一致。
• API版本号拼写错误
  目前Face API仅支持v1.0稳定版和公开预览版两个版本，如果你在请求URI中将版本号写错（比如写成v2.0、v1），就会触发资源不存在错误。
  解决方法：检查请求URI中的版本号字段，生产环境优先使用稳定版v1.0，测试场景可以使用预览版。
• 接口路径拼写错误
  不同Face功能的接口路径是固定的，比如人脸检测的路径是/detect，人脸比对的路径是/findsimilars，如果路径拼写错误（比如多写后缀、拼写错误）也会返回404。
  解决方法：对照官方接口文档核对你调用的接口路径，确保拼写完全正确，无多余的斜杠或者拼写错误。
• 自定义子域名拼写错误
  如果你使用的是自定义子域名格式的端点（格式为https://<你的自定义资源名>.cognitiveservices.azure.com/），如果自定义资源名拼写错误，也会触发该报错。
  解决方法：核对门户中展示的自定义子域名，和你调用时使用的子域名完全一致。
• 资源状态异常
  如果你的Face API资源已经被删除、或者因为订阅欠费被禁用，访问时也会返回资源不存在。
  解决方法：进入Azure门户检查该资源的状态，确认资源处于「运行中」状态，且所属订阅没有欠费、没有权限限制。

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