최신 계획의 자동화 상태 가져오기
- Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.
- 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.
참고
그룹과 프로젝트는 동의어입니다. {PROJECT-ID}는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 이 페이지에서는 설명에 대해 얘기할 때 더욱 친숙한 용어 그룹을 사용합니다. 엔드포인트는 문서에 명시된 대로 유지됩니다.
개요
MongoDB 프로세스에 대한 최신 계획을 조회합니다. 계획은 goalVersion 로의 MongoDB deployment를 가져오는 데 필요한 일련의 조치입니다.
엔드포인트는 goalVersion 필드를 반환하여 자동화 구성의 현재 버전을 보고하고 lastGoalVersionAchieved 필드를 반환하여 각 서버에서 실행 중인 구성의 버전을 보고합니다.
Resource
GET /groups/{PROJECT-ID}/automationStatus
요청 매개변수
요청 경로 매개변수
Parameter | 유형 | 설명 |
|---|---|---|
프로젝트 ID | 문자열 | (필수 사항) 프로젝트의 고유 식별자입니다. |
요청 쿼리 매개변수
다음 쿼리 매개변수는 선택 사항입니다.
요청 본문 매개변수
이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.
응답
이름 | 유형 | 설명 |
|---|---|---|
targetVersion | 숫자 | 가장 최근에 제출된 자동화 구성 의 버전입니다. 자동화 구성 제출 시 충돌 이 있는 경우 이 필드에 성공적인 구성이 나열됩니다. |
프로세스 | 배열 | 프로젝트에 배포된 MongoDB 인스턴스입니다. |
process.errorCode | integer | 오류 코드입니다. 프로세스에 오류가 없으면 |
process.errorCodeDescription | 문자열 | 자세한 오류 설명입니다. 프로세스에 오류가 없으면 빈 문자열을 반환합니다. |
process.errorCodeHumanReadable | 문자열 | 짧은 오류 설명입니다. 프로세스에 오류가 없으면 빈 문자열을 반환합니다. |
process.errorString | 문자열 | 오류가 포함된 로그 줄의 출력입니다. 추가 오류 컨텍스트는 이 필드를 검사합니다. 프로세스에 오류가 없으면 빈 문자열을 반환합니다. |
프로세스.호스트 이름 | 문자열 | MongoDB 프로세스 및 자동화가 호스팅되는 서버의 정규화된 도메인 이름( |
process.name | 문자열 | 자동화 구성에 지정된 프로세스 이름입니다. |
process.lastGoalVersionAchieved | 숫자 | 이 프로세스가 구성된 대로 배포된 자동화 구성의 마지막 버전입니다. |
process.plan | 배열 | 아직 구성이 최신 상태가 아닌 프로세스가 목표 상태를 달성하는 방법을 설명합니다. |
요청 예시
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --include \ --request GET -i "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationStatus"
응답 예시
응답 헤더
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}
응답 본문
{ "goalVersion": 11, "processes": [{ "errorCode": 0, "errorCodeDescription": "", "errorCodeHumanReadable": "", "errorString": "", "hostname": "example.net", "lastGoalVersionAchieved": 11, "name": "myReplicaSet_3", "plan": ["Download", "WaitRsInit", "WaitFeatureCompatibilityVersionCorrect" ] }, { "errorCode": 100, "errorCodeDescription": "There is an issue with file permissions for this process", "errorCodeHumanReadable": "File Permissions Error", "errorString": "<myReplicaSet_1> [13:11:33.348] Failed to compute states : <myReplicaSet_1> [13:11:33.348] Error calling ComputeState : <myReplicaSet_1> [13:11:33.348] Error getting fickle state for current state : <myReplicaSet_1> [13:11:33.348] Error checking if process is running from dbpath = /data/0 : <myReplicaSet_1> [13:11:33.348] Error getting file contents of /data/0/mongod.lock as string : <myReplicaSet_1> [13:11:33.348] Error reading file from /data/0/mongod.lock : open /data/0/mongod.lock: permission denied", "hostname": "example.net", "lastGoalVersionAchieved": 1, "name": "myReplicaSet_1", "plan": ["Download"] }, { "errorCode": 0, "errorCodeDescription": "", "errorCodeHumanReadable": "", "errorString": "", "hostname": "example.net", "lastGoalVersionAchieved": 11, "name": "myReplicaSet_2", "plan": ["WaitRsInit", "WaitFeatureCompatibilityVersionCorrect" ] }] }