> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Crear una conexión > Crea una conexión de base de datos para el producto indicado en el encabezado X-Product-Name. ## OpenAPI ````yaml es/openapi/v3-current/connections.yaml post /v1/management/connections openapi: 3.1.0 info: contact: email: contact@lerian.studio name: Lerian url: https://github.com/LerianStudio/fetcher/discussions description: Documentación de la API del componente Fetcher Manager license: identifier: Elastic-2.0 name: Elastic License 2.0 (Source Available) title: API de Fetcher Manager version: 1.0.0 servers: [] security: - BearerAuth: [] tags: - description: >- Operaciones del ciclo de vida y del esquema de las conexiones de base de datos. name: Connections - description: Operaciones heredadas de asignación de conexiones y migración. name: Migration - description: Operaciones de creación y estado de jobs de extracción de datos. name: Fetcher paths: /v1/management/connections: post: tags: - Connections summary: Crear una conexión description: >- Crea una conexión de base de datos para el producto indicado en el encabezado X-Product-Name. operationId: create-connection parameters: - description: Nombre del producto que se usa para aislar las conexiones. in: header name: X-Product-Name required: true schema: examples: - midaz type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ConnectionInput' description: Configuración y credenciales de la conexión. required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/ConnectionResponse' description: Creado '400': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Solicitud incorrecta '401': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: No autorizado '403': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Prohibido '409': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Conflicto '422': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Entidad no procesable '500': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error interno del servidor components: schemas: ConnectionInput: additionalProperties: false properties: configName: description: >- Nombre único de configuración que se usa para hacer referencia a esta conexión. examples: - production-db type: string databaseName: description: Nombre de la base de datos a la que se establece la conexión. examples: - mydatabase type: string host: description: Nombre de host o dirección IP del servidor de base de datos. examples: - db.example.com type: string metadata: additionalProperties: {} description: Metadatos opcionales de la conexión definidos por la aplicación. examples: - environment: production region: us-east-1 type: object password: description: Contraseña de autenticación de la base de datos. examples: - secretpassword type: string port: description: Puerto TCP del servidor de base de datos. examples: - 5432 format: int64 type: integer schema: description: Esquema predeterminado opcional de la base de datos. examples: - public type: string ssl: $ref: '#/components/schemas/SSLInput' description: Configuración SSL/TLS opcional de la conexión. examples: - ca: certificate-authority mode: require type: description: Tipo de motor de base de datos. examples: - POSTGRESQL type: string userName: description: Nombre de usuario para la autenticación en la base de datos. examples: - dbuser type: string required: - configName - type - host - port - databaseName - userName - password type: object ConnectionResponse: additionalProperties: false properties: configName: description: >- Nombre de configuración que se usa para hacer referencia a la conexión. examples: - production-db type: string createdAt: description: Fecha y hora de creación de la conexión. examples: - '2026-01-15T10:30:00Z' format: date-time type: string databaseName: description: Nombre de la base de datos conectada. examples: - mydatabase type: string host: description: Nombre de host o dirección IP del servidor de base de datos. examples: - db.example.com type: string id: description: Identificador único de la conexión. examples: - 018f47a6-3e5f-7b9a-8c1d-2e3f4a5b6c7d type: string metadata: additionalProperties: {} description: Metadatos de la conexión definidos por la aplicación. examples: - environment: production region: us-east-1 type: object port: description: Puerto TCP del servidor de base de datos. examples: - 5432 format: int64 type: integer productName: description: Producto propietario de la conexión. examples: - midaz type: string schema: description: Esquema predeterminado de la base de datos, si está configurado. examples: - public type: string ssl: $ref: '#/components/schemas/SSLResponse' description: Configuración SSL/TLS establecida, sin incluir los secretos. examples: - mode: require type: description: Tipo de motor de base de datos. examples: - POSTGRESQL type: string updatedAt: description: Fecha y hora de la última actualización de la conexión. examples: - '2026-01-16T14:45:00Z' format: date-time type: string userName: description: Nombre de usuario para la autenticación en la base de datos. examples: - dbuser type: string required: - id - configName - type - host - port - databaseName - userName - createdAt - updatedAt type: object Detail: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina, limitado al servicio emisor (formato -NNNN). examples: - ERR-0001 type: string detail: description: >- Explicación legible para humanos específica de esta instancia del problema. examples: - La propiedad foo es obligatoria, pero no está presente. type: string errors: description: Lista opcional de detalles individuales de los errores items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: Referencia URI que identifica la instancia específica del problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de estado HTTP examples: - 400 format: int64 type: integer title: description: >- Resumen breve y legible para humanos del tipo de problema. Este valor no debe cambiar entre distintas instancias del error. examples: - Solicitud incorrecta type: string type: default: about:blank description: Referencia URI a documentación legible para humanos sobre el error. examples: - https://example.com/errors/example format: uri type: string type: object SSLInput: additionalProperties: false properties: ca: description: >- Autoridad certificadora codificada en PEM que se usa para verificar el servidor. examples: - |- -----BEGIN CERTIFICATE----- ... type: string cert: description: Certificado de cliente opcional codificado en PEM. examples: - |- -----BEGIN CERTIFICATE----- ... type: string key: description: >- Clave privada opcional codificada en PEM para el certificado de cliente. examples: - |- -----BEGIN PRIVATE KEY----- ... type: string mode: description: Modo SSL/TLS específico del controlador. examples: - require type: string required: - mode - ca type: object SSLResponse: additionalProperties: false properties: mode: description: Modo SSL/TLS configurado y específico del controlador. examples: - require type: string type: object ErrorDetail: additionalProperties: false properties: location: description: >- Ubicación donde se produjo el error, por ejemplo, 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: Valor en la ubicación indicada type: object securitySchemes: BearerAuth: bearerFormat: JWT description: Token JWT de tipo bearer emitido por el proveedor de identidad. scheme: bearer type: http ````