更新代理版本
MongoDB Ops Manager v6.0 将于 2025 1 月 EOL。 尽快升级到更高的MongoDB Ops Manager版本。
此端点将 MongoDB Agent 和工具更新到请求时可用的最新版本：
此请求完成后，Ops Manager 会修改代理配置并保存更新后的版本。
所需角色
此资源需要 Project Automation Admin角色。
资源
基本 URL： https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
POST /groups/{PROJECT-ID}/automationConfig/updateAgentVersions
请求
路径参数
名称 | 类型 | 必要性 | 说明 |
|---|---|---|---|
PROJECT-ID | 字符串 | 必需 | 拥有自动化配置的群组的唯一标识符。 |
查询参数
以下查询参数为可选参数：
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 美观打印 的标志 格式。 | false | ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题，可在查询中设置 envelope=true。 对于返回一个结果的端点，响应体包括：
| false |
正文参数
名称 | 类型 | 必要性 | 说明 |
|---|---|---|---|
AutomationAgentVersion | 字符串 | Optional | 您要将 MongoDB Agent 更新到的版本。 |
biConnectorVersion | 字符串 | Optional | 要将BI Connector更新到的版本。 |
mongoDbToolsVersion | 字符串 | Optional | 要将MongoDB database工具更新到的版本 |
响应
参数 | 类型 | 说明 |
|---|---|---|
AutomationAgentVersion | 字符串 | 指定项目中的 MongoDB Agent 版本。 |
backupAgentVersion | 字符串 | 指定项目中备份代理的版本。 Ops Manager 已删除备份代理，因此此参数应返回null 。 |
biConnectorVersion | 字符串 | 指定项目中MongoDB connector for BI的版本。 |
mongoDbToolsVersion | 字符串 | 指定项目中的 MongoDB Database Tools 版本。 |
MonitoringAgentVersion | 字符串 | 指定项目中监控代理的版本。 Ops 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://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \ 6 --data '{ 7 "automationAgentVersion": "10.14.31.6566" 8 }'
响应示例
响应标头
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
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": "10.14.31.6566", 3 "backupAgentVersion" : null, 4 "biConnectorVersion" : "2.14.0", 5 "mongoDbToolsVersion" : null, 6 "monitoringAgentVersion" : null 7 }