Criar um cluster efêmero do Atlas

Crie o cluster Ephemeral.

Envie uma solicitação POST para o seguinte ponto de extremidade:

https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create

A solicitação requer o seguinte cabeçalho Accept:

Accept: application/vnd.atlas.preview+json

A seguinte solicitação de exemplo cria um cluster Ephemeral chamado Cluster0:

curl -sS -X POST 'https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create' \  -H 'Accept: application/vnd.atlas.preview+json' \  -H 'Content-Type: application/json' \  -d '{"clusterName": "Cluster0"}'

O ponto de extremidade de criação retorna uma resposta no seguinte formato:

{  "claimUrl": "https://account.mongodb.com/account/register?claimId={claimId}",  "clusterId": "{clusterId}",  "connectionString": "mongodb+srv://{username}:{password}@{host}/",  "expiresAt": "{timestamp}",  "status": "PROVISIONING",  "termsOfService": "By using this API and any resources provisioned through it, you agree to be bound by MongoDB's Cloud Terms of Service at https://www.mongodb.com/legal/terms-and-conditions/cloud; and Privacy Policy at https://www.mongodb.com/legal/privacy/privacy-policy."}

A resposta inclui os seguintes campo:

• claimUrl: URL exclusiva para reivindicar este cluster efêmero. Um humano deve abrir esta URL em um navegador. Válido por 7 dias após a criação do cluster.

• clusterId: Identificador exclusivo do cluster efêmero. Para recuperar status, claimUrl e outros detalhes do cluster, envie uma solicitação GET para o seguinte ponto de extremidade, substituindo {clusterId} por este valor:

  https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters/{clusterId}

  Para aprender mais, consulte Retornar um cluster Atlas efêmero.

• connectionString: String de conexão que usa o protocolo mongodb+srv:// para se conectar ao cluster Ephemeral. Inclui o nome de usuário e a senha de um usuários de banco de dados gerado automaticamente que pode ler e gravar dados no cluster. Qualquer cliente que use esta string de conexão é autenticado como este usuários de banco de dados. A resposta de criação é a única vez que o Atlas retorna a senha não editada.

• expiresAt: Data e hora em que o Atlas pausa o cluster se ele não for reivindicado. Um cluster Ephemeral pausado fica inacessível até que você o reivindique. O carimbo de data/hora usa o formato ISO 8601 em UTC.

• status: Status do cluster efêmero. Um entre PROVISIONING, ACTIVE ou PAUSED.

• termsOfService: Observe que, ao usar esta API, você concorda com os Termos de Serviço da Nuvem e a Política de Privacidade do MongoDB. Inclui um link para os termos completos.

Para saber mais sobre o ponto de extremidade de criação, consulte Criar um cluster efêmero do Atlas.

Salve a string de conexão e os valores de claim.

Da resposta de criação, salve connectionString, claimUrl e clusterId. Você precisa deles para se conectar, reivindicar e recuperar os detalhes do cluster.

Conecte-se ao cluster efêmero.

Use o valor connectionString da resposta de criação para se conectar ao cluster Ephemeral a partir de um ambiente compatível, como:

• Código do aplicativo: forneça a string de conexão ao driver do MongoDB para sua linguagem de programação ao inicializar o objeto cliente que se conecta ao cluster. Esta é a escolha típica ao se conectar a partir de um aplicativo. Para saber mais, consulte Conectar-se a um cluster por meio de bibliotecas de clientes.

• Linha de comando: Forneça a string de conexão como um argumento para o MongoDB Shell (mongosh) para conectar e executar comandos de forma interativa:

  Exemplo de conexão via linha de comando

  mongosh "<connectionString>"

Para aprender mais sobre os métodos de conexão disponíveis, consulte Considerações.

(Opcional) Reivindique o cluster efêmero.

A reivindicação do cluster efêmero é opcional. Se você não reivindicar o cluster, o Atlas o pausará 2 dias após a criação e o excluirá 7 dias após a criação. Quando você reivindica o cluster, o Atlas o converte em um cluster gratuito padrão sem data de expiração. O cluster reivindicado mantém todos os seus dados, e a string de conexão que você salvou continua funcionando com as mesmas credenciais. Para aprender mais sobre os efeitos da reivindicação, consulte Reivindicar um cluster efêmero.

Para reivindicar o cluster, um humano deve fazer login no Atlas em um navegador. Escolha uma das seguintes opções:

• Reivindique agora: compartilhe o claimUrl apenas com a pessoa que reivindicará o cluster. Eles podem seguir o procedimento em Reivindicar um cluster efêmero para reivindicar o cluster.

• Reivindicar mais tarde: Salve o claimUrl em uma localização segura que permaneça disponível para a pessoa que reivindicará o cluster. Essa pessoa pode então reivindicar o cluster a qualquer momento dentro de 7 dias após a criação.

• Nunca reivindicar: Não tome nenhuma ação. O Atlas exclui o cluster 7 dias após a criação.

Faça login no Atlas a partir da URL de reivindicação.

1. Em um navegador da web, abra a claimUrl que você salvou da resposta de criação para acessar a página de login do Atlas. A URL de reivindicação tem o seguinte formato, onde {claimId} é um identificador exclusivo para o cluster efêmero:

   https://account.mongodb.com/account/register?claimId={claimId}

2. Na página de login, faça login no Atlas com uma conta existente ou crie uma nova conta. Ao reivindicar o cluster na próxima etapa, esta conta obtém acesso administrativo e ao banco de dados do cluster.

   Se você criar uma nova conta, verifique seu e-mail antes de continuar.

Configure e reivindique o cluster efêmero.

Depois de fazer login, o Atlas exibe a página de reivindicação. Nesta página, faça o seguinte:

1. No menu suspenso, selecione uma organização existente ou selecione Create new org for this cluster para criar uma. Ao reivindicar o cluster, o Atlas o move para a organização selecionada e cria um projeto para ele lá.

   Importante

   A lista suspensa mostra apenas as organizações nas quais sua conta do Atlas tem a função Organization Owner. Ao reivindicar o cluster, cada Organization Owner na organização selecionada pode gerenciar o cluster e seus dados.

2. Configure o acesso IP. Para restringir o acesso, remova 0.0.0.0/0 e permita apenas seu endereço IP atual (recomendado). Para permitir conexões de qualquer endereço IP, mantenha 0.0.0.0/0. Você pode restringir o acesso IP posteriormente nas configurações de Network Access do projeto.

3. Clique em Claim Cluster. Esta é uma ação única que você não pode desfazer.

Revise a página de confirmação.

Após reivindicar o cluster, o Atlas exibe uma página de confirmação com os nomes da organização e do projeto, os detalhes do cluster e a configuração de acesso IP escolhida.

Clique em Go To Project Overview para visualizar o cluster reivindicado na IU do Atlas.

(Opcional) Reconfigure o cluster reivindicado.

Você pode reconfigurar o cluster reivindicado e seu projeto usando a IU do Atlas, o Atlas CLI ou a Atlas Administration API. No nível do cluster, você pode dimensionar o cluster para um tier superior para aumentar o armazenamento. No nível do projeto, você pode gerenciar usuários de banco de dados e restringir o acesso de IP para aumentar a segurança. Para mais informações, consulte Gerenciar Clusters.