# API-Endpunkte der IP-Allowlist

Verfügbar in...

* Cloud API Services Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Cloud Data Integration
* Cloud Data Management Platform
* Cloud Pipeline Designer Standard Edition
* Data Fabric

Für den Zugriff auf diese API wird folgender Host verwendet: https://api.&lt;env&gt;.cloud.talend.com.

Die vollständige API-Dokumentation für diese API finden Sie unter https://api.&lt;env&gt;.cloud.talend.com/v1/management/swagger-ui/?urls.primaryName=IP%20Allowlist%20Management.

Der Teil &lt;env&gt; entspricht dem Namen Ihrer Cloud-Region. Wenn Sie den Namen Ihrer Region nicht kennen, siehe [Zugriff auf Talend Cloud-Anwendungen](https://help.qlik.com/talend/en-US/installation-guide-windows/Cloud/talend-cloud-application-url?tr=de-DE).

Für den Aufruf der API müssen Sie Ihr Zugriffstoken verwenden. Weitere Informationen zur Generierung von Zugriffstoken und deren Verwendung finden Sie unter „[Generieren persönlicher Zugriffstoken](https://help.qlik.com/talend/r/de-DE/Cloud/management-console-user-guide/cloud-access-token)“.

Die folgende Tabelle zeigt die API-Endpunkte der IP-Allowlist und deren erforderliche Berechtigungen

| Operations (Operationen) | Methoden | Ressourcen | Erforderliche Berechtigungen |
| --- | --- | --- | --- |
| Abrufen der Konfiguration Ihrer Richtlinien für die IP-Allowlist, wie z. B. die IP-Adressen in der Liste, ungeachtet dessen, ob die Richtlinien aktiviert wurden oder nicht. | GET | /v1/management/ip-allowlist | Users - Management (Benutzer - Verwaltung) |
| Einrichten der gesamten Konfiguration Ihrer Richtlinien für die IP-Allowlist. Mit diesem Request wird eine IP-Allowlist erstellt, ob Sie nun IP-Adressen hinzufügen oder nicht, und es wird festgelegt, ob die IP-Allowlist-Richtlinien gleichzeitig aktiviert werden sollen.<br><br>Beachten Sie Folgendes: Sobald Ihre IP-Allowlist-Richtlinien aktiviert sind, sind nur die IP-Adressen in der Allowlist berechtigt, auf Talend Cloud zuzugreifen. | POST | /v1/management/ip-allowlist | Users - Management (Benutzer - Management) |
| Aktualisieren der Konfiguration Ihrer Richtlinien für die IP-Allowlist. Mit diesem Request werden IP-Adressen zur bestehenden IP-Allowlist hinzugefügt und die IP-Allowlist-Richtlinien werden gleichzeitig aktiviert oder deaktiviert.<br><br>Beachten Sie Folgendes: Sobald Ihre IP-Allowlist-Richtlinien aktiviert sind, sind nur die IP-Adressen in der Allowlist berechtigt, auf Talend Cloud zuzugreifen. | PUT | /v1/management/ip-allowlist | Users - Management (Benutzer - Management) |
| Löschen der Richtlinien für die IP-Allowlist. | DELETE | /v1/management/ip-allowlist | Users - Management (Benutzer - Management) |
| Aktivieren oder Deaktivieren der Richtlinien für die IP-Allowlist. | PATCH | /v1/management/ip-allowlist | Users - Management (Benutzer - Management) |
| Abrufen aller IP-Adressen aus der IP-Allowlist. | GET | /v1/management/ip-allowlist/ips | Users - Management (Benutzer - Management) |
| Hinzufügen neuer IP-Adressen zur IP-Allowlist. | POST | /v1/management/ip-allowlist/ips | Users - Management (Benutzer - Management) |
| Aktualisieren einer Gruppe von IP-Adressen in der IP-Allowlist. Sie müssen im Request die IDs der zu aktualisierenden IP-Adressen angeben. | PUT | /v1/management/ip-allowlist/ips | Users - Management (Benutzer - Management) |
| Abrufen einer spezifischen IP-Adresse nach deren ID aus der IP-Allowlist. | GET | /v1/management/ip-allowlist/ips/&lt;ip\_entry\_id&gt; | Users - Management (Benutzer - Management) |
| Auffinden einer IP-Adresse in der IP-Allowlist nach deren ID und Aktualisieren dieser IP mit der neuen, im Request angegebenen Adresse. | PUT | /v1/management/ip-allowlist/ips/&lt;ip\_entry\_id&gt; | Users - Management (Benutzer - Management) |
| Löschen einer bestimmten ID-Adresse in der IP-Allowlist. | DELETE | /v1/management/ip-allowlist/ips/&lt;ip\_entry\_id&gt; | Users - Management (Benutzer - Verwaltung) |