에이전트 버전 업데이트

MongoDB Ops Manager v6.0 는 2025 1월에 EOL됩니다. 가능한 한 빨리 상위 MongoDB Ops Manager 버전으로 업그레이드하세요.

이 엔드포인트는 MongoDB Agent와 에이전트를 요청 시 사용 가능한 최신 버전으로 업데이트합니다.

이 요청이 완료되면 Ops Manager는 에이전트 구성을 수정하고 업데이트된 버전을 저장합니다.

필수 역할

이 리소스에는 Project Automation Admin 역할이 필요합니다.

Resource

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

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

요청

경로 매개변수

이름	유형	필요성	설명
프로젝트 ID	문자열	필수 사항	자동화 구성을 소유한 그룹 의 고유 식별자입니다.

쿼리 매개변수

다음 쿼리 매개변수는 선택 사항입니다.

이름

유형

필요성

설명

기본값

pretty

부울

옵션

응답 본문을 프리티프린트 에 포함해야 하는지 여부를 나타내는 플래그입니다. 형식.

false

envelope

부울

옵션

응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다.

일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다.

하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.

이름	설명
상태	HTTP 응답 코드
envelope	예상되는 응답 본문

false

본문 매개변수

이름	유형	필요성	설명
AutomationAgentVersion	문자열	옵션	MongoDB Agent를 업데이트할 버전입니다.
바이커넥터 버전	문자열	옵션	BI Connector 를 업데이트할 버전입니다.
mongoDbtoolsVersion	문자열	옵션	MongoDB database 를 업데이트하려는 버전 도구

응답

Parameter	유형	설명
AutomationAgentVersion	문자열	지정된 프로젝트에 있는 MongoDB Agent의 버전입니다.
backupAgentVersion	문자열	지정된 프로젝트에 있는 백업 에이전트의 버전입니다. Ops Manager가 백업 에이전트를 제거했으므로 이 매개 변수는 null 을 반환해야 합니다.
바이커넥터 버전	문자열	지정된 프로젝트에 있는 용 MongoDB connector 의 버전입니다.BI
mongoDbtoolsVersion	문자열	지정된 프로젝트에 있는 MongoDB Database Tools의 버전입니다.
모니터링 에이전트 버전	문자열	지정된 프로젝트에 있는 모니터링 에이전트의 버전입니다. 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	}