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

BlueCat white paper cover introducing Micetro REST API v25.1+ for DNS, DHCP, and IP address management
Puntos claveEsta idea clave se generó mediante modelos de lenguaje grande (LLM) que rastrearon la página y elaboraron un resumen del contenido.

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.

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:

cURL command example creating BlueCat API session with JSON username and password

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:

Example HTTP Authorization header using Bearer scheme with a session token placeholder

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

MethodDescription
GETRetrieve resources and object details (read-only operations)
POSTCreate resources or trigger specific server-side operations
PUTUpdate resources (entire object or specific properties)
DELETERemove 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.

ResourceDescription
adForestsAD forests
adSiteLinksAD site link
adSitesAD sites
addressSpacesOrganizations
appliancesAppliances
changeRequestsChange requests
cloudNetworksCloud 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.

ParameterTypePurpose and example
filterstringFilter results on properties. Flexible, supports logical/comparison/set operators.
Example: filter=name~^corp AND type=A
sortBystringSort results by a property. Most often name, created, lastModified, or a custom property.
Example: sortBy=name
sortOrderstringSort direction, either ascending (default) or descending.
Example: sortOrder=Descending
offsetintegerSkip a certain number of records for pagination.
Example: offset=50
limitintegerReturn a maximum number of records.
Example: limit=100
prettyboolPretty-print (indented) JSON for human reading. Not needed in automation.
Example: pretty=true
targetRefstringGet 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)
Terminal curl command querying BlueCat MMv2 API with bearer token and host record filter parameters

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:
Terminal curl command calling BlueCat API to list mDNS nodes sorted by last modified date

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:
Curl command example calling BlueCat DNS zones API with bearer token and pagination parameters

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:
curl command snippet showing Authorization Bearer token header syntax on dark terminal background

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

Terminal curl command using bearer token to query BlueCat MMv3 dnsServers API endpoint

Solicitar salida en XML (en lugar de JSON)

cURL command example calling BlueCat DNS servers API with authorization bearer token and XML accept header

Listar los registros A que empiezan por «vm» en una zona

Example curl command calling BlueCat DNS records API with authorization header and URL filter parameters

Añadir un registro DNS

Curl command creating an A DNS record via BlueCat DNS records API with JSON payload

Filtrado avanzado por varios tipos

Curl command example querying BlueCat MMS DNS records API with authorization header and filter parameters

Crear registros DNS de forma masiva

Example curl command posting DNS A records to BlueCat dnsRecords API endpoint

Obtener el historial de eventos de una zona DNS

curl command calling BlueCat MMS API to retrieve dnsZones history with authorization bearer token

Crear una propiedad personalizada (definición de propiedad)

cURL POST request example creating a property definition with authorization header and JSON body

Obtener todos los ámbitos DHCP, ordenados por servidor DHCP

Curl command using bearer token to query DNS ranges API endpoint with fnthoServerRef parameter

Obtener todas las concesiones DHCP de un ámbito

curl command using bearer token to request leases from BlueCat API endpoint

Filtrar por una propiedad personalizada

Terminal snippet showing curl command with HTTP Authorization Bearer token header
Code snippet showing an MMSP API endpoint URL with datacenter-1 location filter

Combinación de parámetros de consulta

curl command example querying BlueCat MMS DNS zones API with authorization header and filtering parameters

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:
Code snippet defining BlueCat API base URL and session token variables in a dark themed editor

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)

JavaScript snippet in Postman scripts tab to parse response and save session bearer token variable

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

Code snippet using BlueCat REST API to obtain session token and list DNS zones

Añadir un registro DNS

PowerShell script creating a DNS A record and sending it via REST API with bearer token authorization

Crear registros DNS de forma masiva

PowerShell script snippet calling BlueCat DNS API to create A records with JSON body and authorization header

Ejemplo de gestión de errores

PowerShell script using Invoke-RestMethod with bearer token and try-catch for error handling

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

Python code snippet using BlueCat API to authenticate and retrieve DNS zones with bearer token

Añadir un registro DNS

Python code snippet creating a DNS A record via BlueCat API using JSON payload and printing the response

Crear registros DNS de forma masiva

Code snippet defining a bulk_records dictionary with a single A-type dnsRecords entry

Buscar registros sospechosos en zonas inversas

Python script snippet querying DNS zones and records via HTTP API with JSON responses

Ejemplo de gestión de errores

Python code snippet making an HTTPS GET request and printing an error message for non-200 responses
Python code snippet handling HTTP request exceptions and printing JSON response or error message

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.

📣  Now live: Explore BlueCat Horizon, our SaaS-first Intelligent NetOps platform.