Este endpoint foi descontinuado em fevereiro de 2025, pois não oferecemos mais suporte à criação de novas instâncias sem servidor. Use o ponto de extremidade upgradeFlexCluster para fazer upgrade dos clusters Flex.
Atualiza um cluster de tier compartilhado para uma instância sem servidor no projeto especificado.
Sequência única de 24dígitos hexadecimais que identifica seu projeto. Use o endpoint /groups para extrair todos os projetos aos quais o usuário autenticado tem acesso.
AVISO: grupos e projetos são termos sinônimos. O ID do seu grupo é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. O recurso e os endpoints correspondentes usam o termo grupos.
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Sinalizador que indica se o aplicativo empacota a resposta em um objeto JSON envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na consulta. Os endpoints que retornam uma lista de resultados usam o objeto de resultados como um envelope. O aplicativo adiciona o parâmetro de status ao corpo da resposta.
O valor padrão é false.
Sinalizador que indica se o corpo da resposta deve estar no formato prettyprint.
O valor padrão é false.
Detalhes da atualização do agrupamento de camada compartilhada no projeto especificado.
Rótulo legível por humanos que identifica a instância sem servidor.
O formato deve corresponder ao seguinte padrão: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.
Grupo de configurações do fornecedor de nuvem que definem a instância sem servidor do MongoDB provisionada.
Provedor de serviços de nuvem no qual a MongoDB Cloud provisionou a instância sem servidor.
Os valores são AWS, AZURE ou GCP.
Etiqueta legível por humanos que identifica o provedor de serviços de nuvem.
O valor é SERVERLESS. O valor padrão é SERVERLESS.
Grupo de configurações que configuram o backup sem servidor.
Sinalizador que indica se a instância sem servidor usa Backup contínuo sem servidor. Se este parâmetro false for, a instância sem servidor utilizará Backup Básico.
| Opção | Descrição | |---|---| | Backup contínuo sem servidor | O Atlas tira snapshots incrementais dos dados em sua instância sem servidor a cada seis horas e permite restaurar os dados de um ponto selecionado nas últimas 72 horas. O Atlas também tira snapshots diários e retém esses snapshots diários por 35 dias. Para saber mais, consulte Custos de instância sem servidor. | | Backup Básico | O Atlas tira snapshots incrementais dos dados em sua instância sem servidor a cada seis horas e retém apenas os dois snapshots mais recentes. Você pode usar essa opção gratuitamente. |
O valor padrão é true.
Lista que contém pares de valores-chave entre 1 e 255 caracteres de comprimento para marcar e categorizar a instância sem servidor.
Par de valores-chave que marca e categoriza uma organização, projeto ou cluster do MongoDB Cloud. Por exemplo, environment : production.
Constante que define o conjunto da tag. Por exemplo, environment na marcação environment : production .
O comprimento mínimo é 1, o comprimento máximo é 255.
Variável que pertence ao conjunto da tag. Por exemplo, production na marcação environment : production .
O comprimento mínimo é 1, o comprimento máximo é 255.
Sinalizador que indica se a proteção de rescisão está habilitada na instância sem servidor. Se definido para true, o MongoDB Cloud não excluirá a instância sem servidor. Se definido para false, o MongoDB Cloud excluirá a instância sem servidor.
O valor padrão é false.
OK
Coleção de localizadores uniformes de recursos que apontam para o banco de dados MongoDB.
Lista de connection strings com reconhecimento de endpoints privados que você pode usar para se conectar a essa instância sem servidor por meio de um endpoint privado. Esse parâmetro retornará somente se você tiver criado um endpoint privado para essa instância sem servidor e ele estiver DISPONível.
string de conexão de endpoint privado que você pode usar para se conectar a essa instância sem servidor por meio de um endpoint privado.
Lista que contém os pontos de extremidade privados por meio da qual você se conecta ao MongoDB nuvem quando usa connectionStrings.privateEndpoint[n].srvConnectionString.
Detalhes de um endpoint privado implantado para esta instância sem servidor.
String única que o provedor de nuvem usa para identificar o endpoint privado.
Fornecedor de nuvem onde o endpoint privado está implementado.
Os valores são AWS ou AZURE.
Região onde o endpoint privado está implantado.
string de conexão privada com reconhecimento de endpoint que usa o protocolo mongodb+srv:// para se conectar ao MongoDB Cloud por meio de um endpoint privado. O protocolo mongodb+srv informa ao driver para procurar a lista de sementes de hosts no Sistema de Nome de Domínio (DNS).
Tipo de processo do MongoDB ao qual seu aplicação se conecta.
O valor é MONGOS.
string de conexão pública que você pode usar para se conectar a esta instância sem servidor. Esta string de conexão utiliza o protocolo mongodb+srv://.
Data e hora em que o MongoDB Cloud criou esta instância sem servidor. O MongoDB Cloud representa esse registro de data/hora no formato ISO 8601 em UTC.
String exclusiva de 24 caracteres hexadecimais que identifica o projeto.
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
String exclusiva de 24dígitos hexadecimais que identifica a instância sem servidor.
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Lista de um ou mais localizadores uniformes de recursos (URLs) que ponto para sub-recursos de API, recursos de API relacionados ou ambos. A RFC 5988 descreve esses relacionamentos.
Localizador de recursos uniforme (URL) que aponta outro recurso de API para o qual essa resposta tem algum relacionamento. Essa URL geralmente começa com https://cloud.mongodb.com/api/atlas.
Localizador de recursos uniforme (URL) que define a relacionamento semântica entre este recurso e outro recurso de API. Essa URL geralmente começa com https://cloud.mongodb.com/api/atlas.
Versão do MongoDB que a instância sem servidor executa.
O formato deve corresponder ao seguinte padrão: ([\d]+\.[\d]+\.[\d]+).
Rótulo legível por humanos que identifica a instância sem servidor.
O formato deve corresponder ao seguinte padrão: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.
Grupo de configurações do fornecedor de nuvem que definem a instância sem servidor do MongoDB provisionada.
Provedor de serviços de nuvem no qual a MongoDB Cloud provisionou a instância sem servidor.
Os valores são AWS, AZURE ou GCP.
Capacidade de armazenamento de volumes de dados de instância expressos em gigabytes. Este valor não é configurável para clusters sem servidor ou efetivamente flexíveis.
Limite de tamanho da instância para o qual seu cluster pode escalar automaticamente.
Os valores são M10, M20, M30, M40, M50, M60, M80, M100, M140, M200, M300, R40, R50, R60, R80, R200, R300, R400, R700, M40_NVME, M50_NVME, M60_NVME, M80_NVME, M200_NVME, M400_NVME, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2, R400_GEN_2, R700_GEN_2, M40_NVME_GEN_2, M50_NVME_GEN_2, M60_NVME_GEN_2, M80_NVME_GEN_2, M200_NVME_GEN_2 ou M400_NVME_GEN_2.
Os valores são M10, M20, M30, M40, M50, M60, M80, M90, M200, R40, R50, R60, R80, R200, R300, R400, M60_NVME, M80_NVME, M200_NVME, M300_NVME, M400_NVME ou M600_NVME.
Os valores são M10, M20, M30, M40, M50, M60, M80, M140, M200, M250, M300, M400, R40, R50, R60, R80, R200, R300, R400, R600, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2 ou R400_GEN_2.
Provedor de serviços de nuvem no qual a MongoDB Cloud provisionou efetivamente a instância sem servidor.
Etiqueta legível por humanos que identifica o provedor de serviços de nuvem.
O valor é SERVERLESS. O valor padrão é SERVERLESS.
Grupo de configurações que configuram o backup sem servidor.
Sinalizador que indica se a instância sem servidor usa Backup contínuo sem servidor. Se este parâmetro false for, a instância sem servidor utilizará Backup Básico.
| Opção | Descrição | |---|---| | Backup contínuo sem servidor | O Atlas tira snapshots incrementais dos dados em sua instância sem servidor a cada seis horas e permite restaurar os dados de um ponto selecionado nas últimas 72 horas. O Atlas também tira snapshots diários e retém esses snapshots diários por 35 dias. Para saber mais, consulte Custos de instância sem servidor. | | Backup Básico | O Atlas tira snapshots incrementais dos dados em sua instância sem servidor a cada seis horas e retém apenas os dois snapshots mais recentes. Você pode usar essa opção gratuitamente. |
O valor padrão é true.
Etiqueta legível para humanos que indica qualquer atividade atual que esteja sendo realizada neste cluster pelo plano de controle Atlas . Com exceção dos estados CREATING e DELETING, os clusters devem estar sempre disponíveis e ter um nó primário, mesmo quando em estados que indicam atividade contínua.
IDLE: o Atlas não está fazendo alterações neste cluster e pode-se presumir que todas as alterações solicitadas por meio da UI ou da API foram aplicadas.CREATING: um cluster que está sendo provisionado pela primeira vez retorna o estado CREATING até que esteja pronto para conexões. Certifique-se de que a Lista de Acesso IP e os Usuários do Banco de Dados estejam configurados antes de tentar se conectar.UPDATING: Uma alteração solicitada por meio da UI, API, AutoScaling ou outra atividade programada está ocorrendo.DELETING: o cluster está em processo de exclusão e será excluído em breve.REPAIRING: Um ou mais nós no cluster estão sendo devolvidos ao serviço pelo plano de controle Atlas . Outros nós devem continuar fornecendo serviços normalmente.Os valores são IDLE, CREATING, UPDATING, DELETING ou REPAIRING.
Lista que contém pares de valores-chave entre 1 e 255 caracteres de comprimento para marcar e categorizar a instância sem servidor.
Par de valores-chave que marca e categoriza uma organização, projeto ou cluster do MongoDB Cloud. Por exemplo, environment : production.
Constante que define o conjunto da tag. Por exemplo, environment na marcação environment : production .
O comprimento mínimo é 1, o comprimento máximo é 255.
Variável que pertence ao conjunto da tag. Por exemplo, production na marcação environment : production .
O comprimento mínimo é 1, o comprimento máximo é 255.
Sinalizador que indica se a proteção de rescisão está habilitada na instância sem servidor. Se definido para true, o MongoDB Cloud não excluirá a instância sem servidor. Se definido para false, o MongoDB Cloud excluirá a instância sem servidor.
O valor padrão é false.
Solicitação inválida.
Detalhes da solicitação inválida.
Descreve todas as violações em uma solicitação do cliente .
Descreve as condições ou os motivos específicos que causam cada tipo de erro.
O código de status HTTP retornado com este erro.
Código de erro do aplicativo retornado com esse erro.
Parâmetros usados para fornecer mais informações sobre o erro.
Políticas de recursos do Atlas que fizeram com que a solicitação fosse negada. Retornado somente quando errorCode é ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
Não mais do que 100 elementos.
Política de Recursos do Atlas que fez com que a solicitação fosse negada.
String exclusiva 24-hexadecimal que identifica a Política de Recursos do Atlas .
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Etiqueta legível por humanos que identifica a Política de Recursos do Atlas .
Mensagens de erro de aplicativo retornadas com este erro.
Não autorizado.
Detalhes da solicitação inválida.
Descreve todas as violações em uma solicitação do cliente .
Descreve as condições ou os motivos específicos que causam cada tipo de erro.
O código de status HTTP retornado com este erro.
Código de erro do aplicativo retornado com esse erro.
Parâmetros usados para fornecer mais informações sobre o erro.
Políticas de recursos do Atlas que fizeram com que a solicitação fosse negada. Retornado somente quando errorCode é ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
Não mais do que 100 elementos.
Política de Recursos do Atlas que fez com que a solicitação fosse negada.
String exclusiva 24-hexadecimal que identifica a Política de Recursos do Atlas .
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Etiqueta legível por humanos que identifica a Política de Recursos do Atlas .
Mensagens de erro de aplicativo retornadas com este erro.
Pagamento necessário.
Detalhes da solicitação inválida.
Descreve todas as violações em uma solicitação do cliente .
Descreve as condições ou os motivos específicos que causam cada tipo de erro.
O código de status HTTP retornado com este erro.
Código de erro do aplicativo retornado com esse erro.
Parâmetros usados para fornecer mais informações sobre o erro.
Políticas de recursos do Atlas que fizeram com que a solicitação fosse negada. Retornado somente quando errorCode é ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
Não mais do que 100 elementos.
Política de Recursos do Atlas que fez com que a solicitação fosse negada.
String exclusiva 24-hexadecimal que identifica a Política de Recursos do Atlas .
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Etiqueta legível por humanos que identifica a Política de Recursos do Atlas .
Mensagens de erro de aplicativo retornadas com este erro.
Forbidden.
Detalhes da solicitação inválida.
Descreve todas as violações em uma solicitação do cliente .
Descreve as condições ou os motivos específicos que causam cada tipo de erro.
O código de status HTTP retornado com este erro.
Código de erro do aplicativo retornado com esse erro.
Parâmetros usados para fornecer mais informações sobre o erro.
Políticas de recursos do Atlas que fizeram com que a solicitação fosse negada. Retornado somente quando errorCode é ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
Não mais do que 100 elementos.
Política de Recursos do Atlas que fez com que a solicitação fosse negada.
String exclusiva 24-hexadecimal que identifica a Política de Recursos do Atlas .
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Etiqueta legível por humanos que identifica a Política de Recursos do Atlas .
Mensagens de erro de aplicativo retornadas com este erro.
Não encontrado.
Detalhes da solicitação inválida.
Descreve todas as violações em uma solicitação do cliente .
Descreve as condições ou os motivos específicos que causam cada tipo de erro.
O código de status HTTP retornado com este erro.
Código de erro do aplicativo retornado com esse erro.
Parâmetros usados para fornecer mais informações sobre o erro.
Políticas de recursos do Atlas que fizeram com que a solicitação fosse negada. Retornado somente quando errorCode é ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
Não mais do que 100 elementos.
Política de Recursos do Atlas que fez com que a solicitação fosse negada.
String exclusiva 24-hexadecimal que identifica a Política de Recursos do Atlas .
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Etiqueta legível por humanos que identifica a Política de Recursos do Atlas .
Mensagens de erro de aplicativo retornadas com este erro.
Conflito.
Detalhes da solicitação inválida.
Descreve todas as violações em uma solicitação do cliente .
Descreve as condições ou os motivos específicos que causam cada tipo de erro.
O código de status HTTP retornado com este erro.
Código de erro do aplicativo retornado com esse erro.
Parâmetros usados para fornecer mais informações sobre o erro.
Políticas de recursos do Atlas que fizeram com que a solicitação fosse negada. Retornado somente quando errorCode é ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
Não mais do que 100 elementos.
Política de Recursos do Atlas que fez com que a solicitação fosse negada.
String exclusiva 24-hexadecimal que identifica a Política de Recursos do Atlas .
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Etiqueta legível por humanos que identifica a Política de Recursos do Atlas .
Mensagens de erro de aplicativo retornadas com este erro.
Erro interno do servidor.
Detalhes da solicitação inválida.
Descreve todas as violações em uma solicitação do cliente .
Descreve as condições ou os motivos específicos que causam cada tipo de erro.
O código de status HTTP retornado com este erro.
Código de erro do aplicativo retornado com esse erro.
Parâmetros usados para fornecer mais informações sobre o erro.
Políticas de recursos do Atlas que fizeram com que a solicitação fosse negada. Retornado somente quando errorCode é ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
Não mais do que 100 elementos.
Política de Recursos do Atlas que fez com que a solicitação fosse negada.
String exclusiva 24-hexadecimal que identifica a Política de Recursos do Atlas .
O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
Etiqueta legível por humanos que identifica a Política de Recursos do Atlas .
Mensagens de erro de aplicativo retornadas com este erro.
curl \
--request POST 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/clusters/tenantUpgradeToServerless' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"name": "string",
"providerSettings": {
"backingProviderName": "AWS",
"providerName": "SERVERLESS",
"regionName": "string"
},
"serverlessBackupOptions": {
"serverlessContinuousBackupEnabled": true
},
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false
}'{
"name": "string",
"providerSettings": {
"backingProviderName": "AWS",
"providerName": "SERVERLESS",
"regionName": "string"
},
"serverlessBackupOptions": {
"serverlessContinuousBackupEnabled": true
},
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false
}{
"connectionStrings": {
"privateEndpoint": [
{
"endpoints": [
{
"endpointId": "string",
"providerName": "AWS",
"region": "string"
}
],
"srvConnectionString": "string",
"type": "MONGOS"
}
],
"standardSrv": "string"
},
"createDate": "2026-05-04T09:42:00Z",
"groupId": "32b6e34b3d91647abb20e7b8",
"id": "32b6e34b3d91647abb20e7b8",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"mongoDBVersion": "string",
"name": "string",
"providerSettings": {
"backingProviderName": "AWS",
"effectiveDiskSizeGBLimit": 42,
"effectiveInstanceSizeName": "M10",
"effectiveProviderName": "string",
"providerName": "SERVERLESS",
"regionName": "string"
},
"serverlessBackupOptions": {
"serverlessContinuousBackupEnabled": true
},
"stateName": "IDLE",
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"error": 400,
"errorCode": "VALIDATION_ERROR",
"reason": "Bad Request"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 401,
"errorCode": "NOT_ORG_GROUP_CREATOR",
"reason": "Unauthorized"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 402,
"errorCode": "NO_PAYMENT_INFORMATION_FOUND",
"reason": "Payment Required"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 403,
"errorCode": "CANNOT_CHANGE_GROUP_NAME",
"reason": "Forbidden"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"error": 404,
"errorCode": "RESOURCE_NOT_FOUND",
"reason": "Not Found"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554",
"error": 409,
"errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK",
"reason": "Conflict"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 500,
"errorCode": "UNEXPECTED_ERROR",
"reason": "Internal Server Error"
}