1개의 조직 이벤트 가져오기

이 페이지의 내용

필수 역할

요청
요청 경로 매개변수
요청 쿼리 매개변수
요청 본문 매개변수
응답
요청 예시
응답 예시
응답 헤더
응답 본문

Cloud Manager는 2024년 8월 30일부터 더 이상 MongoDB 3.6 및 4.0에 대한 자동화, 백업 및 모니터링을 지원하지 않습니다. MongoDB 배포를 업그레이드하거나 Atlas로 마이그레이션하세요.

Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.: 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.

필수 역할

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

요청

기본 URL: https://cloud.mongodb.com/api/public/v1.0

GET /orgs/{orgId}/events/{eventId}

요청 경로 매개변수

이름	유형	설명
orgId	문자열	원하는 이벤트와 연결된 조직의 고유 식별자입니다.
eventId	문자열	원하는 이벤트의 고유 식별자입니다.

요청 쿼리 매개변수

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

쿼리 매개변수	유형	설명	기본값
pretty	부울	프리티프린트 에 응답을 표시합니다. 형식.	`false`
envelope	부울	응답을 엔벨로프에 래핑할지 여부를 지정합니다.	`false`
includeRaw	부울	출력에 `raw` 문서를 포함할지 여부를 지정합니다. `raw` 문서에는 이벤트에 대한 추가 메타 정보가 포함되어 있습니다. 중요: `raw` 문서 의 값은 변경될 수 있습니다. 공식 모니터링 을 위해 `raw` 값에 의존하지 마세요.	`false`

요청 본문 매개변수

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

응답

이름	유형	설명
alertId	문자열	이 이벤트와 연결된 경고의 고유 식별자입니다.
alertConfigId	문자열	`alertId` 와 연결된 경고 구성의 고유 식별자입니다.
apiKeyId	문자열	이 이벤트를 트리거한 API 키 의 고유 식별자입니다. 이 필드가 응답에 있는 경우 Cloud Manager는 `userId` 필드를 반환하지 않습니다.
clusterId	문자열	이 이벤트가 적용되는 cluster의 ID입니다.
clusterName	문자열	이 이벤트가 적용되는 cluster의 이름입니다.
컬렉션	문자열	이벤트가 발생한 collection의 이름입니다. 이 필드는 `eventTypeName` 가 `DATA_EXPLORER` 또는 `DATA_EXPLORER_CRUD` 일 때 존재할 수 있습니다.
생성됨	문자열	ISO 의 타임스탬프 이 이벤트가 트리거된시점의 UTC 8601 날짜 및 시간 형식입니다.
currentValue	객체	이 이벤트를 트리거한 지표의 현재 값입니다.
currentValue .number	숫자	지표의 값입니다.
currentValue .units	문자열	값의 관련 단위입니다. 예를 예시 메모리 소비를 측정하는 메트릭에는 바이트 측정이 있고 시간을 측정하는 메트릭에는 시간 단위가 있습니다. 허용되는 값은 다음과 같습니다. `RAW` `BITS` `BYTES` `KILOBITS` `KILOBYTES` `MEGABITS` `MEGABYTES` `GIGABITS` `GIGABYTES` `TERABYTES` `PETABYTES` `MILLISECONDS` `SECONDS` `MINUTES` `HOURS` `DAYS`
database	문자열	이벤트가 발생한 데이터베이스의 이름입니다. 이 필드는 `eventTypeName` 가 `DATA_EXPLORER` 또는 `DATA_EXPLORER_CRUD` 일 때 존재할 수 있습니다.
eventTypeName	문자열	이 이벤트를 트리거한 상황의 이름입니다. 경고를 생성하는 이벤트 유형을 검토하려면 경고 유형을 참조하세요.
groupId	문자열	이 이벤트가 발생한 프로젝트의 ID입니다.
hostId	문자열	이 이벤트가 발생한 호스트의 ID입니다.
호스트 이름	문자열	이벤트가 발생한 호스트의 호스트 이름, FQDN, IPv4 주소 또는 IPv6 주소입니다.
id	문자열	이 이벤트의 고유 식별자입니다.
invoiceId	문자열	이 이벤트와 연결된 청구서의 고유 식별자입니다.
isGlobalAdmin	부울	이 이벤트를 트리거한 사용자가 MongoDB 직원인지 여부를 나타내는 플래그입니다.
링크	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
metricName	문자열	값이 임계값을 벗어난 측정값의 이름입니다. 가능한 값은 아래를 참조하세요.
opType	문자열	이벤트를 생성한 작업 유형입니다. 이 필드는 `eventTypeName` 가 `DATA_EXPLORER` 또는 `DATA_EXPLORER_CRUD` 일 때 표시됩니다.
PaymentId	문자열	이 이벤트와 관련된 청구서 결제의 고유 식별자입니다.
포트	integer	이 이벤트와 관련된 호스트의 포트입니다.
publicKey	문자열	이 이벤트를 트리거한 API 키 와 연결된 공개 키입니다. 이 필드가 응답에 있는 경우 Cloud Manager는 `username` 필드를 반환하지 않습니다.
원시	문서	이벤트에 대한 추가 메타 정보입니다. 이 필드는 `includeRaw` 쿼리 매개변수가 `true` 인 경우에만 표시됩니다. 중요: `raw` 문서 의 값은 변경될 수 있습니다. 공식 모니터링 을 위해 `raw` 값에 의존하지 마세요.
원격 주소	문자열	이벤트를 트리거한 Cloud Manager 사용자(userId)와 연결된 IP 주소입니다.
복제본 세트 이름	문자열	복제본 세트의 이름입니다.
shardName	문자열	이벤트와 연결된 샤드의 이름입니다.
targetPublicKey	문자열	이벤트의 대상이 되는 API 키의 공개 키입니다.
targetUsername	문자열	이 이벤트의 대상이 되는 Cloud Manager 사용자의 사용자 이름입니다.
teamId	문자열	이 이벤트와 연결된 Cloud Manager 팀의 고유 식별자입니다.
userId	문자열	이 이벤트를 트리거한 Cloud Manager 사용자의 고유 식별자입니다. 이 필드가 응답에 있는 경우 Cloud Manager는 `apiKeyId` 필드를 반환하지 않습니다.
사용자 이름	문자열	이 이벤트를 트리거한 Cloud Manager 사용자의 사용자 이름입니다. 이 필드가 응답에 있는 경우 Cloud Manager는 `publicKey` 필드를 반환하지 않습니다.
accessListEntry	문자열	이벤트의 대상이 되는 API 키의 액세스 목록 항목입니다.

