[en] Server Connection Endpoints
[en] Server Connections Endpoints and Parameters
[en] To learn more about the objects relations and how to use them in the API, go to the Objects Relations section.
[en] For more information about data connections, visit the Data Connections help page.
[en] Retrieve All Data Connection Records
[en] To get information about all server data connection records, use the GET {baseURL}/v3/serverDataConnections endpoint.
[en] Parameters
[en] view (string): Optional. Can be left without a value. You can choose from the following values: ‘Default’ and ‘Full’. If this parameter is set to 'Default’, then a reduced view object will be returned. When not specified, the ‘Default’ value is used.
[en] Request Example: cURL
[en] curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections' \ --header 'Authorization: Bearer BearerTokenGoesHere'
[en] Retrieve a Specific Data Connection Record
[en] To retrieve information about a specific server data connection, use the GET {baseURL}/v3/serverDataConnections /{dataConnectionId} endpoint.
[en] Parameters
[en] dataConnectionId (string): Required. Enter a server data connection ID to get the information about a specific data connection.
[en] Request Example: cURL
[en] curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections/61dec3bc536c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
[en] Update an Existing Data Connection
[en] To change the name of a data connection, use the PUT {baseURL}/v3/serverDataConnections/{dataConnectionId} endpoint.
[en] Parameters
[en] dataConnectionId (string): Required. Enter a server data connection ID to specify the data connection you want to update.
[en] updateServerConnectionContract (body): Required. Enter new name for a data connection:
[en] name (string): Required. Enter the new name of the data connection.
[en] Request Example: cURL
[en] 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'
[en] Add a User to a Data Connection
[en] To add a user to a server data connection, use the POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/users endpoint.
[en] Parameters
[en] dataConnectionId (string): Required. Enter a server data connection ID to specify the data connection to add a user to.
[en] contract (body): Required. Enter an information about the user you want to add to a data connection:
[en] userId (string): Required. Specify the ID of a user you want to add to a data connection.
[en] Request Example: cURL
[en] 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'
[en] Add a User Group to a Data Connection
[en] To add a user group to a server data connection, use the POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups endpoint.
[en] Parameters
[en] dataConnectionId (string): Required. Enter a server data connection ID to specify the data connection to add a user group to.
[en] contract (body): Required. Enter an information about the user group you want to add to a data connection:
[en] userGroupId (string): Required. Specify the ID of a user group you want to add to a data connection.
[en] Request Example: cURL
[en] 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'
[en] Remove a User from a Data Connection
[en] To remove a user from a server data connection, use the DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/users/{userId} endpoint.
[en] Parameters
[en] dataConnectionId (string): Required. Enter a server data connection ID to specify the data connection you want to update.
[en] userId (string): Required. Enter a user ID you want to remove from the data connection.
[en] Request Example: cURL
[en] curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/users/61dec95f5436c22101353193' \ --header 'Authorization: Bearer BearerTokenGoesHere'
[en] Remove a User Group from a Data Connection
[en] To remove a user group from a server data connection, use the DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups/{userGroupId} endpoint.
[en] Parameters
[en] dataConnectionId (string): Required. Enter a server data connection ID to specify the data connection you want to update.
[en] userGroupId (string): Required. Enter a user group ID you want to remove from the data connection.
[en] Request Example: cURL
[en] curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/userGroups/61decb225436c2210135336f' \ --header 'Authorization: Bearer BearerTokenGoesHere'
[en] Delete a Data Connection
[en] To delete a specific server data connection, use the DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId} endpoint.
[en] Parameters
[en] dataConnectionId (string): Required. Enter a server data connection ID to specify the data connection you want to delete.
[en] Request Example: cURL
[en] curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
[en] Objects Relations
[en] There are no references for Server data connections for now. The benefit of having the data connections modifiable is you are able to assign or unassign access to them. This helps with onboarding to certain permissions to data sources.
[en] Postman Request Examples
[en] GET /v3/serverDataConnections
[en] PUT /v3/serverDataConnections/{dataConnectionId}
[en] To know more about Postman requests, visit the How to Use Postman help page.