エージェントのバージョンの更新

MongoDB Ops Manager v6.0 は 1 月 2025 で EOL になります。可能な限りすぐに MongoDB Ops Manager の上位バージョンにアップグレードしてください。

このエンドポイントは、MongoDB Agent とツールを、リクエストの時点で利用可能な最新バージョンに更新します。

このリクエストが完了すると、 MongoDB Ops Managerはエージェント構成を変更し、更新されたバージョンを保存します。

必須のロール

このリソースには Project Automation Adminロールが必要です。

Resource

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

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

リクエスト

path パラメータ

名前	タイプ	必要性	説明
プロジェクトID	string	必須	オートメーション構成を所有するグループの一意の識別子。

クエリパラメータ

次のクエリパラメータは任意です。

名前

タイプ

必要性

説明

default

pretty

ブール値

任意

レスポンス本体を pretty-print にするかどうかを示すフラグ形式。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部の APIクライアントは、 HTTPレスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリでenvelope=trueを設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

名前	説明
状態	HTTPレスポンスコード
envelope	期待される応答本体

false

ボディパラメータ

名前	タイプ	必要性	説明
automationAgentVersion	string	任意	MongoDB Agent を更新するバージョン。
bioConnectorVersion	string	任意	BI Connectorを更新するバージョン。
mongoDbToolsVersion	string	任意	MongoDB Database Toolsを更新するバージョン

応答

Parameter	タイプ	説明
automationAgentVersion	string	指定されたプロジェクト内の MongoDB Agent のバージョン。
backupAgentVersion	string	指定されたプロジェクト内のバックアップエージェントのバージョン。 MongoDB Ops Manager はバックアップエージェントを削除したため、このパラメーターはnullを返す必要があります。
bioConnectorVersion	string	指定されたプロジェクト内のMongoDB Connector for BIのバージョン。
mongoDbToolsVersion	string	指定されたプロジェクト内の MongoDB Database Tools のバージョン。
monitoringAgentVersion	string	指定されたプロジェクト内のモニタリングエージェントのバージョン。 MongoDB 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      }'

応答例

応答ヘッダー

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": "10.14.31.6566",
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://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \
6	--data '{
7	"automationAgentVersion": "10.14.31.6566"
8	}'

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