Saltar al contenido principal
POST
/
v1
/
management
/
connections
/
{id}
/
assign
Asignar una conexión a un producto
curl --request POST \
  --url https://reporter.sandbox.lerian.net/v1/management/connections/{id}/assign \
  --header 'X-Product-Name: <x-product-name>'
import requests

url = "https://reporter.sandbox.lerian.net/v1/management/connections/{id}/assign"

headers = {"X-Product-Name": "<x-product-name>"}

response = requests.post(url, headers=headers)

print(response.text)
const options = {method: 'POST', headers: {'X-Product-Name': '<x-product-name>'}};

fetch('https://reporter.sandbox.lerian.net/v1/management/connections/{id}/assign', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://reporter.sandbox.lerian.net/v1/management/connections/{id}/assign",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-Product-Name: <x-product-name>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://reporter.sandbox.lerian.net/v1/management/connections/{id}/assign"

req, _ := http.NewRequest("POST", url, nil)

req.Header.Add("X-Product-Name", "<x-product-name>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://reporter.sandbox.lerian.net/v1/management/connections/{id}/assign")
.header("X-Product-Name", "<x-product-name>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://reporter.sandbox.lerian.net/v1/management/connections/{id}/assign")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Product-Name"] = '<x-product-name>'

response = http.request(request)
puts response.read_body
{
  "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"
}

Encabezados

Authorization
string

El token de autorización en el formato Bearer <token>.

Importante: Este encabezado es obligatorio si su entorno tiene Access Manager habilitado. Para más información, consulte la documentación de Access Manager.

Ejemplo:

"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

X-Product-Name
string
requerido

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.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9_-]+$
Ejemplo:

"my-product"

Parámetros de ruta

id
string<uuid>
requerido

Identificador único de la conexión (formato UUID).

Ejemplo:

"019996b8-f3d1-7d2b-a192-6e91464d82fc"

Respuesta

La conexión después de haber sido asignada al producto.

Objeto de respuesta que contiene los detalles de la conexión.

id
string<uuid>
requerido

Identificador único de la conexión (formato UUID).

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

configName
string
requerido

Nombre identificador único de esta configuración de conexión.

Ejemplo:

"production-db"

type
enum<string>
requerido

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 devuelve identificadores en minúsculas (postgresql, mongodb).

Opciones disponibles:
ORACLE,
SQL_SERVER,
POSTGRESQL,
MONGODB,
MYSQL
Ejemplo:

"POSTGRESQL"

host
string
requerido

Nombre de host o dirección IP del servidor de base de datos.

Ejemplo:

"db.example.com"

port
integer
requerido

Número de puerto de red para la conexión de base de datos.

Ejemplo:

5432

databaseName
string
requerido

Nombre de la base de datos a la que conectarse en el servidor de destino.

Ejemplo:

"mydatabase"

userName
string
requerido

Credencial de nombre de usuario para la autenticación de la base de datos.

Ejemplo:

"dbuser"

createdAt
string<date-time>
requerido

Marca de tiempo ISO 8601 que indica cuándo se creó la conexión.

Ejemplo:

"2024-01-15T10:30:00Z"

productName
string

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.

Ejemplo:

"my-product"

schema
string

Nombre del esquema de base de datos, cuando está definido.

Ejemplo:

"public"

ssl
object

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.

metadata
object

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.

Ejemplo:
{
"environment": "production",
"team": "data-engineering"
}
updatedAt
string<date-time>

Marca de tiempo ISO 8601 que indica cuándo se actualizó la conexión por última vez.

Ejemplo:

"2024-01-15T10:30:00Z"