Nota
Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} Es el mismo que el ID de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. Esta página utiliza el término "grupo" para las descripciones. El punto final se mantiene como se indica en el documento.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Roles necesarios
Para crear un proyecto dentro de una organización existente, debe tener uno de los siguientes roles en la organización especificada:
Nota
Si crea un proyecto utilizando un Clave API de una organización sin un, Ops Manager crea el proyecto Organization Owner sin Project Owner un.
Resource
POST /groups
Request Parameters
Parámetros de la ruta de solicitud
Este punto final no utiliza parámetros de ruta de solicitud HTTP.
Parámetros de consulta de solicitud
Nombre | Tipo | Necesidad | Descripción | predeterminado | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
bonita | booleano | Opcional | Bandera que indica si el cuerpo de la respuesta debe estar en un impresión bonita formato. |
| ||||||
envolvente | booleano | Opcional | Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes de API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionarlo, configure envelope=true en la consulta. Para los puntos finales que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
Nombre | string | Requerido | Etiqueta legible por humanos que identifica el proyecto. |
orgId | string | Requerido | Cadena de dígitos hexadecimales 24única que identifica la organización dentro de la cual se creará el proyecto. Ops Manager establece el más antiguo de la |
Respuesta
Nombre | Tipo | Descripción | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
activeAgentCount | entero | Número de agentes activos que envían pings regulares a Ops Manager. El valor se actualiza aproximadamente cada 24 horas y se almacena en caché. Si inicia un nuevo agente o detiene uno existente, el cambio puede tardar hasta 30 minutos en aparecer en el campo | ||||||||||||||||||
hostCounts | Objeto | Número total de hosts por tipo. Los campos incrustados deberían ser autoexplicativos. | ||||||||||||||||||
ID. | string | Identificador único del proyecto. | ||||||||||||||||||
último agente activo | string | Hora de la última actualización del total de | ||||||||||||||||||
Asignaciones de grupos ldap | matriz de objetos | Para Ops Manager con respaldo LDAP, las asignaciones de grupos LDAP a roles de proyecto de Ops Manager. Solo está presente para Ops Manager con respaldo LDAP. | ||||||||||||||||||
ldapGroupMappings .roleName | string | Rol de usuario de Ops Manager. La asignación de Rol de proyecto a
| ||||||||||||||||||
ldapGroupMappings .ldapGroups | matriz de cadenas | Proyecto(s) LDAP que se asignan al rol de Administrador de operaciones. | ||||||||||||||||||
enlaces | matriz de objetos | Uno o más enlaces a subrecursos o recursos relacionados. Todas las | ||||||||||||||||||
Nombre | string | Nombre para mostrar del proyecto. | ||||||||||||||||||
orgId | string | Identificador único de la organización a la que pertenece el proyecto. | ||||||||||||||||||
publicApiEnabled | booleano | Indicador que indica que la API está habilitada para este proyecto. Este campo es de solo lectura y siempre | ||||||||||||||||||
recuento de conjuntos de réplicas | entero | Número total de conjuntos de réplicas para este proyecto. | ||||||||||||||||||
recuento de fragmentos | entero | Número total de fragmentos para este proyecto. | ||||||||||||||||||
Etiquetas | matriz de cadenas | Etiquetas asignadas al proyecto para su uso en la identificación programática del proyecto.
Un proyecto puede tener hasta 10 etiquetas. Las etiquetas siguen estas reglas:
|
Ejemplo de solicitud
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request POST "https://{opsManagerHost}:{port}/api/public/v1.0/groups?pretty=true" \ --data ' { "name": "Create Project API Example", "orgId": "deffb2031b938da53f16d714" }'
Ejemplo de respuesta
Encabezado de respuesta
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
201 Created Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
Cuerpo de respuesta
{ "activeAgentCount" : 0, "agentApiKey": "{GROUP-API-KEY}", "hostCounts" : { "arbiter" : 0, "config" : 0, "primary" : 0, "secondary" : 0, "mongos" : 0 }, "id" : "{PROJECT-ID}", "ldapGroupMappings" : [ { "roleName": "GROUP_OWNER", "ldapGroups": [ project-owner" ] }, ... ], "links" : [], "name" : "Create Project API Test", "orgId" : "deffb2031b938da53f16d714", "publicApiEnabled": true, "replicaSetCount" : 0, "shardCount" : 0, "tags": [ "DEV", "PRODUCT" ] }