AtlasGov 프로그래밍 방식 액세스

DevOps 도구

AtlasGov는 다음과 같은 DevOps 도구를 지원합니다.

사용 예시

이 curl 예시 프로젝트 의 데이터베이스 사용자를 검색합니다. 원하는 인증 방법에 해당하는 탭 선택합니다.

echo -n {clientId}:{clientSecret} | base64

1
curl --request POST \
2
   --url https://cloud.mongodbgov.com/api/oauth/token \
3
   --header 'accept: application/json' \
4
   --header 'cache-control: no-cache' \
5
   --header 'authorization: Basic {base64Auth}' \
6
   --header 'content-type: application/x-www-form-urlencoded' \
7
   --data 'grant_type=client_credentials'

{"access_token":"{accessToken}","expires_in":3600,"token_type":"Bearer"}%

curl --request GET \
   --url https://cloudgov.mongodb.com/api/atlas/v2/groups \
   --header 'Authorization: Bearer {accessToken}' \
   --header 'Accept: application/vnd.atlas.2023-02-01+json' \
   --header 'Content-Type: application/json'

curl --header 'Authorization: Bearer {accessToken}' \
   --header "Content-Type: application/json" \
   --header "Accept: application/vnd.atlas.2023-02-01+json" \
   --include \
   --request POST "https://cloudgov.mongodb.com/api/atlas/v2/groups" \
   --data '
      {
         "name": "MyProject",
         "orgId": "5a0a1e7e0f2912c554080adc"
      }'

curl --user "{publicKey}:{privateKey}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \ # update date to desired API version
  --include \
  --request GET "https://cloud.mongodbgov.com/api/atlas/v2/groups/{projectId}/databaseUsers?pretty=true"

Atlas 문서 참조

• API 사용에 대해 자세히 알아보려면 Atlas API를 참조하세요.

• 서비스 계정 또는 API 키로 API 를 인증하는 방법에 대해 자세히 학습하려면 Atlas 관리 API 인증 방법을 참조하세요.

• API를 구성하려면 Atlas API 액세스 구성을 참조하세요.

• 가능한 오류 목록은 Atlas API 오류 코드를 참조하세요.

프로젝트 만들기

프로젝트 생성 시 표준 또는 정부(gov) 리전 사용에 대한 프로젝트를 지정해야 합니다. 동일한 프로젝트에서 정부 및 표준 리전에 클러스터를 배포할 수 없습니다.

기본적으로 AtlasGov API는 표준 리전 사용에 대한 새 프로젝트를 지정합니다.

API를 사용하여 정부 리전을 위한 프로젝트를 생성하려면 POST 요청 데이터에 다음을 포함하세요.

"regionUsageRestrictions" : "GOV_REGIONS_ONLY"

데이터베이스 사용자

SCRAM 으로 인증하는 데이터베이스 사용자는 SCRAM-SHA-256 를 사용해야 합니다.

클러스터

AtlasGov 클러스터는 계층 M20 이상이어야 합니다. Atlas 무료 및 Flex 클러스터를 지원 하지 않습니다.

알림

• 결제 수단과 관련된 경고는 사용할 수 없습니다.

• 경고는 여러 개의 서로 다른 이메일 주소에서 발송될 수 있습니다. 자세한 내용은 경고 및 커뮤니케이션을 참조하세요.

타사 통합 설정

타사 모니터링 통합을 구성하려면 Project Owner 역할이 있어야 합니다.

클라우드 백업

표준 프로젝트와 Gov 리전 전용 프로젝트 간의 복원은 허용되지 않습니다. Gov 리전 전용(AWS GovCloud 또는 GCP Assure Workloads) 프로젝트 의 클러스터 에서 백업 생성하는 경우, Gov 리전 전용 프로젝트 의 클러스터 로만 데이터를 복원 할 수 있습니다. 표준 리전의 백업을 표준 프로젝트의 클러스터로만 복원할 수 있는 표준 프로젝트에도 동일한 제한 사항이 적용됩니다.

Amazon Web Services GovCloud와 GCP Assured Workloads 리전 간에 클라우드 간 복원 이 지원됩니다.

Flex 클러스터 스냅샷 및 복원 작업

AtlasGov에서는 Flex 클러스터를 사용할 수 없습니다.

온라인 아카이브

AtlasGov에서는 Online Archive를 사용할 수 없습니다.

네트워크 피어링

• AWS GovCloud 리전에서만 AWS GovCloud 리전을 MongoDB 클러스터와 피어링할 수 있습니다. AWS 커머셜 리전에서만 MongoDB 클러스터와 AWS 커머셜 리전을 피어링할 수 있습니다.

• GCP Assuring Workloads 리전에서만 MongoDB cluster와 GCP Assuring Workloads 리전을 피어링할 수 있습니다.

비공개 엔드포인트

• AWS GovCloud 리전에서만 AWS GovCloud 리전을 MongoDB 클러스터와 연결할 수 있습니다. AWS 커머셜 리전에서만 AWS 커머셜 리전을 MongoDB 클러스터와 연결할 수 있습니다.

• GCP Assuring Workloads 리전을 MongoDB cluster와 연결하는 것은 GCP Assuring Workloads 리전에서만 가능합니다.

모니터링 및 로그

표준 Atlas 로깅 외에도 AtlasGov는 모든 로그인 시도 실패, 임시 잠금 및 API 다이제스트 인증 실패와 관련된 사용자 이름 및 IP 주소를 기록합니다.

고객 키 관리를 사용한 미사용 암호화

• Amazon Web Services Services GovCloud 및 GCP Assuring Workloads 리전 전용 프로젝트의 데이터를 암호화하려면 Amazon Web Services GovCloud 및 GCP Assuring Workloads 리전에서 KMS 키를 사용해야 합니다. Amazon Web Services Commercial 리전 전용 프로젝트의 데이터를 암호화하려면 Amazon Web Services Commercial 리전의 KMS 키를 사용해야 합니다.

Atlas 사용자

정부 기관 사용자를 위한 MongoDB Atlas는 만들 수 없습니다. MongoDB Atlas for Government는 초대를 통해서만 사용할 수 있습니다.

Atlas Stream Processing

AtlasGov에서는 Atlas Stream Processing을 사용할 수 없습니다.

트리거

AtlasGov에서는 Atlas Triggers를 사용할 수 없습니다.