Microsoft Graph List places API在美国国家云环境的支持性及调用报错问题

首先明确：List places API是支持美国国家云环境（包括GCC和DoD云端点）的，你遇到的400 Bad Request大概率是调用配置或参数的问题，而非API本身不支持。下面给你梳理排查步骤和验证方法：

一、确认API在国家云中的可用性 #

你可以通过两种方式验证该API是否在目标国家云中支持：

• 查看国家云专属的Graph服务清单：微软针对每个国家云都维护了对应的API支持矩阵，你可以在国家云的专属Graph文档站点中搜索List places条目，确认它是否在支持范围内。
• 调用元数据端点验证：访问对应国家云的Graph元数据URL，比如：
  • GCC环境：https://graph.microsoft.us/v1.0/$metadata
  • DoD环境：https://dod-graph.microsoft.us/v1.0/$metadata
    在返回的XML中搜索place相关的实体和集合操作，如果能找到places/microsoft.graph.room的定义，就说明该API是支持的。

二、排查400 Bad Request的可能原因 #

1. 访问令牌不匹配国家云环境 #

这是最常见的问题：

• 确保你的令牌是从对应国家云的Azure AD授权端点获取的：
  • GCC环境：授权端点为https://login.microsoftonline.us
  • DoD环境：授权端点为https://login.microsoftonline.us（DoD和GCC High共用此端点）
• 检查令牌的aud（受众）声明：必须匹配目标国家云的Graph端点（GCC是https://graph.microsoft.us，DoD是https://dod-graph.microsoft.us）。如果令牌是针对全局Graph（https://graph.microsoft.com）生成的，调用国家云端点必然会报错。

2. 请求参数的限制差异 #

虽然全局端点允许$top=5000，但部分国家云的Graph API对分页参数的上限可能更严格（比如部分端点上限为999）。你可以先尝试将$top改为999，看是否能正常返回结果。

3. 请求头或格式问题 #

• 确保Authorization头格式正确：必须是Bearer <你的访问令牌>，注意Bearer后面的空格。
• 显式添加Accept: application/json请求头，部分国家云环境对请求格式的要求比全局更严格。

4. API路径拼写错误 #

仔细检查请求URL：确认/places/microsoft.graph.room的拼写完全正确，比如room是小写、microsoft.graph.room的点号没有遗漏。

三、额外配置注意事项 #

如果使用Microsoft Graph SDK（比如Java SDK）调用，需要手动配置SDK指向国家云端点，而不是默认的全局端点。例如在Spring Boot中初始化GraphServiceClient时，要把服务URL设置为https://graph.microsoft.us或https://dod-graph.microsoft.us，而不是默认的https://graph.microsoft.com。

另外，权限要求和全局环境一致：确保你的应用或用户已被授予Place.Read.All或Place.ReadWrite.All权限，且权限是在对应国家云的Azure AD租户中授予的。

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