Render

Render wird mit einem API-Schlüssel aus deinen Kontoeinstellungen verbunden. Dein Schlüssel wird vor dem Speichern verschlüsselt, und der Agent sieht ihn nie.

Einrichtung

1. Öffne das Render Dashboard und gehe zu Account Settings → API Keys.
2. Klicke auf Create API Key.
3. Kopiere den Schlüssel und füge ihn in Polylane ein.
4. Polylane prüft den Schlüssel und startet den Sync.

Polylane entdeckt deine Web Services, Private Services, Background Workers, Cron Jobs, Datenbanken und andere Render-Ressourcen.

Fehlerbehebung

Fehler "Invalid API key"

• Stelle sicher, dass du den vollständigen Schlüssel kopiert hast (er beginnt mit rnd_).
• Prüfe, ob der Schlüssel im Render-Dashboard widerrufen wurde.
• Vergewissere dich, dass du einen API-Schlüssel verwendest und keinen Deploy-Hook-Token.

Fehlende Ressourcen

• Render kann einige Minuten brauchen, bis alles synchronisiert ist.
• Starte über den Kontokopf einen manuellen Sync, um zu aktualisieren.

Verbindung trennen

Trenne das Konto in Polylane, dann widerrufe den API-Schlüssel in deinem Render-Dashboard.

Für die Verbindung mit Render braucht es keinen Browser: Derselbe Endpunkt, den die Konsole aufruft, passt in einen CI-Job. Ein authentifizierter POST erstellt die Verbindung und startet den ersten Sync.

Voraussetzungen

• Ein Polylane-API-Schlüssel mit den Scopes cloud_accounts:write und cloud_accounts:read. Siehe API-Schlüssel und OAuth.
• Deine Workspace-ID, die mit ws_ beginnt. Lies sie mit demselben Schlüssel aus GET /v1/workspaces.
• Ein Render-API-Schlüssel (beginnt mit rnd_) aus Account Settings → API Keys.

Verbindung erstellen

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_..."
  }'

Ein Aufruf verbindet jeden Render-Workspace, den der Schlüssel erreichen kann; übergib die optionale ownerId (usr-… oder tea-…), um nur einen zu verbinden.

Die Antwort listet auf, was verbunden wurde, der erste Sync läuft bereits. Gekürzt auf die zwei Felder, die der Rest des Ablaufs liest:

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

Ein bereits verbundenes Konto landet in failures statt in accounts, ein wiederholter Aufruf dupliziert also nie eine Verbindung.

Auf den ersten Sync warten

Frage jedes zurückgegebene Konto über seine id ab, bis status ready erreicht (new bei der Registrierung, syncing, während Ressourcen einlaufen):

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

Gib der Schleife eine Frist, damit ein fehlgeschlagenes Verbinden den Job fehlschlagen lässt, statt ihn hängen zu lassen. Sobald das Konto ready ist, sind seine Ressourcen in der Topologie, und Polylane hat seinen ersten Check gestartet.

Über die API trennen

Das Löschen der Verbindung stoppt jeden Sync und Check und löscht die Zugangsdaten, die Polylane gespeichert hatte. Der Aufruf braucht den 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"

Widerrufe dann die Render-Zugangsdaten auf Anbieterseite, wie unten unter Trennen beschrieben.