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

获取一个项目的所有代理 API 密钥

基本 URL: https://cloud.mongodb.com/api/public/v1.0

GET /groups/{PROJECT-ID}/agentapikeys

此端点仅限具有Project Read Only角色的用户使用。

名称
类型
说明

PROJECT-ID

字符串

拥有代理 API 密钥的项目的唯一标识符。

以下查询参数为可选参数:

名称
类型
必要性
说明
默认

pretty

布尔

Optional

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

false

envelope

布尔

Optional

指示是否将响应包装在信封中的标志。

某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。

对于返回一个结果的端点,响应体包括:

  • status: HTTP 响应代码

  • content:预期响应正文

false

此端点不使用 HTTP 请求正文参数。

名称
类型
说明

id

字符串

此代理 API 密钥的唯一标识符。

key

字符串

代理 API 密钥。

创建此代理 API 密钥后,后续请求将返回代理 API 密钥的最后四个字符。

desc

字符串

此代理 API 密钥的标签。 限制为 1,000 个字符。

createdTime

字符串

Timestamp in ISO 8601 date and time format in UTC when the Agent API Key was created.

createdUserId

字符串

创建此代理 API 密钥的用户的唯一标识符。

createdIpAddr

字符串

创建此代理 API 密钥的IP地址。

createdBy

字符串

此代理 API 密钥的来源。 接受的值为:

  • USER

  • OLD_KEY

  • PROVISIONING

  • ATLAS

  • PUBLIC_API

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/agentapikeys?pretty=true"
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
[ { "_id" : "{AGENT-API-KEY-ID-1}", "createdBy" : "PUBLIC_API", "createdIpAddr" : "{IP-ADDRESS-1}", "createdTime" : 1520458807291, "createdUserId" : "{USER-ID-1}", "desc" : "Agent API Key for this project", "key" : "****************************8b87"}, { "_id" : "{AGENT-API-KEY-ID-2}", "createdBy" : "PROVISIONING", "createdTime" : 1508871142864, "desc" : "Generated by Provisioning", "key" : "****************************39fe"}, { "_id" : "{AGENT-API-KEY-ID-3}", "createdBy" : "USER", "createdIpAddr" : "{IP-ADDRESS-2}", "createdTime" : 1507067499083, "createdUserId" : "{USER-ID-2}", "desc" : "Initial API Key", "key" : "****************************70d7"} ]