Observação
Esta funcionalidade não está disponível para clusters gratuitos e clusters flexíveis. Para aprender mais sobre quais recursos não estão disponíveis, consulte Limites de cluster gratuito do Atlas.
Após configurar um endpoint privado para um cluster, siga estas etapas para gerenciar e conectar a partir do seu endpoint privado do Atlas .
Para saber mais sobre como usar pontos de extremidade privados com o Atlas, consulte Saiba mais sobre pontos de extremidade privados no Atlas.
Acesso necessário
Para visualizar endpoints privados, você deve ter acesso Project Read Only ao projeto.
Para excluir endpoints privados, você deve ter acesso ao Project Owner ou superior ao projeto.
Os usuários com acesso Organization Owner devem se adicionar ao projeto como um Project Owner.
Considerações
Para clusters multirregionais, é necessário criar pontos de extremidade privados para cada região que possua um nó.
Se você estiver realizando manutenção em um cluster multirregional, não altere nem remova os pontos de extremidade privados até que a manutenção seja concluída para evitar a indisponibilidade do cluster.
Se você estiver migrando de um cluster multirregional para um cluster de região única, só poderá remover os antigos pontos de extremidade privados após verificar que seu cluster está totalmente funcional na nova configuração de região única e que todo o tráfego foi direcionado através do novo ponto de extremidade privado de região única.
Para obter uma lista completa de considerações, consulte Considerações.
Conecte-se a partir de um endpoint privado
Importante
Para obter considerações sobre cadeias de conexão com reconhecimento de private endpoints, consulte Cadeias de conexão com reconhecimento de private endpoints.
Use uma connection string privada com reconhecimento de endpoint para se conectar a um Atlas cluster com o seguinte procedimento:
No Atlas, vá para a página Clusters do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.
Crie um utilizador de banco de dados.
Importante
Pule esta etapa se o Atlas indicar na etapa Setup connection security que você tem pelo menos um usuário de banco de dados configurado no seu projeto. Para gerenciar usuários de banco de dados existentes, consulte Configurar usuários de banco de dados.
Para acessar o cluster, você precisa de um usuário MongoDB com acesso ao banco de dados desejado, ou aos bancos de dados no cluster em seu projeto. Se seu projeto não tiver usuários do MongoDB, o Atlas solicitará que você crie um novo usuário com a função Atlas Admin.
Insira o Username do novo usuário.
Insira um Password para esse novo usuário ou clique em Autogenerate Secure Password.
Clique em Create Database User para salvar o usuário.
Use esse usuário para se conectar ao cluster na etapa a seguir.
Após adicionar um usuário do banco de dados, clique em Choose Your Connection Method.
Visualizar endpoints privados
Endpoints
Para retornar os detalhes do endpoint privado AWS que você especifica utilizando o Atlas CLI, execute o seguinte comando:
atlas privateEndpoints aws describe <privateEndpointId> [options]
Para listar todos os pontos de extremidade privados do Atlas em um projeto usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints aws list [options]
Para saber mais sobre a sintaxe e os parâmetros dos comandos anteriores, consulte a documentação do Atlas CLI para atlas privateEndpoints aws describe e atlas privateEndpoints aws list .
Endpoints da interface
Para retornar a interface de endpoint privada AWS que você especifica. usando o Atlas CLI, execute o seguinte comando:
atlas privateEndpoints aws interfaces describe <interfaceEndpointId> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para atlas privateEndpoints aws interfaces describe.
No Atlas, vá para a página Database & Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Database & Network Access sob o título Security.
A página Acesso ao banco de dados e à rede é exibida.
Endpoints
Para retornar os detalhes do endpoint privado do Azure que você especifica usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints azure describe <privateEndpointId> [options]
Para listar todos os endpoints privados do Azure em um projeto usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints azure list [options]
Para saber mais sobre a sintaxe e os parâmetros dos comandos anteriores, consulte a documentação do Atlas CLI para Atlas privateEndpoints Azure describe e Atlas privateEndpoints Azure list .
Endpoints da interface
Para retornar a interface de endpoint privada do Azure que você especifica. usando o Atlas CLI, execute o seguinte comando:
atlas privateEndpoints azure interfaces describe <privateEndpointResourceId> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação da CLI do Atlas sobre atlas privateEndpoints azure interfaces describe.
No Atlas, vá para a página Database & Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Database & Network Access sob o título Security.
A página Acesso ao banco de dados e à rede é exibida.
Endpoints
Para retornar os detalhes do endpoint privado da Google Cloud Platform que você especifica usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints gcp describe <privateEndpointId> [options]
Para listar todos os endpoints privados da Google Cloud Platform em um projeto usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints gcp list [options]
Para saber mais sobre a sintaxe e os parâmetros dos comandos anteriores, consulte a Atlas CLI documentação do Atlas GCP para do privateEndpoints e a lista do AtlasAtlas privateEndpoints GCP .GCP
Endpoints da interface
Para retornar a interface de endpoint privada da Google Cloud Platform que você especifica. usando o Atlas CLI, execute o seguinte comando:
atlas privateEndpoints gcp interfaces describe <id> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para descrição das interfaces doAtlas privateEndpoints GCP .
No Atlas, vá para a página Database & Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Database & Network Access sob o título Security.
A página Acesso ao banco de dados e à rede é exibida.
Remover um Endpoint Privado do Atlas
Endpoints
Para excluir o endpoint privado da AWS especificado usando a CLI do Atlas, execute o seguinte comando:
atlas privateEndpoints aws delete <privateEndpointId> [options]
Para saber mais sobre a sintaxe de comando e parâmetros, consulte a documentação do Atlas CLI para atlas privateEndpoints aws excluir.
Endpoints da interface
Para excluir a interface de endpoint privada AWS que você especifica utilizando o Atlas CLI, execute o seguinte comando:
atlas privateEndpoints aws interfaces delete <interfaceEndpointId> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação da CLI do Atlas para excluir interfaces aws do Atlas privateEndpoints.
No Atlas, vá para a página Database & Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Database & Network Access sob o título Security.
A página Acesso ao banco de dados e à rede é exibida.
Remover o private endpoint do Atlas.
Na barra lateral, clique em Private Endpoint.
Ao lado do endpoint privado que você deseja remover, clique em Terminate.
Para confirmar, clique em Confirm na caixa de diálogo.
Aviso
Não exclua um ponto de extremidade com falha se ele for o único ponto de extremidade registrado nesse serviço de ponto de extremidade privado. Se você excluir o último ponto de extremidade, todo o serviço de ponto de extremidade será excluído automaticamente e você deverá reiniciar todo o processo de configuração.
Endpoints
Para excluir o endpoint privado do Azure especificado usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints azure delete <privateEndpointId> [options]
Para saber mais sobre a sintaxe de comando e parâmetros, consulte a documentação do Atlas CLI para exclusão do Atlas privateEndpoints Azure .
Endpoints da interface
Para excluir a interface de endpoint privada do Azure que você especifica usando o Atlas CLI, execute o seguinte comando:
atlas privateEndpoints azure interfaces delete <privateEndpointResourceId> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação da Atlas CLI do Atlas para excluir interfaces doAtlas privateEndpoints Azure .
No Atlas, vá para a página Database & Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Database & Network Access sob o título Security.
A página Acesso ao banco de dados e à rede é exibida.
Remover o private endpoint do Atlas.
Na barra lateral, clique em Private Endpoint.
Ao lado do endpoint privado que você deseja remover, clique em Terminate.
Para confirmar, clique em Confirm na caixa de diálogo.
Aviso
Não exclua um ponto de extremidade com falha se ele for o único ponto de extremidade registrado nesse serviço de ponto de extremidade privado. Se você excluir o último ponto de extremidade, todo o serviço de ponto de extremidade será excluído automaticamente e você deverá reiniciar todo o processo de configuração.
Endpoints
Para excluir o endpoint privado da Google Cloud Platform especificado usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints gcp delete <privateEndpointId> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação da Atlas CLI para a exclusão do Atlas privateEndpoints GCP .
Endpoints da interface
Para excluir a interface de endpoint privada da Google Cloud Platform que você especifica usando a Atlas CLI, execute o seguinte comando:
atlas privateEndpoints gcp interfaces delete <id> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a Atlas CLI documentação da do Atlas para excluir interfaces doAtlas privateEndpoints.GCP
No Atlas, vá para a página Database & Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Database & Network Access sob o título Security.
A página Acesso ao banco de dados e à rede é exibida.
Remover o private endpoint do Atlas.
Na barra lateral, clique em Private Endpoint.
Ao lado do endpoint privado que você deseja remover, clique em Terminate.
Para confirmar, clique em Confirm na caixa de diálogo.
Aviso
Não exclua um ponto de extremidade com falha se ele for o único ponto de extremidade registrado nesse serviço de ponto de extremidade privado. Se você excluir o último ponto de extremidade, todo o serviço de ponto de extremidade será excluído automaticamente e você deverá reiniciar todo o processo de configuração.
Gerenciar regiões de ponto de extremidade aceitas para o AWS PrivateLink
Você pode configurar quais regiões da AWS podem se conectar ao seu serviço de pontos de extremidade privados. Isso habilita a conectividade de pontos de extremidade privados entre regiões, permitindo que aplicativos em diferentes regiões da AWS se conectem aos Atlas clusters por meio de pontos de extremidade privados.
Para adicionar ou remover regiões de ponto de extremidade aceitas da IU do Atlas:
Observação
A conectividade entre regiões de endpoints privados permite configurar quais regiões da AWS podem se conectar ao seu serviço de endpoints privados, permitindo que aplicativos em diferentes regiões acessem seus Atlas clusters por meio de endpoints privados.
No Atlas, vá para a página Database & Network Access do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Database & Network Access sob o título Security.
A página Acesso ao banco de dados e à rede é exibida.
Gerencie regiões de ponto de extremidade aceitas.
Clique no link Edit ao lado do serviço de ponto de extremidade.
Na seção Accepted Endpoint Regions, selecione as regiões da AWS das quais você deseja permitir conexões.
Para remover uma região, desmarque-a da lista.
Clique em Save para aplicar suas alterações.
Configure seus pontos de extremidade nas regiões aceitas.
Depois de adicionar as regiões de ponto de extremidade aceitas, você deve criar os pontos de extremidade da interface correspondentes nessas regiões em sua conta da AWS. Para saber mais sobre como criar pontos de extremidade da interface, consulte Configurar um ponto de extremidade privado para um cluster dedicado.