此端点将 MongoDB Agent 和工具更新到请求时可用的最新版本:
此请求完成后,Cloud Manager 会修改代理配置并保存更新后的版本。
所需角色
此资源需要Project Automation Admin角色。
Resource
基本 URL: https://cloud.mongodb.com/api/public/v1.0
POST /groups/{PROJECT-ID}/automationConfig/updateAgentVersions请求
路径参数
名称 | 类型 | 必要性 | 说明 |
|---|---|---|---|
PROJECT-ID | 字符串 | 必需 | 拥有自动化配置的群组的唯一标识符。 |
查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 |
|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 prettyprint 格式的标记。 |
|
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
|
|
正文参数
名称 | 类型 | 必要性 | 说明 |
|---|---|---|---|
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 。 |
请求示例
curl --user "{publicApiKey}:{privateApiKey}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \ --data '{ "automationAgentVersion": "11.11.0.7355" }'响应示例
响应标头
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-aliveHTTP/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}响应体
{ "automationAgentVersion": "11.11.0.7355", "backupAgentVersion" : null, "biConnectorVersion" : "2.14.0", "mongoDbToolsVersion" : null, "monitoringAgentVersion" : null}