更新代理版本

2024 年 8 月 30 日以后，Cloud Manager 将不再支持 MongoDB 3.6 和 4.0 的自动化、备份和监控。请升级您的 MongoDB 部署或迁移到 Atlas。

用于以编程访问权限Cloud Manager的 OAuth 2.0身份验证作为预览功能。: 在预览期间，功能和相应的文档可能随时更改。要使用 OAuth2.0 身份验证，请创建一个服务帐户，以便在向Cloud Manager Public API发出的请求中使用。

此端点将 MongoDB Agent 和工具更新到请求时可用的最新版本：

此请求完成后，Cloud Manager 会修改代理配置并保存更新后的版本。

所需角色

此资源需要 Project Automation Admin角色。

Resource

基本 URL： https://cloud.mongodb.com/api/public/v 1.0

POST /groups/{PROJECT-ID}/automationConfig/updateAgentVersions

请求

路径参数

名称	类型	必要性	说明
PROJECT-ID	字符串	必需	拥有自动化配置的群组的唯一标识符。

查询参数

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

名称

类型

必要性

说明

默认

pretty

布尔

Optional

指示响应正文是否应采用美观打印的标志格式。

false

envelope

布尔

Optional

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

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

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

名称	说明
`status`	HTTP 响应代码
`content`	预期响应正文

false

正文参数

名称	类型	必要性	说明
AutomationAgentVersion	字符串	Optional	您要将 MongoDB Agent 更新到的版本。
biConnectorVersion	字符串	Optional	要将BI Connector更新到的版本。
mongoDbToolsVersion	字符串	Optional	要将MongoDB database工具更新到的版本

响应

Parameter	类型	说明
AutomationAgentVersion	字符串	指定项目中的 MongoDB Agent 版本。
backupAgentVersion	字符串	指定项目中备份代理的版本。 Cloud Manager 已删除备份代理，因此此参数应返回null 。
biConnectorVersion	字符串	指定项目中MongoDB connector for BI的版本。
mongoDbToolsVersion	字符串	指定项目中的 MongoDB Database Tools 版本。
MonitoringAgentVersion	字符串	指定项目中监控代理的版本。 Cloud Manager 已删除监控代理，因此此参数应返回null 。

请求示例

1 curl --user "{publicApiKey}:{privateApiKey}" --digest \
2      --header "Accept: application/json" \
3      --header "Content-Type: application/json" \
4      --include \
5      --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \
6      --data '{
7        "automationAgentVersion": "11.11.0.7355"
8      }'

响应示例

响应标头

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

响应体

1 {
2   "automationAgentVersion": "11.11.0.7355",
3   "backupAgentVersion" : null,
4   "biConnectorVersion" : "2.14.0",
5   "mongoDbToolsVersion" : null,
6   "monitoringAgentVersion" : null
7 }

后退

自动化配置示例

来年

1	curl --user "{publicApiKey}:{privateApiKey}" --digest \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--include \
5	--request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \
6	--data '{
7	"automationAgentVersion": "11.11.0.7355"
8	}'

1	{
2	"automationAgentVersion": "11.11.0.7355",
3	"backupAgentVersion" : null,
4	"biConnectorVersion" : "2.14.0",
5	"mongoDbToolsVersion" : null,
6	"monitoringAgentVersion" : null
7	}