- Recursos
- Introducción a la API REST de Micetro (v25.1+)
Introducción a la API REST de Micetro (v25.1+)
Automatiza e integra todos los aspectos de la gestión de tu DNS, DHCP y direcciones IP
El artículo presenta la API REST de BlueCat Micetro (v25.1+) como un plano de control «API-first» para automatizar la gestión de DNS, DHCP y direcciones IP (DDI) en entornos híbridos, de múltiples proveedores y en la nube. Describe el diseño basado en recursos de la API, los puntos finales comunes, la autenticación (se recomiendan los tokens de portador), los métodos HTTP admitidos, los parámetros de consulta avanzados para el filtrado y la paginación, así como herramientas prácticas y flujos de trabajo de scripting (Postman, PowerShell, Python) para la orquestación, las operaciones masivas, la auditoría y la automatización segura. Las directrices operativas y las mejores prácticas abarcan las propiedades personalizadas, el control de acceso basado en roles, las operaciones masivas, la gestión de errores, la auditoría del historial y las prácticas de seguridad para garantizar una automatización de DDI fiable y conforme a la normativa a gran escala.
How do I authenticate to the Micetro REST API for automated scripts and what are the recommended practices?
The recommended method for automation is session-based bearer tokens obtained by authenticating to the /sessions endpoint; the returned JSON includes the session token which you must send as Authorization: Bearer on subsequent API requests. Best practices: never hardcode credentials or tokens in code, store tokens in environment variables or secure vaults, use short-lived tokens and rotate them regularly, enforce least-privilege roles for API users, avoid using admin tokens in automation unless necessary, and audit authentication attempts via event history. NTLM or Kerberos are alternatives for AD-integrated Windows deployments; legacy basic auth is supported but not recommended.
What are the key query parameters for filtering and paging large result sets, and how should I use them in automation?
Micetro supports filter, sortBy, sortOrder, offset, limit, targetRef, and pretty parameters. Use filter for targeted searches (simple, regex, Boolean, sets, or nested expressions) to narrow results; sortBy and sortOrder provide predictable ordering; offset and limit implement pagination—always use limit and process results in chunks (for example 100 at a time) to avoid memory or timeout issues. targetRef anchors paging at a specific object when needed. Combine parameters (e.g., ?filter=name=corp&sortBy=lastModified&limit=25) and prefer filterable bulk endpoints for efficient multi-object automation. For human exploration only, use pretty=true.
What operational best practices does the article recommend for secure, reliable bulk operations and auditing?
For bulk operations, use endpoints that accept batch payloads (dnsrecords, ranges, ipamrecords) to submit multiple objects in a single POST, parse per-object success/failure responses, and break very large jobs into smaller chunks using limit/offset to improve reliability. For auditing and traceability, define and use custom properties via /propertydefinitions to store metadata (owner, environment, cost center) and query change history with event history endpoints (e.g., /history). Additional practices include enforcing least-privilege RBAC via /access and /roles, validating data locally before submission, logging full request/response details for errors, rotating tokens and service account credentials, and regularly reviewing audit logs and failed authentication attempts.
Contents
- Resumen ejecutivo
- Introducción
- Autenticación
- Métodos HTTP admitidos
- Recursos u objetos de nivel superior de la API
- Trabajar con recursos
- Cuándo y cómo utilizar los parámetros de consulta
- Consejos, patrones y uso avanzado
-
Ejemplos de automatización y resolución de problemas
- Mostrar todos los servidores DNS
- Solicitar salida en XML (en lugar de JSON)
- Listar los registros A que empiezan por «vm» en una zona
- Añadir un registro DNS
- Filtrado avanzado por varios tipos
- Crear registros DNS de forma masiva
- Obtener el historial de eventos de una zona DNS
- Crear una propiedad personalizada (definición de propiedad)
- Obtener todos los ámbitos DHCP, ordenados por servidor DHCP
- Obtener todas las concesiones DHCP de un ámbito
- Filtrar por una propiedad personalizada
- Combinación de parámetros de consulta
- Prácticas recomendadas
- Uso y flujos de trabajo de Postman
- Ejemplos de scripts para PowerShell
- Ejemplos de scripts en Python
- Recursos adicionales clave
Resumen ejecutivo
A medida que las redes se vuelven cada vez más híbridas, distribuidas y automatizadas, la capacidad de gestionar mediante programación los sistemas de DNS, DHCP y gestión de direcciones IP (conocidos en conjunto como DDI) resulta esencial para mantener la agilidad y la coherencia en toda la empresa. La API REST de BlueCat Micetro ofrece una interfaz unificada y basada en estándares para automatizar y orquestar todos los componentes de la infraestructura DDI —que abarca Microsoft, BIND, Kea, Cisco, plataformas en la nube y dispositivos BlueCat— a través de un único plano de control cohesionado.
Desarrollada como una plataforma «API-first», Micetro expone casi todas las funcionalidades de DDI a través de puntos finales REST, lo que permite a los administradores de red y a los equipos de DevOps:
- Automatizar tareas y flujos de trabajo repetitivos
- Integrarse con marcos de automatización empresarial, pipelines de CI/CD y sistemas de gestión de servicios de TI
- Auditar cambios y garantizar el cumplimiento
- Coordinar servicios en entornos en la nube e híbridos
Al tratar cada objeto DDI gestionado como un recurso accesible a través de métodos HTTP estándar, la API simplifica las tareas administrativas complejas, agiliza los flujos de trabajo de cambios y garantiza la coherencia de la configuración en todos los entornos.
Este informe técnico ofrece una introducción práctica a la estructura, los patrones de uso y las mejores prácticas operativas de la API REST de Micetro. Diseñada para ingenieros de redes, equipos de DevOps e integradores de sistemas, la API de Micetro permite automatizar, orquestar e integrar operaciones de DDI en entornos de Microsoft, BIND, Kea, Cisco y en la nube. Este documento destaca cómo los equipos pueden ampliar las capacidades de automatización de Micetro mediante lenguajes de scripting como PowerShell y Python, o mediante la integración con marcos de automatización empresarial.
Este documento incluye ejemplos prácticos que ilustran cómo utilizar la API para la automatización, la resolución de problemas y el desarrollo de flujos de trabajo. Ofrece una guía paso a paso para importar la especificación OpenAPI a Postman con fines de exploración y pruebas, junto con scripts de ejemplo en PowerShell y Python. En la sección final se enumeran recursos adicionales clave para profundizar en su comprensión de Micetro y acelerar sus iniciativas de automatización con esta herramienta.
Introducción
Micetro ofrece una API REST robusta y moderna para automatizar e integrar todos los aspectos de la DDI. La API REST proporciona un acceso completo, seguro y escalable a su entorno de DDI. Es la interfaz preferida para todas las tareas de automatización e integración, ya que admite tanto flujos de trabajo cotidianos como escenarios avanzados de automatización personalizados para equipos de red de cualquier tamaño. Tanto si está desarrollando integraciones, creando scripts para operaciones rutinarias o gestionando el ciclo de vida completo de los recursos de red, la API REST de Micetro ofrece la flexibilidad y la potencia necesarias para las empresas actuales, híbridas, multicloud y centradas en el cumplimiento normativo.
Puntos finales de la API:
- URL base: https://<micetro.tudominio.tld>/mmws/api/v2/
- Documentación interactiva de Swagger: https://<micetro.tudominio.tld>/mmws/api/doc/
- Descarga de OpenAPI (Swagger): https://<micetro.tudominio.tld>/mmws/api/swagger.json
La documentación y el esquema de la API están siempre actualizados en estas URL. También puedes importarlos a Postman u otras herramientas de API para explorarlos o realizar pruebas de flujos de trabajo.
Nota medioambiental:
Todos los ejemplos de estilo POSIX de este documento se han validado en Ubuntu 24.04 LTS utilizando el comando curl proporcionado por el sistema y las bibliotecas estándar de OpenSSL. Su entorno puede ser diferente. Variables como el sistema operativo, la versión de Micetro, las URL de la API, la configuración de TLS, la confianza en los certificados y los ajustes de autenticación pueden requerir ajustes en los comandos de ejemplo.
Por ejemplo, los entornos que utilicen certificados autofirmados pueden requerir el uso de `curl -k` (modo no seguro) para eludir la verificación estricta de TLS durante las pruebas. Utilice esta opción únicamente en entornos controlados que no sean de producción.
Autenticación
La autenticación recomendada para la API REST es mediante un token de portador (basado en sesión). Un token de portador es el método más seguro y flexible tanto para el uso interactivo como para la automatización. Evita tener que incluir credenciales en cada llamada a la API y permite establecer tiempos de espera de sesión y un control granular de privilegios.
Cómo obtener un token de sesión:
El JSON devuelto incluye un token de sesión. Utiliza este token como token de portador en el encabezado de autorización de todas las solicitudes de API posteriores:
Nota de seguridad: Nunca incluyas contraseñas en el código ni compartas tokens de sesión en los registros. Utiliza siempre variables de entorno o almacenes seguros en la automatización real.
Otros métodos de autenticación compatibles:
- NTLM o Kerberos: para entornos locales o de Active Directory (AD) de Windows con Micetro Central instalado en un servidor miembro de un dominio de Windows.
- Obsoleto: se admite la autenticación básica, pero no se recomienda para la automatización ni la creación de scripts.
Métodos HTTP admitidos
En REST, la atención se centra en los recursos. Se especifica un recurso mediante su URL y, a continuación, se le aplica una operación utilizando un método HTTP.
Los cuatro métodos HTTP más comunes son GET, PUT, POST y DELETE, tal y como se describe en la tabla siguiente
| Method | Description |
| GET | Retrieve resources and object details (read-only operations) |
| POST | Create resources or trigger specific server-side operations |
| PUT | Update resources (entire object or specific properties) |
| DELETE | Remove resources from the system |
Muchos puntos finales admiten operaciones avanzadas, como la creación masiva, la actualización por lotes y acciones especializadas (por ejemplo, consultas de registros de auditoría, adiciones masivas de registros DNS, etc.). Consulte la documentación de la API de cada recurso.
Recursos u objetos de nivel superior de la API
La siguiente tabla enumera todos los puntos finales de recursos principales de la API REST, utilizando nombres en minúsculas y en plural. Cada punto final proporciona acceso a un tipo de objeto clave o a una funcionalidad del sistema en Micetro.
| Resource | Description |
| adForests | AD forests |
| adSiteLinks | AD site link |
| adSites | AD sites |
| addressSpaces | Organizations |
| appliances | Appliances |
| changeRequests | Change requests |
| cloudNetworks | Cloud networks |
| Resource | Description |
| cloudServiceAccounts | Cloud integration |
| devices | Connectable devices |
| dhcpAddressPools | DHCP address pools |
| dhcpExclusions | DHCP exclusions |
| dhcpGroups | DHCP groups |
| dhcpReservations | DHCP reservations |
| dhcpScopes | DHCP scopes |
| dhcpServers | DHCP servers |
| dhcpSuperscopes | DHCP superscopes |
| dnsRecords | DNS records |
| dnsServers | DNS servers |
| dnsViews | DNS views |
| dnsZones | DNS zones |
| folders | Folders for objects and custom filters |
| groups | User groups |
| interfaces | Device interfaces |
| ipamRecords | IP address management (IPAM) records |
| micetro | General Micetro system information |
| ranges | IP address ranges |
| reportDefinitions | Report definitions |
| reportSources | Report sources |
| reports | Reports |
| roles | User and group roles |
| users | User administration |
Para obtener un desglose completo de los métodos, modelos de datos y parámetros disponibles para cada recurso, consulta la documentación interactiva de la API en /mmws/api/doc/ o visita https://api.menandmice.com/.
Trabajar con recursos
En el contexto de la API REST de Micetro, un recurso representa cualquier objeto o entidad gestionable dentro del sistema Micetro, como una zona DNS, un ámbito DHCP, una dirección IP, un usuario o un servidor. Cada recurso se corresponde con un componente concreto de su infraestructura DDI al que se puede acceder y manipular mediante programación a través de la API.
Los recursos son la base del diseño de la API de Micetro. Cada punto final REST se centra en un recurso, identificado por una URL única, al que se accede mediante métodos HTTP estándar. Cada tipo de recurso se agrupa en una ruta, y cada recurso tiene un identificador de referencia único.
Rutas e identificadores de recursos
- Las rutas de los recursos de la API siguen el patrón /mmws/api/v2/<recurso> (por ejemplo, /mmws/api/v2/dnszones).
- Cada objeto tiene una cadena de referencia única (por ejemplo, dnsZones/12345). La mayoría de los puntos finales admiten hacer referencia a los objetos mediante esta referencia, un nombre único o un identificador numérico. En caso de duda, utiliza siempre la referencia.
- Muchos puntos finales tienen una estructura jerárquica (por ejemplo, los registros DNS pertenecen a una zona: /dnszones/<zone-ref>/dnsrecords).
Parámetros comunes de consulta
La API REST de Micetro ofrece una amplia variedad de parámetros de consulta para buscar, filtrar, ordenar y paginar resultados, lo que permite una recuperación eficiente de los datos y minimiza el uso de ancho de banda.
| Parameter | Type | Purpose and example |
| filter | string | Filter results on properties. Flexible, supports logical/comparison/set operators. Example: filter=name~^corp AND type=A |
| sortBy | string | Sort results by a property. Most often name, created, lastModified, or a custom property. Example: sortBy=name |
| sortOrder | string | Sort direction, either ascending (default) or descending. Example: sortOrder=Descending |
| offset | integer | Skip a certain number of records for pagination. Example: offset=50 |
| limit | integer | Return a maximum number of records. Example: limit=100 |
| pretty | bool | Pretty-print (indented) JSON for human reading. Not needed in automation. Example: pretty=true |
| targetRef | string | Get a page of results where the specified object appears first (useful for UI-driven automation). |
Cuándo y cómo utilizar los parámetros de consulta
filter
- Objetivo: Centrar los resultados en un subconjunto que se ajuste a tus criterios; ideal para informes, paneles de control o automatizaciones que solo deban procesar datos relevantes.
- Aspectos destacados de la sintaxis: Simple: name=corp.com.
- Expresión regular: name~prod-
- Lógico: AND, OR, NOT (p. ej., type=A OR type=CNAME)
- Conjuntos: introduce {A,CNAME}
- Negación: type!=A O NOT type=A
- Anidado: (nombre~”dev- Y tipo=A) O (nombre~”prod- Y tipo=CNAME)
sortBy y sortOrder
- Objetivo: Controlar el orden para obtener resultados predecibles, interfaces de usuario intuitivas y una paginación eficiente.
- Uso: Se puede ordenar por cualquier propiedad simple, propiedad personalizada o incluso campos calculados o derivados (consulta la documentación).
- Por defecto: si no se especifica, la ordenación predeterminada varía según el punto final (a menudo por nombre o fecha de creación).
- Ejemplo: Obtener las zonas DNS actualizadas más recientemente:
desplazamiento y límite
- Objetivo: Paginación de conjuntos de resultados extensos. Utiliza siempre el parámetro «limit» para listas de resultados ilimitadas.
- Práctica recomendada: en la programación y la automatización, procesa siempre los resultados por lotes (por ejemplo, 100 a la vez) para evitar problemas de memoria o de tiempo de espera.
- Ejemplo: Recuperar los registros 201-300 de un conjunto grande:
targetRef
- Objetivo: Anclar la paginación a un objeto específico, lo cual resulta útil para una navegación coherente en flujos de trabajo basados en la interfaz de usuario o en herramientas de conciliación.
- Ejemplo: Recuperar una página de resultados con un registro concreto al principio (consulta la documentación para ver cómo se utiliza).
pretty
- Finalidad: Para obtener una salida legible por el usuario en la exploración. Rara vez se utiliza en la automatización de producción.
- Ejemplo:
Consejos, patrones y uso avanzado
- Utiliza filtros en las propiedades personalizadas igual que en los campos integrados: filter=CustomTag=Finance
- Combinar parámetros de consulta: p. ej., ?filter=name=corp&sortBy=lastModified&limit=25
- Las API de recursos masivos (como registros DNS, rangos, etc.) se pueden filtrar para la automatización de múltiples objetos.
- Muchas consultas de recursos distinguen entre mayúsculas y minúsculas; consulta la documentación de la API para obtener detalles específicos de cada recurso.
- Los filtros específicos de recursos (por ejemplo, dnsrecords admite tipo, datos, tiempo de vida, etc.) permiten realizar búsquedas muy precisas.
- Utiliza siempre «limit» y «offset» al escribir scripts de automatización por lotes y al recuperar conjuntos de datos de gran tamaño.
- Para un uso más avanzado, se admiten expresiones de filtro booleanas anidadas y complejas; consulta los ejemplos de Swagger y OpenAPI.
Ejemplos de automatización y resolución de problemas
Los siguientes ejemplos ilustran diversos casos prácticos de automatización y resolución de problemas utilizando Curl y la API. Para ver más ejemplos, consulta las secciones sobre scripts que aparecen a continuación.
Mostrar todos los servidores DNS
Solicitar salida en XML (en lugar de JSON)
Listar los registros A que empiezan por «vm» en una zona
Añadir un registro DNS
Filtrado avanzado por varios tipos
Crear registros DNS de forma masiva
Obtener el historial de eventos de una zona DNS
Crear una propiedad personalizada (definición de propiedad)
Obtener todos los ámbitos DHCP, ordenados por servidor DHCP
Obtener todas las concesiones DHCP de un ámbito
Filtrar por una propiedad personalizada
Combinación de parámetros de consulta
Prácticas recomendadas
En esta sección se recomiendan las mejores prácticas para diseñar, automatizar y proteger las integraciones creadas con la API REST de Micetro. Dado que la API proporciona acceso programático completo a los recursos de gestión de DNS, DHCP y direcciones IP, es esencial seguir estándares coherentes que promuevan la fiabilidad, la seguridad y la facilidad de mantenimiento. Las siguientes directrices se centran en áreas operativas clave —entre las que se incluyen las propiedades personalizadas, el control de acceso basado en roles, las operaciones masivas, el historial de cambios, la gestión de errores y la seguridad— para ayudar a garantizar que tus scripts e integraciones sigan patrones contrastados que permitan una interacción segura y eficiente con Micetro.
Propiedades personalizadas
- Utilice los puntos finales /propertydefinitions para definir y gestionar campos personalizados en objetos para metadatos empresariales o técnicos (por ejemplo, propietario del activo, entorno, ubicación o centro de coste).
- Almacena el estado de la automatización, el historial de cambios y las etiquetas de propiedad como propiedades personalizadas para facilitar la trazabilidad y la elaboración de informes.
- Utilizar filtros de propiedades personalizadas para informes y scripts: filter=owner=devops
- Documenta los nombres y tipos de las propiedades personalizadas en tu guía de estilo de la API interna.
Control de acceso basado en roles
- Todos los recursos admiten permisos granulares: concede acceso a zonas, rangos, grupos y mucho más.
- Utiliza los puntos de acceso /access para auditar y gestionar los permisos de cualquier usuario o grupo.
- Aplica siempre el principio de privilegios mínimos para todos los usuarios de la API (nunca utilices tokens de administrador en la automatización a menos que sea necesario).
- Utiliza los roles (creados a través de /roles) para representar el acceso real basado en equipos o funciones.
- Rotar las asignaciones de roles y revisar periódicamente los registros de auditoría en busca de cambios sensibles.
Operaciones masivas
- Los puntos finales como dnsrecords, ranges e ipamrecords admiten la creación o actualización por lotes: envía varios objetos en una sola solicitud POST para mayor rapidez y eficiencia.
- Las operaciones masivas devuelven respuestas estructuradas, incluyendo el éxito o el fallo por objeto; analiza y notifica siempre los errores en la automatización.
- Utiliza «limit» y «filter» para dividir los trabajos grandes en partes más pequeñas y fiables.
- Las actualizaciones por lotes son ideales para la incorporación de nuevos usuarios, las migraciones y las correcciones de cumplimiento normativo.
Historial
- Utilice los puntos finales del historial de eventos (por ejemplo, /history) para consultar todos los cambios realizados en un recurso o para auditar las acciones de los usuarios a lo largo del tiempo.
Gestión de errores
- Todas las respuestas de error están estructuradas en formato JSON con códigos y mensajes (consulta la documentación de la API para ver la lista).
- La automatización siempre debe comprobar los códigos de estado HTTP y analizar el JSON de error para garantizar un manejo robusto.
- Validar todos los datos localmente antes de enviar las solicitudes (por ejemplo, formatos de direcciones IP, tipos de propiedad).
- Registra los errores con todos los detalles de la solicitud y la respuesta para la auditoría y la resolución de problemas.
- En las operaciones masivas, gestiona con elegancia tanto los fallos parciales como los totales.
Seguridad
- Utiliza tokens de sesión de corta duración y guárdalos en variables de entorno o almacenes de secretos; nunca los incluyas en el código de forma estática.
- Rota las contraseñas o los tokens de las cuentas de servicio con regularidad; nunca reutilices tokens entre entornos (por ejemplo, desarrollo y producción).
- Limitar las cuentas de usuario de la API a los privilegios y el ámbito mínimos necesarios.
- Revisa periódicamente los registros de acceso a la API y los intentos fallidos de autenticación (consulta /history y la consola de administración).
- Dar prioridad a los puntos finales HTTPS para todas las llamadas a la API y verificar los certificados.
- Automatizar las comprobaciones de caducidad de sesiones o tokens en toda la automatización persistente.
Uso y flujos de trabajo de Postman
La API REST de Micetro está completamente documentada mediante una especificación OpenAPI (Swagger) que puedes importar directamente a herramientas como Postman para la exploración interactiva y la automatización de flujos de trabajo. En esta sección se explica cómo cargar la definición de la API, configurar un entorno de Postman y establecer flujos de trabajo de autenticación mediante tokens de sesión. Seguir estos pasos te proporcionará un espacio de trabajo completo y listo para usar con el que probar puntos de conexión, encadenar solicitudes autenticadas y gestionar escenarios de automatización habituales, como actualizaciones masivas o solicitudes de cambio. Al mantener tus colecciones de Postman sincronizadas con la última especificación OpenAPI de Micetro, te aseguras de que tus integraciones sigan siendo precisas, eficientes y estén alineadas con el esquema actual de la API.
Importación de la API
- Descargar la especificación OpenAPI/Swagger: https://<micetro>/mmws/api/swagger.json
- Importa a Postman como una colección para obtener referencias completas y actualizadas de los puntos finales y los esquemas.
- Crear o configurar un entorno con estas variables:
Uso de Postman para flujos de trabajo
- Flujo de trabajo de inicio de sesión: crea una solicitud POST a /sessions y configura {{token}} a partir de la respuesta utilizando un script de prueba o una variable de entorno.
- Encadenamiento de solicitudes: utiliza los entornos de Postman para establecer automáticamente «Authorization: Bearer {{token}}» en los encabezados de todas las solicitudes.
- Colecciones y automatización: utiliza carpetas para agrupar flujos de trabajo (por ejemplo, «registros DNS», «operaciones masivas», «solicitudes de cambio»). Guarda los filtros que utilices con frecuencia o las actualizaciones masivas como solicitudes reutilizables.
- Importación y pruebas masivas: importar Swagger u OpenAPI directamente para cada nueva versión de Micetro con el fin de
Ejemplo: Adquisición automatizada de tokens de Postman (script de prueba)
A continuación, en las solicitudes posteriores, utiliza la variable: Authorization: Bearer {{bearerToken}}
Ejemplos de scripts para PowerShell
El uso de un lenguaje de scripting como PowerShell ofrece una forma potente y flexible de automatizar las interacciones con la API REST de Micetro. PowerShell permite a los administradores y a los equipos de DevOps crear scripts para flujos de trabajo repetibles, integrar los datos de Micetro en marcos de automatización de TI más amplios y realizar operaciones complejas en recursos de gestión de DNS, DHCP y direcciones IP con un esfuerzo manual mínimo. Dado que PowerShell admite de forma nativa las solicitudes RESTful, el análisis de JSON y la gestión segura de credenciales, resulta ideal para crear una automatización fiable y apta para entornos de producción, ya sea para actualizaciones masivas, la generación de informes programados o la integración de Micetro con otros sistemas y flujos de servicios. A continuación se muestran ejemplos básicos de cómo utilizar la API de Micetro en PowerShell para autenticarse, añadir registros y gestionar errores.
Autenticar y mostrar una lista de zonas DNS
Añadir un registro DNS
Crear registros DNS de forma masiva
Ejemplo de gestión de errores
Ejemplos de scripts en Python
Python ofrece un enfoque versátil y multiplataforma para automatizar las interacciones con la API REST de Micetro. Su amplio ecosistema de bibliotecas para solicitudes HTTP, gestión de JSON y procesamiento de datos facilita la creación de automatizaciones portátiles que se ejecutan de forma coherente en Windows, Linux y macOS. Ya sea para integrar Micetro en flujos de trabajo de TI existentes, realizar análisis de datos de gestión de DNS y direcciones IP, u orquestar cambios de configuración a gran escala, Python proporciona una base flexible para ampliar las capacidades de Micetro más allá de la interfaz de usuario.
La siguiente sección ofrece breves ejemplos para empezar a utilizar la API de Micetro en Python.
Autenticar y mostrar una lista de zonas DNS
Añadir un registro DNS
Crear registros DNS de forma masiva
Buscar registros sospechosos en zonas inversas
Ejemplo de gestión de errores
Recursos adicionales clave
Para ayudarte a seguir desarrollando, automatizando e integrando con Micetro, los siguientes recursos ofrecen orientación técnica detallada, referencias de la API y apoyo de la comunidad. Estos materiales garantizan que tus integraciones se mantengan alineadas con las versiones actuales y las mejores prácticas a medida que Micetro evoluciona.
Documentación de la API REST de Micetro
- Documentación interactiva de la API: https://<micetro>/mmws/api/doc/Explora los puntos finales, los parámetros y los ejemplos en tiempo real directamente en tu navegador.
- Especificación OpenAPI/Swagger: https://<micetro>/mmws/api/swagger.json Descarga el esquema completo para importarlo a Postman u otras herramientas de API.
Recursos para desarrolladores y automatización
- Portal de documentación de Micetro: https://docs.bluecatnetworks.comGet: guías completas sobre el uso de la API, los módulos de automatización, la creación de scripts y la configuración del sistema.
- Ejemplos de automatización: https://github.com/menandmiceVisit el GitHub de Micetro para ver scripts de ejemplo en PowerShell y Python, además de casos de uso avanzados con Ansible y Terraform.
- Colecciones de Postman: importa la última definición de Swagger para mantener los flujos de trabajo actualizados con cada lanzamiento de Micetro.
Comunidad y asistencia
- Portal BlueCat Care: https://care.bluecatnetworks.comAccess artículos de la base de conocimientos, actualizaciones de productos y asistencia técnica.
- Comunidad BlueCat: https://community.bluecatnetworks.comJoin: participa en debates con otros usuarios, comparte ejemplos de automatización y mantente al día sobre las nuevas funciones y versiones de Micetro.
- Para la resolución avanzada de problemas o la automatización personalizada, consulta siempre primero la documentación interactiva de la API y el esquema de Swagger. Estos reflejan la estructura más reciente de la API y los parámetros compatibles en todas las versiones de Micetro.
¿Listo para automatizar el DDI de tu empresa con Micetro?
Descubre cómo la API REST de Micetro unifica la automatización de DDI en entornos híbridos, de múltiples proveedores y en la nube.