Docs Menu

Docs Home → MongoDB Atlas for Government

API

On this page

  • Example Usage
  • See the Atlas Documentation
  • Creating a Project
  • Atlas for Government Considerations
  • Database Users
  • Clusters
  • Alerts
  • Third-Party Integration Settings
  • Cloud Backups
  • Shared-Tier Snapshots and Restore Jobs
  • Online Archive
  • Network Peering
  • Private Endpoints
  • Monitoring and Logs
  • Encryption at Rest using Customer Key Management
  • Atlas Users
  • Cloud Provider Access
  • Atlas Stream Processing
  • Triggers

The MongoDB Atlas for Government API functions in the same way as the Atlas API, except that it uses the following base URL:

https://cloud.mongodbgov.com/api/atlas/v1.0

AtlasGov authenticates API requests with SHA-256 using HTTP Digest Authentication.

Example Usage

This curl example retrieves database users for a project:

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request GET "https://cloud.mongodbgov.com/api/atlas/v1.0/groups/{PROJECT-ID}/databaseUsers?pretty=true"

  • You can find your PROJECT-ID in your Project Settings.

  • You can generate an API key pair in your organization's Access Manager, under the API Keys tab.

See the Atlas Documentation

Creating a Project

You must designate projects for either standard or government (gov) region usage upon creation. You cannot deploy clusters across government and standard regions in the same project. AWS is the only cloud provider for AtlasGov.

By default, the AtlasGov API designates new projects for standard region usage.

To use the API to create a project for government regions, include the following in your POST request data:

"regionUsageRestrictions" : "GOV_REGIONS_ONLY"

Tip

Atlas documentation

For detailed information on creating a project with the API, including an example request, see Create One Project.

Atlas for Government Considerations

The following cloud providers, MongoDB products, and features are unavailable for all API resources:

  • Azure

  • GCP

  • Atlas Data Lake

  • Atlas Online Archives

  • Atlas Triggers

  • MongoDB Charts

  • MongoDB Realm

  • Free, shared, and M10 clusters

Many of the commercial Atlas API resources are limited or unavailable:

Database Users

Database users who authenticate with SCRAM must use SCRAM-SHA-256.

Clusters

AtlasGov clusters must be tier M20 or higher. Free and shared-tier clusters are not supported.

Alerts

  • Alerts related to payment methods are unavailable.

  • Alerts can come from several different email addresses. For more information, see Alerts and Communications.

Third-Party Integration Settings

You must have the Project Owner role to configure a third-party monitoring integration.

Datadog

When integrated with Datadog, AtlasGov uses the Datadog for Government site (US1-FED).

To learn more about US1-FED, see the Datadog documentation.

Cloud Backups

AWS Standard and AWS GovCloud backups are not compatible with one another. If you create a backup from a AWS GovCloud region-only project, you can only restore that data to a AWS GovCloud region-only project. The same is true for AWS Standard region-only projects.

Shared-Tier Snapshots and Restore Jobs

Shared-tier clusters are unavailable in AtlasGov.

Online Archive

Online Archives are unavailable in AtlasGov.

Network Peering

  • You can only peer AWS GovCloud regions with MongoDB clusters in AWS GovCloud regions. You can only peer AWS Standard regions with MongoDB clusters in AWS Standard regions.

  • AWS is the only supported cloud provider for AtlasGov.

Private Endpoints

  • You can only link AWS GovCloud regions with MongoDB clusters in AWS GovCloud regions. You can only link AWS Standard regions with MongoDB clusters in AWS Standard regions.

  • AWS is the only supported cloud provider for AtlasGov.

Monitoring and Logs

In addition to the standard Atlas logging, AtlasGov logs the username and IP address associated with all failed login attempts, temporary lockouts and failed API digest authentications.

Encryption at Rest using Customer Key Management

  • You must use KMS keys in AWS GovCloud regions to encrypt data in AWS GovCloud region-only projects. You must use KMS keys in AWS Standard regions to encrypt data in AWS Standard region-only projects.

  • AWS is the only supported cloud provider for AtlasGov.

Atlas Users

You cannot create MongoDB Atlas for Government users. MongoDB Atlas for Government is available by invitation only.

Cloud Provider Access

AWS is the only supported cloud provider for AtlasGov.

Atlas Stream Processing

Atlas Stream Processing is unavailable in AtlasGov.

Triggers

Triggers are unavailable in AtlasGov.

← Security
Subscriptions and Billing →

On this page