Criar um projeto
Cria um projeto. Projeta clusters de grupos em coleções lógicas compatíveis com um ambiente de aplicativo, volume de trabalho ou ambos. Cada projeto pode ter seus próprios usuários, equipes, segurança, marcações e configurações de alerta. Para usar esse recurso, a conta de serviço ou a chave de API solicitante deve ter a função de leitura e gravação.
parâmetros de query
-
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.Prettyprint -
String exclusiva de 24 dígitos hexadecimais que identifica o usuário do MongoDB Cloud a quem conceder a função "Proprietário do projeto" no projeto especificado. Se você definir este parâmetro, ele substituirá o valor padrão do proprietário da organização mais antigo.
O formato deve corresponder ao seguinte padrão:
^([a-f0-9]{24})$.
corpo, corpo
Obrigatório
Cria um projeto.
-
Etiqueta legível por humanos que identifica o projeto incluído na organização MongoDB Cloud.
O formato deve corresponder ao seguinte padrão:
^[\p{L}\p{N}\-_.(),:&@+']{1,64}$. -
String exclusiva de 24 dígitos hexadecimais que identifica a organização MongoDB Cloud à qual o projeto pertence.
O formato deve corresponder ao seguinte padrão:
^([a-f0-9]{24})$. -
Aplica-se apenas ao Atlas for Government.
No Atlas Comercial, esse campo será rejeitado nas solicitações e estará ausente nas respostas.
Este campo define restrições em regiões disponíveis no projeto.
COMMERCIAL_FEDRAMP_REGIONS_ONLY: Permite apenas implantações em regiões FedRAMP moderadas.GOV_REGIONS_ONLY: Permite apenas implantações em regiões GovCloud.Os valores são
COMMERCIAL_FEDRAMP_REGIONS_ONLYouGOV_REGIONS_ONLY. O valor padrão éCOMMERCIAL_FEDRAMP_REGIONS_ONLY.Documentação externa -
Sinalizador que indica se o projeto deve ser criado com as configurações de alerta padrão. Esta configuração não pode ser atualizada após a criação do projeto .
O valor padrão é
true.
atlas api projects createGroup --helpimport (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20250312001/admin"
)
func main() {
ctx := context.Background()
clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")
// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))
if err != nil {
log.Fatalf("Error: %v", err)
}
params = &sdk.CreateGroupApiParams{}
sdkResp, httpResp, err := client.ProjectsApi.
CreateGroupWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2025-03-12+json" \
--header "Content-Type: application/json" \
-X POST "https://cloud.mongodb.com/api/atlas/v2/groups" \
-d '{ <Payload> }'curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2025-03-12+json" \
--header "Content-Type: application/json" \
-X POST "https://cloud.mongodb.com/api/atlas/v2/groups" \
-d '{ <Payload> }'{
"name": "string",
"orgId": "32b6e34b3d91647abb20e7b8",
"regionUsageRestrictions": "COMMERCIAL_FEDRAMP_REGIONS_ONLY",
"tags": [
{
"key": "string",
"value": "string"
}
],
"withDefaultAlertsSettings": true
}{
"clusterCount": 42,
"created": "2025-05-04T09:42:00Z",
"id": "32b6e34b3d91647abb20e7b8",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"name": "string",
"orgId": "32b6e34b3d91647abb20e7b8",
"regionUsageRestrictions": "COMMERCIAL_FEDRAMP_REGIONS_ONLY",
"tags": [
{
"key": "string",
"value": "string"
}
],
"withDefaultAlertsSettings": true
}{
"error": 400,
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"reason": "Bad Request",
"errorCode": "VALIDATION_ERROR"
}{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}{
"error": 409,
"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",
"reason": "Conflict",
"errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}