Criar um Atlas cluster efêmero

Crie o cluster efêmero.

Envie uma solicitação POST para o seguinte endpoint:

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

O seguinte exemplo de solicitação cria um cluster efêmero denominado 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 endpoint 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 campos:

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

• clusterId: Identificador único do cluster Efêmero. Para recuperar o status, claimUrl e outros detalhes do cluster, envie uma solicitação de GET para o seguinte endpoint, substituindo {clusterId} por esse valor:

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

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

• connectionString: connection string que usa o protocolo mongodb+srv:// para se conectar ao cluster efêmero. Inclui o nome de usuário e a senha de um usuário de banco de dados gerado automaticamente que pode ler e gravar dados no cluster. Qualquer cliente que use essa string de conexão se autentica como esse usuário 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 solicitado. Um cluster efêmero 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 essa API, você concorda com os Termos de Serviço e a Política de Privacidade da Nuvem do MongoDB. Inclui um link para os termos completos.

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

Salve a string de conexão e reivindique valores.

Na resposta de criação, salve o connectionString, claimUrl e clusterId. Você precisa deles para se conectar, exigir 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 efêmero a partir de um ambiente compatível, como:

• Código do aplicativo: forneça a string de conexão ao driver MongoDB para sua linguagem de programação quando você inicializar o objeto do cliente que se conecta ao cluster. Essa é a escolha típica ao se conectar a partir de um aplicação. 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 interativamente:

  Exemplo de conexão da linha de comando

  mongosh "<connectionString>"

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

(Opcional) Reivindicar o cluster efêmero.

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

Para solicitar o cluster, um ser humano deve se conectar ao Atlas em um navegador. Escolha uma das seguintes opções:

• Reclamar agora: partilhe o claimUrl apenas com a pessoa que exigirá o cluster. Eles podem seguir o procedimento em Reivindicar um cluster efêmero para solicitar o cluster.

• Reclamar mais tarde: Salve o claimUrl em um local seguro que permaneça disponível para a pessoa que solicitará o cluster. Essa pessoa pode então exigir o cluster a qualquer momento dentro de 7 dias após a criação.

• Declarar nunca: não realizar nenhuma ação. O Atlas exclui o cluster 7 dias após a criação.

Inicie sessão no Atlas a partir do URL de reivindicação .

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

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

2. Na página de entrada, entre no Atlas com uma conta existente ou crie uma nova conta. Quando você solicita o cluster na próxima etapa, essa conta obtém acesso administrativo e de banco de dados ao cluster.

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

Configure e reivindique o cluster efêmero.

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

1. Na lista suspensa, selecione uma organização existente ou selecione Create new org for this cluster para criar uma. Quando você solicita o cluster, o Atlas o move para a organização selecionada e cria um projeto para ele lá.

   Importante

   A lista suspensa lista apenas as organizações em que sua conta Atlas tem a função Organization Owner. Quando você solicita o cluster, todos os proprietários da organização na organização selecionada podem gerenciar o cluster e seus dados.

2. Configurar 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 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.

Depois de solicitar 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 reivindicação na UI do Atlas .

(Opcional) Reconfigure o cluster reivindicação.

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