에이전트 버전 업데이트

이 엔드포인트는 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

부울

옵션

응답 본문이 pretty-print 형식이어야 하는지 여부를 나타내는 플래그입니다.

false

envelope

부울

옵션

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

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

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

이름	설명
`status`	HTTP 응답 코드
`content`	예상되는 응답 본문

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	}