/ /

/ /

활성 Ops Manager 서버 나열

모든 활성 Ops Manager 서버 목록을 반환합니다. Ops Manager 지난 20 초 이내에 애플리케이션 데이터베이스에 하트비트를 보낸 경우 서버 활성 상태로 간주합니다. 로그 컬렉션 요청 제출 전에 이 엔드포인트를 사용하여 유효한 serverId 값을 검색합니다.

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

Resource

GET /admin/servers

필수 역할

이 엔드포인트를 호출하는 API 키에 Global Read Only 역할 이 있어야 합니다.

요청 매개변수

요청 경로 매개변수

이 엔드포인트는 HTTP 요청 경로 매개변수를 사용하지 않습니다.

요청 쿼리 매개변수

이름	유형	필요성	설명	기본값
`pageNum`	숫자	옵션	결과의 하위 섹션을 반환하는 1부터 시작하는 정수입니다.	`1`
`itemsPerPage`	숫자	옵션	페이지당 반환할 항목 수. 최대 500개까지 가능합니다.	`100`
`type`	문자열	옵션	필터하다 할 서버 유형입니다. 여러 유형(`?type=VALUE_1&type=VALUE_2`)을 포함하려면 이 매개변수를 여러 번 전달합니다. 현재 지원되는 값은 `MMS_SERVER`이며, 이는 Ops Manager 애플리케이션 서버 나타냅니다. 이 매개 변수를 생략하면 Ops Manager 모든 유형을 반환합니다(현재는 `MMS_SERVER`만 해당).	모든 유형
`status`	문자열	옵션	필터하다 할 서버 상태입니다. 현재 유효한 값은 `active`뿐입니다. 다른 값은 `400 INVALID_SERVER_STATUS`을 반환합니다. 이 매개변수를 생략하면 Ops Manager 활성 서버를 반환합니다.	`active`
`pretty`	부울	옵션	응답 본문이 pretty-print 형식이어야 하는지 여부를 나타내는 플래그입니다.	`false`
`envelope`	부울	옵션	응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스 할 수 없습니다. 이 문제를 해결하려면 쿼리 에서 `envelope=true` 를 설정하다 .	`false`

요청 본문 매개변수

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

응답

응답에는 서버 객체 배열 , 링크 객체 배열 , 조회된 서버 객체의 총 수가 포함됩니다.

이름	유형	설명
`results`	배열	활성 Ops Manager 서버의 배열입니다. 내장된 문서 결과를 확인합니다.
`links`	배열	하위 리소스 또는 관련 리소스에 대한 하나 이상의 링크 배열입니다. URL 간의 관계는웹 연결 사양(RFC 5988)을 따릅니다.
`totalCount`	숫자	결과 설정하다 의 총 항목 수입니다. 페이지를 매길 때 `results` 의 크기를 초과할 수 있습니다.

결과 내장된 문서

각 results 요소는 하나의 활성 Ops Manager 서버 나타냅니다.

이름	유형	설명
`results[n].serverId`	문자열	활성 Ops Manager 서버 의 식별자입니다.
`results[n].serverType`	문자열	서버 유형 . 현재는 항상 `MMS_SERVER`을(를) 반환합니다.
`results[n].lastPing`	문자열	서버 마지막으로 하트비트를 보낸 시간(ISO 8601 UTC 형식)의 타임스탬프입니다.

요청 예시

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET \
     "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/servers?pretty=true"

응답 예시

응답 헤더

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}

응답 본문

{
  "links": [
    {
      "href": "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/servers?pageNum=1&itemsPerPage=100",
      "rel": "self"
    }
  ],
  "results": [
    {
      "serverId": "om-server-1.example.com",
      "serverType": "MMS_SERVER",
      "lastPing": "2026-04-13T10:00:15Z"
    },
    {
      "serverId": "om-server-2.example.com",
      "serverType": "MMS_SERVER",
      "lastPing": "2026-04-13T10:00:12Z"
    }
  ],
  "totalCount": 2
}

돌아가기

서버 로그 컬렉션 작업

만들기