Endpoint delle connessioni Server
Endpoint e parametri delle connessioni Server
Per ulteriori informazioni sulle relazioni tra oggetti e su come utilizzarle nell'API, consulta la sezione Relazioni tra oggetti .
Per ulteriori informazioni sulle connessioni dati, consulta la pagina di assistenza Connessioni dati .
Recupero dei record di tutte le connessioni dati
Per ottenere informazioni sui record di tutte le connessioni dati di Server, utilizza l'endpoint
GET {baseURL}/v3/serverDataConnections
.
Parametri
view (stringa): opzionale. È possibile non specificare alcun valore o selezionare "Default" e "Full". Se il parametro è impostato su "Default", viene restituito un oggetto vista ridotto. Se non è specificato alcun valore, viene utilizzato "Default".
Esempio di richiesta: cURL
curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Recupero del record di una connessione dati specifica
Per recuperare informazioni su una connessione dati di Server specifica, utilizza l'endpoint
GET {baseURL}/v3/serverDataConnections /{dataConnectionId}
.
Parametri
dataConnectionId (stringa): obbligatorio. Immetti l'ID di una connessione dati di Server per ottenere le informazioni sulla stessa.
Esempio di richiesta: cURL
curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections/61dec3bc536c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Aggiornamento di una connessione dati esistente
Per modificare il parametro
name
di una connessione dati, utilizza l'endpoint
PUT {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
Parametri
dataConnectionId (stringa): obbligatorio. Immetti l'ID della connessione dati di Server che desideri aggiornare.
updateServerConnectionContract (corpo): obbligatorio. Immetti un nuovo nome per una connessione dati:
name (stringa): obbligatorio. Immetti il nuovo nome della connessione dati.
Esempio di richiesta: 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'
Aggiunta di un utente a una connessione dati
Per aggiungere un utente a una connessione dati di Server, utilizza l'endpoint
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/users
.
Parametri
dataConnectionId (stringa): obbligatorio. Immetti l'ID della connessione dati di Server a cui aggiungere un utente.
contract (corpo): obbligatorio. Immetti le informazioni sull'utente che desideri aggiungere a una connessione dati:
userId (stringa): obbligatorio. Specifica l'ID di un utente che desideri aggiungere a una connessione dati.
Esempio di richiesta: 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'
Aggiunta di un gruppo di utenti a una connessione dati
Per aggiungere un gruppo di utenti a una connessione dati di Server, utilizza l'endpoint
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups
.
Parametri
dataConnectionId (stringa): obbligatorio. Immetti l'ID della connessione dati di Server a cui aggiungere un gruppo di utenti.
contract (corpo): obbligatorio. Immetti le informazioni sul gruppo di utenti che desideri aggiungere a una connessione dati:
userGroupId (stringa): obbligatorio. Specifica l'ID di un gruppo di utenti che desideri aggiungere a una connessione dati.
Esempio di richiesta: 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'
Rimozione di un utente da una connessione dati
Per rimuovere un utente da una connessione dati di Server, utilizza l'endpoint
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/users/{userId}
.
Parametri
dataConnectionId (stringa): obbligatorio. Immetti l'ID della connessione dati di Server che desideri aggiornare.
userId (stringa): obbligatorio. Immetti l'ID di un utente che desideri rimuovere dalla connessione dati.
Esempio di richiesta: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/users/61dec95f5436c22101353193' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Rimozione di un gruppo di utenti da una connessione dati
Per rimuovere un gruppo di utenti da una connessione dati di Server, utilizza l'endpoint
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups/{userGroupId}
.
Parametri
dataConnectionId (stringa): obbligatorio. Immetti l'ID della connessione dati di Server che desideri aggiornare.
userGroupId (stringa): obbligatorio. Immetti l'ID di un gruppo di utenti che desideri rimuovere dalla connessione dati.
Esempio di richiesta: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/userGroups/61decb225436c2210135336f' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Eliminazione di una connessione dati
Per eliminare una connessione dati di Server specifica, utilizza l'endpoint
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
Parametri
dataConnectionId (stringa): obbligatorio. Immetti l'ID della connessione dati di Server che desideri eliminare.
Esempio di richiesta: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Relazioni tra oggetti
Per il momento non sono presenti riferimenti per le connessioni dati di Server. Il vantaggio di poter modificare le connessioni dati consiste nella possibilità di concedere o impedire l'accesso alle stesse. Ciò agevola l'onboarding di determinate autorizzazioni per le origini dati.
Esempi di richiesta Postman
GET /v3/serverDataConnections
PUT /v3/serverDataConnections/{dataConnectionId}
Per ulteriori informazioni sulle richieste Postman, consulta la pagina di assistenza Come usare Postman.