Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Crear un proyecto

Nota

Grupos y proyectos son términos sinónimos. Su {PROJECT-ID} es el mismo que su ID del grupo. Para los grupos existentes, su ID del grupo sigue siendo el mismo. Esta página utiliza el término más familiar grupo cuando se refiere a descripciones. El punto final permanece como se indica en el documento.

URL base: https://cloud.mongodb.com/api/public/v1.0

Para crear un proyecto dentro de una organización existente, debes tener uno de los siguientes roles en la organización especificada:

POST /groups

Este endpoint no utiliza parámetros de ruta de solicitud HTTP.

Nombre
Tipo
Necesidad
Descripción
predeterminado

bonito

booleano

Opcional

Indicador que muestra si se debe devolver el cuerpo de la respuesta en un prettyprint formato.

false

envelope

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, establezca envelope=true en la query.

Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:

  • status: Código de respuesta HTTP

  • content: Cuerpo de respuesta esperado

false

Nombre
Tipo
Necesidad
Descripción

Nombre

string

Requerido

Etiqueta legible por humanos que identifica el proyecto.

orgId

string

Requerido

string única de dígitos hexadecimales de 24caracteres que identifica la organización en la que se va a crear el proyecto.

Cloud Manager estableció el Organization Owner más antiguo de la organización especificada como un Project Owner para el nuevo proyecto.

Nombre
Tipo
Descripción

activeAgentCount

entero

Número de agentes activos que envían pings regulares a Cloud Manager.

El valor se actualiza aproximadamente cada 24 horas y se almacena en caché. Si comienza un nuevo agente o detiene uno existente, el cambio puede tardar hasta 30 minutos en aparecer en el campo activeAgentCount.

hostCounts

Objeto

Número total de hosts por tipo. Los campos integrados deben ser autoexplicativos.

ID

string

Identificador único para el grupo.

lastActiveAgent

string

Time Cloud Manager actualizó por última vez el total activeAgentCount del proyecto. Cloud Manager actualiza este valor cada 24 horas y lo almacena en caché para registrar la cantidad de agentes de MongoDB activos.

enlaces

objeto arreglo

Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los arreglos links en las respuestas contienen al menos un enlace llamado self. Las relaciones entre las URLse explican en la Especificación de Web Linking.

Nombre

string

Nombre para mostrar del proyecto.

orgId

string

Identificador único para la organización a la que pertenece el proyecto.

publicApiEnabled

booleano

Marca que indica que la API está habilitada para este Proyecto. Este es un campo de solo lectura que siempre es true.

recuento de réplicaSet

entero

Número total de sets de réplicas para este proyecto.

shardCount

entero

Número total de particiones en este proyecto.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request POST "https://cloud.mongodb.com/api/public/v1.0/groups?pretty=true" \ --data ' { "name": "Create Project API Example", "orgId": "deffb2031b938da53f16d714" }'
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 201 CreatedVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
{ "activeAgentCount" : 0, "agentApiKey" : "{GROUP-API-KEY}", "hostCounts" : { "arbiter" : 0, "config" : 0, "mongos" : 0, "primary" : 0, "secondary" : 0 }, "id" : "{PROJECT-ID}", "links" : [], "name" : "Create Project API Example", "orgId" : "{ORG-ID}", "publicApiEnabled" : true, "replicaSetCount" : 0, "shardCount" : 0, "tags" : [ ]}