> ## 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. # Listar conexões não atribuídas > Use este endpoint para listar as conexões que ainda não foram atribuídas a um produto. É útil principalmente durante uma migração: as conexões criadas antes de a atribuição por produto existir não têm produto, e este endpoint permite encontrá-las para que você possa associar cada uma a um produto usando o endpoint [Atribuir uma conexão a um produto](/pt/reference/reporter/connections/assign-connection). ## OpenAPI ````yaml pt/openapi/v3-current/connections.yaml get /v1/management/connections/unassigned openapi: 3.1.0 info: title: Conexões de Banco de Dados description: >- A API de conexões de banco de dados fornece endpoints para gerenciar as conexões de banco de dados usadas pelo Reporter. Ela permite criar, listar, atualizar, excluir e testar conexões de banco de dados, além de validar esquemas em relação às fontes de dados configuradas. version: 1.0.0 servers: - url: https://reporter.sandbox.lerian.net security: [] tags: - name: Database Connections description: >- Endpoints para gerenciar as conexões de banco de dados usadas pelo Reporter. paths: /v1/management/connections/unassigned: get: tags: - Database Connections summary: Listar conexões não atribuídas description: >- Use este endpoint para listar as conexões que ainda não foram atribuídas a um produto. É útil principalmente durante uma migração: as conexões criadas antes de a atribuição por produto existir não têm produto, e este endpoint permite encontrá-las para que você possa associar cada uma a um produto usando o endpoint [Atribuir uma conexão a um produto](/pt/reference/reporter/connections/assign-connection). parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/SortOrder' responses: '200': description: A lista de conexões que não têm nenhum produto atribuído. content: application/json: schema: $ref: '#/components/schemas/ConnectionListResponse' example: page: 1 limit: 50 total: 1 items: - id: 019996b8-f3d1-7d2b-a192-6e91464d82fc configName: legacy-transactional-db productName: '' 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:30:00Z' '400': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error0405: $ref: '#/components/examples/Error0405' Error0406: $ref: '#/components/examples/Error0406' Error0407: $ref: '#/components/examples/Error0407' '500': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error0002: $ref: '#/components/examples/Error0002' security: [] components: parameters: Authorization: name: Authorization in: header description: >- O token de autorização no formato `Bearer `. **Importante:** Este cabeçalho é obrigatório se o seu ambiente tiver o Access Manager habilitado. Para mais informações, consulte a documentação do [Access Manager](/pt/platform/access-manager/access-manager). required: false schema: type: string example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Page: name: page in: query description: O número da página a ser consultada (com índice iniciando em 1). required: false schema: type: integer minimum: 1 default: 1 example: 1 Limit: name: limit in: query description: >- Número máximo de itens retornados por página (máximo de 1000). O padrão é 10 quando omitido. required: false schema: type: integer minimum: 1 maximum: 1000 default: 10 example: 10 SortOrder: name: sortOrder in: query description: A ordem usada para ordenar os resultados. required: false schema: type: string enum: - asc - desc default: desc example: desc schemas: ConnectionListResponse: type: object description: Lista paginada de conexões. required: - items - page - limit - total properties: page: type: integer description: >- Número da página atual nos resultados paginados (com índice iniciando em 1). example: 1 limit: type: integer description: Número máximo de itens retornados por página. example: 50 total: type: integer description: Contagem total de itens disponíveis em todas as páginas. example: 3 items: type: array description: Array contendo as conexões da página atual. maxItems: 100 items: $ref: '#/components/schemas/ConnectionResponse' Error: type: object description: >- Mensagem de erro da resposta. Os códigos de erro usam o prefixo `FET` para identificar problemas relacionados à API de conexões de banco de dados. required: - code - title - message properties: code: type: string description: Um identificador único e estável para o erro (com o prefixo `FET`). example: FET-0001 title: type: string description: Um breve resumo do problema. example: Missing required fields message: type: string description: Orientação detalhada para resolver o erro. example: >- One or more required fields are missing. Please ensure all required fields like configName, host, port, userName, and password are included. ConnectionResponse: type: object description: Objeto de resposta contendo os detalhes da conexão. required: - id - configName - type - host - port - databaseName - userName - createdAt properties: id: type: string format: uuid description: Identificador único da conexão (formato UUID). example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 productName: type: string description: >- O nome de produto associado a esta conexão. Pode estar vazio se a conexão não tiver sido atribuída a um produto. example: my-product configName: type: string description: Nome identificador único desta configuração de conexão. example: production-db type: type: string description: >- Tipo de motor de banco de dados. Valores suportados: `ORACLE`, `SQL_SERVER`, `POSTGRESQL`, `MONGODB`, `MYSQL`. Observe que o campo `type` da fonte de dados no endpoint [Listar Fontes de Dados](/pt/reference/reporter/list-data-sources) retorna identificadores em minúsculas (`postgresql`, `mongodb`). enum: - ORACLE - SQL_SERVER - POSTGRESQL - MONGODB - MYSQL example: POSTGRESQL host: type: string description: Nome de host ou endereço IP do servidor de banco de dados. example: db.example.com port: type: integer description: Número da porta de rede para a conexão de banco de dados. example: 5432 databaseName: type: string description: Nome do banco de dados ao qual se conectar no servidor de destino. example: mydatabase userName: type: string description: Credencial de nome de usuário para autenticação no banco de dados. example: dbuser schema: type: string description: Nome do esquema do banco de dados, quando definido. example: public ssl: $ref: '#/components/schemas/SSLResponse' metadata: $ref: '#/components/schemas/Metadata' createdAt: type: string format: date-time description: Carimbo de data/hora ISO 8601 indicando quando a conexão foi criada. example: '2024-01-15T10:30:00Z' updatedAt: type: string format: date-time description: >- Carimbo de data/hora ISO 8601 indicando quando a conexão foi atualizada pela última vez. example: '2024-01-15T10:30:00Z' SSLResponse: type: object description: >- Configuração SSL retornada nas respostas de conexão. Apenas o `mode` SSL é exposto; o material de certificado (`ca`, `cert`, `key`) nunca é retornado. properties: mode: type: string description: Modo de conexão SSL configurado para esta conexão. enum: - disable - require - verify-ca - verify-full example: require Metadata: type: object additionalProperties: type: string maxLength: 2000 description: >- Um objeto contendo pares de chave-valor para armazenar informações adicionais relacionadas à conexão. As chaves (máx. 100 caracteres) e os valores (máx. 2000 caracteres) devem ser strings. Objetos aninhados não são permitidos. example: environment: production team: data-engineering examples: Error0405: summary: Invalid Query Parameter value: code: FET-0405 title: Invalid Query Parameter message: >- One or more query parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again. Error0406: summary: Pagination Limit Exceeded value: code: FET-0406 title: Pagination Limit Exceeded message: >- The pagination limit exceeds the maximum allowed of 1000 items per page. Please verify the limit and try again. Error0407: summary: Invalid Sort Order value: code: FET-0407 title: Invalid Sort Order message: >- The 'sortOrder' field must be 'asc' or 'desc'. Please provide a valid sort order and try again. 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. ````