Power Automate中Azure Cosmos DB的Get a document (V2)连接器失效求助

问题场景 #

使用Power Automate的Get a document (V2)连接器，通过已存在的GUID主键从Azure Cosmos DB容器获取记录时，始终返回NotFound错误，错误信息如下：

{
"code": "NotFound",
"message": "Entity with the specified id does not exist in the system. More info: https://aka.ms/cosmosdb-tsg-not-found, {....}
}

排查解决步骤 #

• 确认分区键参数正确：Cosmos DB的单文档查询必须同时匹配ID和分区键值。如果容器设置了分区键，仅传入ID会因为跨分区无法定位记录。检查连接器配置中是否正确填写了分区键对应的字段和值。
• 验证ID的大小写与格式：Cosmos DB的ID是大小写敏感的，即使是GUID，也要保证传入的格式（如是否带大括号、连字符位置）与容器中存储的记录完全一致。可以直接从Cosmos DB数据资源管理器复制目标记录的ID，粘贴到Power Automate参数中测试。
• 核对数据库与容器名称：检查连接器配置的数据库名、容器名是否与目标资源完全匹配，注意名称的大小写和拼写错误。
• 直接调用API验证：使用Cosmos DB REST API或Azure CLI执行相同的Get操作，传入相同的ID和分区键。如果API能成功返回记录，说明Power Automate连接器配置存在问题；如果API也失败，需确认记录是否真的存在（如未被误删）或权限是否足够。
• 检查权限配置：确认Power Automate使用的Cosmos DB连接字符串或服务主体拥有至少Read权限，部分场景下权限不足会伪装成"记录不存在"的错误。
• 切换连接器版本或重建连接：尝试使用Get a document (V1)版本，或重新创建Cosmos DB连接器，排除版本兼容或连接配置异常的问题。

内容的提问来源于stack exchange，提问作者Munavvar Husein Shaikh