对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

atlas api mongoDbCloudUsers listGroupUsers

返回与指定项目关联的待处理和活跃的 MongoDB Cloud 用户的详细信息。

atlas api 子命令是从 MongoDB Atlas Admin API 自动生成的,并提供对 Admin API 的全面覆盖。Admin API功能有自己的发布生命周期,您可以通过提供的API终结点文档链接进行检查。

要使用此资源,请求的服务帐户或API密钥必须具有“项目只读”角色。

注意:此资源不能用于查看通过已弃用的邀请一位 MongoDB Cloud 用户加入一个项目终结点邀请的用户的详细信息。

注意:要返回待处理和活跃用户,请使用 v2-{2025-02-19} 或更高版本。如果使用的是弃用版本,则只会返回活跃用户。

此命令是自动生成的,对应于 1:1 与 Atlas API 终结点 https://www.mongodb.com/zh-cn/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupusers.

有关更多信息和示例,请参阅上面链接的参考API文档。

命令语法
atlas api mongoDbCloudUsers listGroupUsers [options]
名称
类型
必需
说明

--envelope

envelope

false

指示应用程序是否将响应包装在信封JSON对象中的标志。某些API客户端无法访问权限HTTP响应标头或状态代码。要修复此问题,请在查询中设立Envelope=true。返回结果列表的端点将结果对象用作信封。应用程序将状态参数添加到响应正文中。

--flattenTeams

"flattenTeams" : false

false

指示返回的列表是否应包含属于在此项目中具有角色的团队的用户的标志。您可能没有在此项目中为各个用户分配角色。如果 "flattenTeams": false,则此资源仅返回在项目中具有角色的用户。如果为 "flattenTeams" : true,则此资源会返回在项目中具有角色的用户以及属于在项目中具有角色的团队的用户。

--groupId

字符串

true

用于标识项目的唯一 24-十六进制数字字符串。 使用 [/groups](# 标签/Projects/operation/listProjects) 端点检索身份验证的用户有权访问权限的所有项目。

注意:群组和项目是同义词。您的群组 ID 与项目 ID 相同。对于现有群组,群组/项目 ID 保持不变。资源和相应的端点使用“群组”一词。

-h,--help

false

listGroupUsers 帮助

--includeCount

false

标志,用于指示响应是否返回响应中的列项总数 (totalCount)。

--includeOrgUsers

"includeOrgUsers": false

false

指示返回的列表是否应包含对项目具有隐式访问权限的用户、组织所有者或组织只读角色的标志。您可能没有在此项目中为各个用户分配角色。如果 "includeOrgUsers": false,则此资源仅返回在项目中具有角色的用户。如果为 "includeOrgUsers": true,则此资源将返回在项目中具有角色的用户以及通过其组织角色对项目具有隐式访问权限权限的用户。

--itemsPerPage

int

false

响应每页返回的列项数。

--orgMembershipStatus

字符串

false

指示是否按用户的组织成员资格状态过滤返回列表的标志。如果排除此参数,此资源将返回待处理和活跃用户。已弃用版本不予支持。

-o, --output

字符串

false

首选API格式,可以是 ["JSON", go-template] 此值默认为 "JSON"。

--outputFile

字符串

false

要将API输出写入其中的文件。 当端点的输出为二进制(例如:gzip)且命令未通过管道传输(例如: Atlas command > out.zip)时,需要使用此标志

--pageNum

int

false

显示响应返回的当前总对象集的页面编号。

--pretty

false

指示响应正文是否应采用 prettyprint 格式的标记。

--username

字符串

false

用于过滤用户的电子邮件地址。已弃用版本不予支持。

--version

字符串

false

进行API调用时要使用的API版本 [选项:"2023-01-01"、"2025-02-19"],默认为最新版本或配置文件 api_version配置值,如果设立此值,则默认为 "2025-02-19"。

名称
类型
必需
说明

-P, --profile

字符串

false

要从您的配置文件中使用的配置文件的名称。要学习;了解Atlas CLI配置文件,请参阅 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.

atlas api mongoDbCloudUsers listGroupUsers --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --orgMembershipStatus ACTIVE