Render

Render se conecta con una clave de API de la configuración de tu cuenta. Tu clave se cifra antes de almacenarse, y el agente nunca la ve.

Configuración

1. Abre el Render Dashboard y ve a Account Settings → API Keys.
2. Haz clic en Create API Key.
3. Copia la clave y pégala en Polylane.
4. Polylane valida la clave y empieza a sincronizar.

Polylane descubre tus servicios web, servicios privados, workers en segundo plano, cron jobs, bases de datos y otros recursos de Render.

Solución de problemas

Error "Invalid API key"

• Asegúrate de haber copiado la clave completa (empieza por rnd_).
• Comprueba que la clave no se haya revocado en el panel de Render.
• Verifica que estás usando una clave de API, no un token de deploy hook.

Faltan recursos

• Render puede tardar unos minutos en sincronizar todo.
• Lanza un Sync manual desde la cabecera de la cuenta para actualizar.

Desconexión

Desconecta la cuenta en Polylane y luego revoca la clave de API desde tu panel de Render.

Conectar Render no necesita navegador: el mismo endpoint al que llama la consola cabe en un trabajo de CI. Un único POST autenticado crea la conexión e inicia la primera sincronización.

Requisitos previos

• Una clave de API de Polylane con los scopes cloud_accounts:write y cloud_accounts:read. Consulta Claves de API y OAuth.
• El ID de tu espacio de trabajo, que empieza por ws_. Léelo desde GET /v1/workspaces con la misma clave.
• Una clave de API de Render (empieza por rnd_) de Account Settings → API Keys.

Crear la conexión

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "render",
    "workspaceId": "ws_0abc123",
    "apiKey": "rnd_..."
  }'

Una sola llamada conecta todos los espacios de trabajo de Render que la clave puede alcanzar; pasa el ownerId opcional (usr-… o tea-…) para conectar solo uno.

La respuesta lista lo que se conectó, con la primera sincronización ya en marcha. Recortada a los dos campos que lee el resto del flujo:

{
  "success": true,
  "result": {
    "provider": "render",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Una cuenta que ya está conectada acaba en failures en lugar de en accounts, así que repetir la llamada nunca duplica una conexión.

Esperar a la primera sincronización

Consulta cada cuenta devuelta por su id hasta que status llegue a ready (new al registrarse, syncing mientras los recursos van llegando):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Dale al bucle un plazo límite para que una conexión fallida haga fallar el trabajo en lugar de dejarlo colgado. Cuando la cuenta está ready, sus recursos están en la topología y Polylane ha iniciado su primera comprobación.

Desconectar desde la API

Eliminar la conexión detiene todas las sincronizaciones y comprobaciones y elimina las credenciales que Polylane guardaba. La llamada necesita el scope cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Después revoca la credencial de Render del lado del proveedor, como se describe más abajo en Desconectar.