요청 예시

curl --user "{publicKey}:{privateKey}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/orgs/{orgId}/events/{eventId}?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}

응답 본문

1 {
2   "alertConfigId": "{alertConfigId}",
3   "alertId": "{alertId}",
4   "clusterId": "{clusterId}",
5   "clusterName": "Test Cluster",
6   "created": "2018-06-11T12:34:56Z",
7   "currentValue": {
8     "number": 50,
9     "units": "RAW"
10   },
11   "eventTypeName": "OUTSIDE_METRIC_THRESHOLD",
12   "groupId": "{groupId}",
13   "hostId": "{hostId}",
14   "hostname": "db.example.com",
15   "id": "{globalAlertId}",
16   "invoiceId": "{invoiceId}",
17   "isGlobalAdmin": false,
18   "maintenanceWindowId": "{maintenanceWindowId}",
19   "metricName": "OPCOUNTER_CMD",
20   "orgId": "{orgId}",
21   "paymentId": "{paymentId}",
22   "port": 27017,
23   "remoteAddress": "192.168.1.1",
24   "replicaSetName": "rs1",
25   "shardName": "sh1",
26   "userId": "{userId}",
27   "username": "john.doe@example.com",
28   "targetUsername": "jane.doe@example.com",
29   "teamId": "{teamId}"
30 }

돌아가기

모두 가져오기(조직)

모두 가져오기(프로젝트)

1	{
2	"alertConfigId": "{alertConfigId}",
3	"alertId": "{alertId}",
4	"clusterId": "{clusterId}",
5	"clusterName": "Test Cluster",
6	"created": "2018-06-11T12:34:56Z",
7	"currentValue": {
8	"number": 50,
9	"units": "RAW"
10	},
11	"eventTypeName": "OUTSIDE_METRIC_THRESHOLD",
12	"groupId": "{groupId}",
13	"hostId": "{hostId}",
14	"hostname": "db.example.com",
15	"id": "{globalAlertId}",
16	"invoiceId": "{invoiceId}",
17	"isGlobalAdmin": false,
18	"maintenanceWindowId": "{maintenanceWindowId}",
19	"metricName": "OPCOUNTER_CMD",
20	"orgId": "{orgId}",
21	"paymentId": "{paymentId}",
22	"port": 27017,
23	"remoteAddress": "192.168.1.1",
24	"replicaSetName": "rs1",
25	"shardName": "sh1",
26	"userId": "{userId}",
27	"username": "john.doe@example.com",
28	"targetUsername": "jane.doe@example.com",
29	"teamId": "{teamId}"
30	}