Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
MongoDB Atlas para o governo

API

Nesta página

  • Exemplo de uso
  • Veja a documentação do Atlas
  • Criando um projeto
  • Atlas pelas considerações governamentais
  • Utilizadores de banco de dados
  • Clusters
  • Alertas
  • Configurações de integração de terceiros
  • backups em nuvem
  • Snapshots de camada compartilhada e trabalhos de restauração
  • Arquivo On-line
  • Emparelhamento de rede
  • Endpoints privados
  • Monitoramento e registros
  • Criptografia em repouso usando o gerenciamento de chaves de cliente
  • Atlas users
  • Atlas Stream Processing
  • Acionadores

AAPI MongoDB Atlas for Government funciona da mesma forma que a API Atlas, exceto pelo fato de que ela usa a seguinte URL base:

https://cloud.mongodbgov.com/api/atlas/v2

O AtlasGov autentica solicitações de API com SHA-256 usando Autenticação de resumoHTTP.

Exemplo de uso

Este exemplo do curl recupera trigger de reconhecimento de data center para um projeto:

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Accept: application/vnd.atlas.2023-01-01+json" \ # update date to desired API version
  --include \
  --request GET "https://cloud.mongodbgov.com/api/atlas/v2/groups/{PROJECT-ID}/databaseUsers?pretty=true"

  • Você pode encontrar seu PROJECT-ID em seu Project Settings.

  • Você pode gerar um par de chaves de API no Access Manager da sua organização, na aba API Keys .

Veja a documentação do Atlas

Criando um projeto

Você deve designar projetos para uso padrão ou governamental (gov) da região após a criação. Você não pode implantar clusters entre regiões governamentais e padrão no mesmo projeto.

Por padrão, a API do AtlasGov designa novos projetos para uso padrão da região.

Para usar a API para criar um projeto para regiões governamentais, inclua o seguinte em seus dados de solicitação do POST :

"regionUsageRestrictions" : "GOV_REGIONS_ONLY"

Dica

Documentação do Atlas

Para obter informações detalhadas sobre como criar um projeto com a API, incluindo uma solicitação de exemplo , consulte Criar um projeto.

Atlas pelas considerações governamentais

Os seguintes fornecedores de nuvem, produtos MongoDB e funcionalidades não estão disponíveis para todos os recursos de API :

  • Azure

  • Atlas Data Lake

  • Atlas Online Archives

  • Atlas Triggers

  • MongoDB Charts

  • Atlas Device SDKs

  • Clusters gratuitos, compartilhados e M10

Muitos dos recursos comerciais da API do Atlas são limitados ou indisponíveis:

Utilizadores de banco de dados

Os usuários do banco de dados que se autenticam com SCRAM devem usar SCRAM-SHA-256.

Clusters

Os clusters do AtlasGov devem ser de nível M20 ou superior. Clusters de nível gratuito e compartilhado não são permitidos.

Alertas

  • Os alertas relacionados às formas de pagamento não estão disponíveis.

  • Os alertas podem vir de vários endereços de e-mail diferentes. Para obter mais informações, consulteAlertas e comunicações .

Configurações de integração de terceiros

Você deve ter a função Project Owner para configurar uma integração de monitoramento de terceiros.

Datadog

Quando integrado ao Datadog, o AtlasGov usa o site Datadog for Government (US1-FED).

Para saber mais sobre o US1-FED, consulte a documentação do Datadog.

backups em nuvem

Restaurações entre projetos padrão e projetos somente da região Gov não são permitidos. Se um backup for criado a partir de um cluster em um projeto somente de região Gov (Amazon Web Services GovCloud ou GCP Assured Workloads), os dados só poderão ser restaurados em um cluster em um projeto somente de região Gov. A mesma restrição se aplica a projetos padrão, em que backups em regiões padrão só podem ser restaurados em clusters em projetos padrão.

A restauração entre nuvens é suportada entre as regiões Amazon Web Services GovCloud e GCP Assured Workloads.

Snapshots de camada compartilhada e trabalhos de restauração

Clusters de camada compartilhada não estão disponíveis no AtlasGov.

Arquivo On-line

Os Arquivos Online não estão disponíveis no AtlasGov.

Emparelhamento de rede

  • Você só pode fazer Peering de regiões da Amazon Web Services GovCloud com clusters MongoDB em regiões da Amazon Web Services GovCloud. Você só pode fazer Peering de regiões padrão da Amazon Web Services com clusters MongoDB em regiões padrão da Amazon Web Services.

  • Só é possível emparelhar regiões de Volumes de trabalho garantidos do GCP com clusters MongoDB em regiões de Volumes de trabalho garantidos do GCP.

Endpoints privados

  • Você só pode vincular regiões do Amazon Web Services GovCloud com clusters MongoDB em regiões do Amazon Web Services GovCloud. Você só pode vincular regiões padrão da Amazon Web Services a clusters MongoDB em regiões padrão da Amazon Web Services.

  • Só é possível vincular regiões de Volumes de trabalho garantidos do GCP a clusters MongoDB em regiões de Volumes de trabalho garantidos do GCP.

Monitoramento e registros

Além do registro padrão do Atlas, o AtlasGov registra o nome de usuário e o endereço IP associados a todas as tentativas fracassadas de login, bloqueios temporários e autenticações de resumo da API com falha.

Criptografia em repouso usando o gerenciamento de chaves de cliente

  • Você deve usar chaves KMS nas regiões do Amazon Web Services GovCloud e GCP Assured Workloads para criptografar dados em projetos somente da região do Amazon Web Services GovCloud e GCP Assured Workloads. Você deve usar chaves KMS nas regiões do Amazon Web Services Standard para criptografar dados em projetos somente da região do Amazon Web Services Standard.

Atlas users

Você não pode criar o MongoDB Atlas para usuários do governo. O MongoDB Atlas for Government está disponível apenas por convite.

Atlas Stream Processing

Atlas Stream Processing não está disponível no AtlasGov.

Acionadores

Os Atlas Triggers não estão disponíveis no AtlasGov.