> ## 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. # Asignar una conexión a un producto > Usa este endpoint para asignar a un producto una conexión que aún no lo tiene. Indica el producto de destino mediante el encabezado `X-Product-Name`. Es una operación única e irreversible: una vez que una conexión se asigna a un producto, no se puede reasignar. Usa el endpoint [Listar conexiones sin asignar](/es/reference/reporter/connections/list-unassigned-connections) para encontrar las conexiones que todavía necesitan un producto. ## OpenAPI ````yaml es/openapi/v3-current/connections.yaml post /v1/management/connections/{id}/assign openapi: 3.1.0 info: title: Conexiones de Base de Datos description: >- La API de conexiones de base de datos proporciona endpoints para gestionar las conexiones de base de datos utilizadas por Reporter. Le permite crear, listar, actualizar, eliminar y probar conexiones de base de datos, así como validar esquemas frente a las fuentes de datos configuradas. version: 1.0.0 servers: - url: https://reporter.sandbox.lerian.net security: [] tags: - name: Database Connections description: >- Endpoints para gestionar las conexiones de base de datos utilizadas por Reporter. paths: /v1/management/connections/{id}/assign: post: tags: - Database Connections summary: Asignar una conexión a un producto description: >- Usa este endpoint para asignar a un producto una conexión que aún no lo tiene. Indica el producto de destino mediante el encabezado `X-Product-Name`. Es una operación única e irreversible: una vez que una conexión se asigna a un producto, no se puede reasignar. Usa el endpoint [Listar conexiones sin asignar](/es/reference/reporter/connections/list-unassigned-connections) para encontrar las conexiones que todavía necesitan un producto. parameters: - $ref: '#/components/parameters/ConnectionId' - $ref: '#/components/parameters/Authorization' - name: X-Product-Name in: header description: >- El nombre de producto que se asignará a esta conexión. Debe contener únicamente caracteres alfanuméricos, guiones bajos y guiones (máximo 100 caracteres). El valor se normaliza a minúsculas. required: true schema: type: string maxLength: 100 pattern: ^[a-zA-Z0-9_-]+$ example: my-product responses: '200': description: La conexión después de haber sido asignada al producto. content: application/json: schema: $ref: '#/components/schemas/ConnectionResponse' example: id: 019996b8-f3d1-7d2b-a192-6e91464d82fc configName: legacy-transactional-db productName: my-product type: POSTGRESQL host: postgres.cliente.com.br port: 5432 databaseName: transaction userName: user_legacy_read schema: public ssl: mode: require metadata: {} createdAt: '2025-09-25T10:30:00Z' updatedAt: '2025-09-25T10:35:00Z' '400': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error0402: $ref: '#/components/examples/Error0402' Error0404: $ref: '#/components/examples/Error0404' '404': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error1001: $ref: '#/components/examples/Error1001' '409': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error1015: $ref: '#/components/examples/Error1015' '500': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error0002: $ref: '#/components/examples/Error0002' security: [] components: parameters: ConnectionId: name: id in: path description: Identificador único de la conexión (formato UUID). required: true schema: type: string format: uuid example: 019996b8-f3d1-7d2b-a192-6e91464d82fc Authorization: name: Authorization in: header description: >- El token de autorización en el formato `Bearer `. **Importante:** Este encabezado es obligatorio si su entorno tiene Access Manager habilitado. Para más información, consulte la documentación de [Access Manager](/es/platform/access-manager/access-manager). required: false schema: type: string example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... schemas: ConnectionResponse: type: object description: Objeto de respuesta que contiene los detalles de la conexión. required: - id - configName - type - host - port - databaseName - userName - createdAt properties: id: type: string format: uuid description: Identificador único de la conexión (formato UUID). example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 productName: type: string description: >- El nombre de producto asociado a esta conexión. Puede estar vacío si la conexión no se ha asignado a ningún producto. example: my-product configName: type: string description: Nombre identificador único de esta configuración de conexión. example: production-db type: type: string description: >- Tipo de motor de base de datos. Valores admitidos: `ORACLE`, `SQL_SERVER`, `POSTGRESQL`, `MONGODB`, `MYSQL`. Tenga en cuenta que el campo `type` de la fuente de datos en el endpoint [Listar Fuentes de Datos](/es/reference/reporter/list-data-sources) devuelve identificadores en minúsculas (`postgresql`, `mongodb`). enum: - ORACLE - SQL_SERVER - POSTGRESQL - MONGODB - MYSQL example: POSTGRESQL host: type: string description: Nombre de host o dirección IP del servidor de base de datos. example: db.example.com port: type: integer description: Número de puerto de red para la conexión de base de datos. example: 5432 databaseName: type: string description: >- Nombre de la base de datos a la que conectarse en el servidor de destino. example: mydatabase userName: type: string description: >- Credencial de nombre de usuario para la autenticación de la base de datos. example: dbuser schema: type: string description: Nombre del esquema de base de datos, cuando está definido. example: public ssl: $ref: '#/components/schemas/SSLResponse' metadata: $ref: '#/components/schemas/Metadata' createdAt: type: string format: date-time description: Marca de tiempo ISO 8601 que indica cuándo se creó la conexión. example: '2024-01-15T10:30:00Z' updatedAt: type: string format: date-time description: >- Marca de tiempo ISO 8601 que indica cuándo se actualizó la conexión por última vez. example: '2024-01-15T10:30:00Z' Error: type: object description: >- Mensaje de error de la respuesta. Los códigos de error utilizan el prefijo `FET` para identificar problemas relacionados con la API de conexiones de base de datos. required: - code - title - message properties: code: type: string description: >- Un identificador único y estable para el error (con el prefijo `FET`). example: FET-0001 title: type: string description: Un breve resumen del problema. example: Missing required fields message: type: string description: Orientación detallada para resolver el error. example: >- One or more required fields are missing. Please ensure all required fields like configName, host, port, userName, and password are included. SSLResponse: type: object description: >- Configuración SSL devuelta en las respuestas de conexión. Solo se expone el `mode` de SSL; el material del certificado (`ca`, `cert`, `key`) nunca se devuelve. properties: mode: type: string description: Modo de conexión SSL configurado para esta conexión. enum: - disable - require - verify-ca - verify-full example: require Metadata: type: object additionalProperties: type: string maxLength: 2000 description: >- Un objeto que contiene pares clave-valor para almacenar información adicional relacionada con la conexión. Las claves (máximo 100 caracteres) y los valores (máximo 2000 caracteres) deben ser cadenas de texto. No se permiten objetos anidados. example: environment: production team: data-engineering examples: Error0402: summary: Missing Fields in Request value: code: FET-0402 title: Missing Fields in Request message: >- Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request. Error0404: summary: Invalid Path Parameter value: code: FET-0404 title: Invalid Path Parameter message: >- Path parameters is in an incorrect format. Please check the following parameter 'id' and ensure they meet the required format before trying again. Error1001: summary: Entity Not Found value: code: FET-1001 title: Entity Not Found message: >- It was not possible to find the connection entity during the requested flow. Please review the data provided in the request. Error1015: summary: Connection Already Assigned value: code: FET-1015 title: Connection Already Assigned message: >- The connection is already assigned to a product and cannot be reassigned. Error0002: summary: Internal Server Error value: code: FET-0002 title: Internal Server Error message: >- The server encountered an unexpected error. Please try again later or contact support. ````