Skip to main content

Server-Verbindungsendpunkte

Server-Verbindungsendpunkte und Parameter

Weitere Informationen zu Objektbeziehungen und deren Verwendung in der API finden Sie im Abschnitt Objektbeziehungen .

Weitere Informationen zu Datenverbindungen finden Sie auf der Hilfeseite Datenverbindungen .

Alle Datenverbindungsdatensätze abrufen

Um Informationen zu allen Server-Datenverbindungsdatensätzen abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/serverDataConnections .

Parameter

  • view (Zeichenfolge): optional. Kann ohne Wert belassen werden. Sie können aus den folgenden Werten wählen: „Default“ und „Full“. Wenn dieser Parameter auf „Standard“ gesetzt ist, wird ein reduziertes Ansichtsobjekt zurückgegeben. Wenn keine Angaben gemacht werden, wird der Standardwert verwendet.

Anforderungsbeispiel: cURL

curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Bestimmten Datenverbindungsdatensatz abrufen

Um Informationen über eine bestimmte Server-Datenverbindung abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/serverDataConnections/{dataConnectionId} .

Parameter

  • dataConnectionId (Zeichenfolge): erforderlich. Geben Sie eine Server-Datenverbindungs-ID ein, um Informationen über eine bestimmte Datenverbindung abzurufen.

Anforderungsbeispiel: cURL

curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections/61dec3bc536c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Vorhandene Datenverbindung aktualisieren

Um den Namen einer Datenverbindung zu ändern, verwenden Sie den Endpunkt PUT {baseURL}/v3/serverDataConnections/{dataConnectionId} .

Parameter

  • dataConnectionId (Zeichenfolge): erforderlich. Geben Sie eine Server-Datenverbindungs-ID ein, um die Datenverbindung anzugeben, die aktualisiert werden soll.

  • updateServerConnectionContract (Text): erforderlich. Geben Sie den neuen Namen für eine Datenverbindung ein:

    • name (Zeichenfolge): erforderlich. Geben Sie den neuen Namen der Datenverbindung ein.

Anforderungsbeispiel: cURL

curl --location --request PUT 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c21013530fa' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'name=Oracle DB Connection'

Benutzer einer Datenverbindung hinzufügen

Um einen Benutzer zu einer Server-Datenverbindung hinzuzufügen, verwenden Sie den Endpunkt POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/users .

Parameter

  • dataConnectionId (Zeichenfolge): erforderlich. Geben Sie eine Server-Datenverbindungs-ID ein, um die Datenverbindung anzugeben, zu der ein Benutzer hinzugefügt werden soll.

  • contract (Text): erforderlich. Geben Sie Informationen über den Benutzer ein, den Sie einer Datenverbindung hinzufügen möchten:

    • userId (Zeichenfolge): erforderlich. Geben Sie die ID eines Benutzers an, den Sie einer Datenverbindung hinzufügen möchten.

Anforderungsbeispiel: cURL

curl --location --request POST 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/users' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'userId=61dec95f5436c22101353193'

Benutzergruppe zu einer Datenverbindung hinzufügen

Um eine Benutzergruppe zu einer Server-Datenverbindung hinzuzufügen, verwenden Sie den Endpunkt POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups .

Parameter

  • dataConnectionId (Zeichenfolge): erforderlich. Geben Sie eine Server-Datenverbindungs-ID ein, um die Datenverbindung anzugeben, zu der eine Benutzergruppe hinzugefügt werden soll.

  • contract (Text): erforderlich. Geben Sie Informationen zu der Benutzergruppe ein, die Sie einer Datenverbindung hinzufügen möchten:

    • userGroupId (Zeichenfolge): erforderlich. Geben Sie die ID einer Benutzergruppe an, die Sie einer Datenverbindung hinzufügen möchten.

Anforderungsbeispiel: cURL

curl --location --request POST 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/userGroups' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'userGroupId=61decb225436c2210135336f'

Benutzer aus einer Datenverbindung entfernen

Um einen Benutzer aus einer Server-Datenverbindung zu entfernen, verwenden Sie den Endpunkt DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/users/{userId} .

Parameter

  • dataConnectionId (Zeichenfolge): erforderlich. Geben Sie eine Server-Datenverbindungs-ID ein, um die Datenverbindung anzugeben, die aktualisiert werden soll.

  • userId (Zeichenfolge): erforderlich. Geben Sie eine Benutzer-ID ein, die Sie aus der Datenverbindung entfernen möchten.

Anforderungsbeispiel: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/users/61dec95f5436c22101353193' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Benutzergruppe aus einer Datenverbindung entfernen

Um eine Benutzergruppe aus einer Server-Datenverbindung zu entfernen, verwenden Sie den Endpunkt DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups/{userGroupId} .

Parameter

  • dataConnectionId (Zeichenfolge): erforderlich. Geben Sie eine Server-Datenverbindungs-ID ein, um die Datenverbindung anzugeben, die aktualisiert werden soll.

  • userGroupId (Zeichenfolge): erforderlich. Geben Sie eine Benutzergruppen-ID ein, die Sie aus der Datenverbindung entfernen möchten.

Anforderungsbeispiel: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/userGroups/61decb225436c2210135336f' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Datenverbindung löschen

Um eine bestimmte Server-Datenverbindung zu löschen, verwenden Sie den Endpunkt DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId} .

Parameter

  • dataConnectionId (Zeichenfolge): erforderlich. Geben Sie eine Server-Datenverbindungs-ID ein, um die Datenverbindung anzugeben, die Sie löschen möchten.

Anforderungsbeispiel: cURL

curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Objektbeziehungen

Derzeit sind keine Referenzen für Server-Datenverbindungen vorhanden. Wenn Datenverbindungen geändert werden können, bietet das den Vorteil, dass Sie den Zugriff auf diese Verbindungen zuweisen oder entziehen können. Dies hilft beim Gewähren bestimmter Berechtigungen für Datenquellen.

Beispiele für eine Postman-Anforderung

GET /v3/serverDataConnections

Use the GET /v3/serverDataConnections endpoint.

PUT /v3/serverDataConnections/{dataConnectionId}

Use the PUT /v3/serverDataConnections/{dataConnectionId} endpoint.

Weitere Informationen zu Postman-Anforderungen finden Sie auf der Hilfeseite So verwenden Sie Postman.