AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

1개의 프로젝트에 모든 호스트 할당 나열

1개의 프로젝트에 대한 모든 호스트 할당을 검색합니다.

필수 역할

이 리소스를 성공적으로 호출하려면 API 키에 Global Owner 역할이 있어야 합니다.

요청

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

GET /usage/groups/{groupId}/hosts

요청 경로 매개변수

Ops Manager에는 모든 경로 매개 변수가 필요합니다.

경로 매개 변수
유형
설명

groupId

문자열

원하는 호스트와 연결된 프로젝트의 고유 식별자입니다.

요청 쿼리 매개변수

이름
유형
필요성
설명
기본값

pretty

부울

옵션

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

false

envelope

부울

옵션

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

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

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

  • status: HTTP 응답 코드

  • content예상되는 응답 본문

false

쿼리 매개변수
유형
필요성
설명
기본값

startDate

문자열

필수 사항

endDate

문자열

필수 사항

pageNum

integer

필수 사항

반환할 호스팅하다 할당 시작 그룹 . 그룹 크기는 itemsPerPage에 의해 정의됩니다. 이 값은 1로 시작합니다.

itemsPerPage

integer

필수 사항

한 그룹에서 반환할 호스트 할당량의 수입니다.

100

요청 본문 매개변수

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

응답

응답 요소
유형
설명

호스트

문자열 배열

제공된 물리적 호스트에 바인딩된 가상 호스트의 목록입니다.

hosts
.groupId

문자열

Ops Manager가 이 가상 호스트를 배치하는 프로젝트의 고유 식별자입니다.

hosts
.hostname

문자열

물리적 호스트에 바인딩된 가상 호스트의 FQDN 입니다.

프로세스

객체 배열

가상 호스트에서 실행 중인 MongoDB 프로세스.

프로세스
.[n].클러스터

객체

MongoDB 프로세스가 속한 cluster의 이름입니다.

프로세스
.[n].groupName

문자열

MongoDB 프로세스가 속한 프로젝트의 이름입니다.

프로세스
.[n].orgName

문자열

MongoDB 프로세스가 속한 조직의 이름입니다.

프로세스
.[n].groupId

문자열

MongoDB 프로세스가 속한 프로젝트의 고유 식별자입니다.

프로세스
.[n].hasConflictingServerType

부울

노드가 다른 노드와 다른 서버 유형을 가지고 있는지 여부를 나타내는 플래그입니다.

프로세스
.[n].name

문자열

MongoDB 프로세스를 호스팅하는 노드의 이름입니다.

프로세스
.[n].processType

integer

MongoDB 프로세스 유형을 나타내는 숫자입니다.

serverType

객체

물리적 호스트의 서버 유형입니다.

자세한 학습 은 MongoDB 사용 페이지를 참조하세요.

serverType.name

문자열

Ops Manager는 다음 값 중 하나를 반환합니다.

  • DEV_SERVER

  • TEST_SERVER

  • PRODUCTION_SERVER

  • RAM_POOL

serverType.label

문자열

Ops Manager는 다음 값 중 하나를 반환합니다.

  • Dev Server

  • Test Server

  • Production Server

  • Ram Pool

요청 예시

curl --user "{publicApiKey}:{privateApiKey}" --digest \     --header "Accept: application/json" \     --include \     --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/usage/groups/{groupId}/hosts?startDate=2020-07-23&endDate=2020-07-28&pageNum=1&itemsPerPage=100&pretty=true"

응답 예시

응답 헤더

HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

응답 본문

   {     "links": [{       "rel": "self",       "href": "http://usage.example.com/api/public/v1.0/usage/assignments?startDate=2020-07-23&endDate=2020-07-28&pageNum=1&itemsPerPage=100"     }],     "totalCount": 3,     "results": [{       "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-0",       "processes": [{         "cluster": "sdivabux",         "groupName": "{projectName}",         "orgName": "{orgName}",         "groupId": "{groupId}",         "hasConflictingServerType": true,         "name": "replicaPrimary-0-proc0-run51839",         "processType": 7       },       {         "cluster": "sdivabux",         "groupName": "{projectName}",         "orgName": "{orgName}",         "groupId": "{groupId}",         "hasConflictingServerType": true,         "name": "replicaPrimary-0-proc1-run51839",         "processType": 7       }     ],       "serverType": {         "name": "PRODUCTION_SERVER",         "label": "Production Server"       },       "isChargeable": true,       "memSizeMB": 178     },     {       "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-1",       "processes": [{         "cluster": "sdivabux",         "groupName": "{projectName}",         "orgName": "{orgName}",         "groupId": "{groupId}",         "hasConflictingServerType": true,         "name": "replicaSecondary-0-proc0-run51839",         "processType": 8       },       {         "cluster": "sdivabux",         "groupName": "{projectName}",         "orgName": "{orgName}",         "groupId": "{groupId}",         "hasConflictingServerType": true,         "name": "replicaSecondary-0-proc1-run51839",         "processType": 8       }     ],       "serverType": {         "name": "PRODUCTION_SERVER",         "label": "Production Server"       },       "isChargeable": true,       "memSizeMB": 178     },     {       "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-2",       "processes": [{         "cluster": "sdivabux",         "groupName": "{projectName}",         "orgName": "{orgName}",         "groupId": "{groupId}",         "hasConflictingServerType": true,         "name": "replicaSecondary-0-proc1-run51839",         "processType": 8       },       {         "cluster": "sdivabux",         "groupName": "{projectName}",         "orgName": "{orgName}",         "groupId": "{groupId}",         "hasConflictingServerType": true,         "name": "replicaSecondary-0-proc0-run51839",         "processType": 8       }     ],       "serverType": {         "name": "RAM_POOL",         "label": "RAM Pool"       },       "isChargeable": true,       "memSizeMB": 178     }   ]   }
돌아가기
호스트 할당 나열
다음
기본 서버 유형 가져오기
이 페이지 평가하기

이 페이지의 내용