Points de terminaison de la connexion à Server
Points de terminaison et paramètres de connexions à Server
Récupérer un enregistrement de connexion aux données spécifique
Partager une connexion aux données Server avec un utilisateur
Partager une connexion aux données Server avec un groupe d'utilisateurs
Retirer les autorisations d'un utilisateur d'exploiter une connexion aux données Server
Retirer les autorisations d'un groupe d'utilisateurs d'exploiter une connexion aux données Server
Pour en savoir plus sur les relations d'objets et sur leur utilisation dans l'API, consultez la section Relations d'objets .
Pour plus d'informations sur les connexions aux données, consultez la page d'aide Connexion aux données .
Récupérer tous les enregistrements de connexion aux données
Pour récupérer tous les enregistrements accessibles d'une connexion aux données Server, utilisez le point de terminaison
GET {baseURL}/v3/serverDataConnections
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
view (chaîne) : facultatif. Peut être laissé sans valeur. Vous pouvez choisir parmi les valeurs suivantes : « Default » et « Full ». Si ce paramètre est défini sur « Default », un objet de vue réduite est renvoyé. Lorsqu'elle n'est pas spécifiée, la valeur « Default » est utilisée.
Exemple de demande : cURL
curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Récupérer un enregistrement de connexion aux données spécifique
Pour récupérer des informations sur une connexion aux données Server existante, utilisez le point de terminaison
GET {baseURL}/v3/serverDataConnections /{dataConnectionId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
dataConnectionId (chaîne) : obligatoire. Saisissez un ID de connexion aux données Server pour obtenir des informations sur une connexion aux données spécifique.
Exemple de demande : cURL
curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections/61dec3bc536c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Mettre à jour une connexion aux données existante
Pour modifier le
nom
d'une connexion aux données Server existante, utilisez le point de terminaison
PUT {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
dataConnectionId (chaîne) : obligatoire. Saisissez un ID de connexion aux données Server pour indiquer la connexion aux données à mettre à jour.
updateServerConnectionContract (corps) : obligatoire. Saisissez un nouveau nom pour une connexion aux données :
name (chaîne) : obligatoire. Saisissez le nouveau nom de la connexion aux données.
Exemple de demande : 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'
Partager une connexion aux données Server avec un utilisateur
Pour partager une connexion aux données Server existante avec un utilisateur existant, utilisez le point de terminaison
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/users
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
dataConnectionId (chaîne) : obligatoire. Saisissez un ID de connexion aux données Server pour indiquer la connexion aux données à laquelle ajouter un utilisateur.
contract (corps) : obligatoire. Saisissez des informations sur l'utilisateur que vous souhaitez ajouter à une connexion aux données :
userId (chaîne) : obligatoire. Indiquez un ID d'utilisateur que vous souhaitez ajouter à une connexion aux données.
Exemple de demande : 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'
Partager une connexion aux données Server avec un groupe d'utilisateurs
Pour partager une connexion aux données Server existante avec un groupe d'utilisateurs existant, utilisez le point de terminaison
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
dataConnectionId (chaîne) : obligatoire. Saisissez un ID de connexion aux données Server pour indiquer la connexion aux données à laquelle ajouter un groupe d'utilisateurs.
contract (corps) : obligatoire. Saisissez des informations sur le groupe d'utilisateurs que vous souhaitez ajouter à une connexion aux données :
userGroupId (chaîne) : obligatoire. Indiquez un ID de groupe d'utilisateurs que vous souhaitez ajouter à une connexion aux données.
Exemple de demande : 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'
Retirer les autorisations d'un utilisateur d'exploiter une connexion aux données Server
Pour retirer les autorisations d'un utilisateur d'exploiter une connexion aux données Server existante, utilisez le point de terminaison
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/users/{userId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
dataConnectionId (chaîne) : obligatoire. Saisissez un ID de connexion aux données Server pour indiquer la connexion aux données à mettre à jour.
userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur que vous souhaitez retirer de la connexion aux données.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/users/61dec95f5436c22101353193' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Retirer les autorisations d'un groupe d'utilisateurs d'exploiter une connexion aux données Server
Pour retirer les autorisations d'un groupe d'utilisateurs d'exploiter une connexion aux données Server existante, utilisez le point de terminaison
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups/{userGroupId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
dataConnectionId (chaîne) : obligatoire. Saisissez un ID de connexion aux données Server pour indiquer la connexion aux données à mettre à jour.
userGroupId (chaîne) : obligatoire. Saisissez un ID de groupe d'utilisateurs que vous souhaitez retirer de la connexion aux données.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/userGroups/61decb225436c2210135336f' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Supprimer une connexion aux données Server
Pour supprimer une connexion aux données Server existante, utilisez le point de terminaison
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
Note
Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.
Paramètres
dataConnectionId (chaîne) : obligatoire. Saisissez un ID de connexion aux données Server pour indiquer la connexion aux données à supprimer.
Exemple de demande : cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Relations d'objets
Il n'y a aucune référence pour les connexions aux données Server pour le moment. L'avantage de pouvoir modifier les connexions aux données est que vous pouvez leur donner ou leur retirer l'accès. Cela facilite l'intégration de certaines autorisations aux sources de données.
Exemples de demandes Postman
GET /v3/serverDataConnections
PUT /v3/serverDataConnections/{dataConnectionId}
Pour en savoir plus sur les demandes Postman, consultez la page d'aide Comment utiliser Postman.