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
Ajouter un utilisateur à une connexion aux données existante
Ajouter un groupe d'utilisateurs à une connexion aux données existante
Retirer un utilisateur d'une connexion aux données existante
Retirer un groupe d'utilisateurs d'une connexion aux données existante
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 Connexions aux données .
Récupérer tous les enregistrements de connexion aux données
Pour obtenir des informations sur tous les enregistrements de connexion aux données Server, utilisez le point de terminaison
GET {baseURL}/v3/serverDataConnections
.
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 spécifique, utilisez le point de terminaison
GET {baseURL}/v3/serverDataConnections /{dataConnectionId}
.
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 paramètre
name
d'une connexion aux données, utilisez le point de terminaison
PUT {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
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'
Ajouter un utilisateur à une connexion aux données
Pour ajouter un utilisateur à une connexion aux données Server, utilisez le point de terminaison
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/users
.
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'
Ajouter un groupe d'utilisateurs à une connexion aux données
Pour ajouter un groupe d'utilisateurs à une connexion aux données Server, utilisez le point de terminaison
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups
.
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 un utilisateur d'une connexion aux données
Pour retirer un utilisateur d'une connexion aux données Server, utilisez le point de terminaison
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/users/{userId}
.
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 un groupe d'utilisateurs d'une connexion aux données
Pour retirer un groupe d'utilisateurs d'une connexion aux données Server, utilisez le point de terminaison
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups/{userGroupId}
.
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
Pour supprimer une connexion aux données Server spécifique, utilisez le point de terminaison
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
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
![Use the GET /v3/serverDataConnections endpoint.](../../../../image/uuid-a52ebec2-8675-7048-4724-1b4de7879422.png)
PUT /v3/serverDataConnections/{dataConnectionId}
![Use the PUT /v3/serverDataConnections/{dataConnectionId} endpoint.](../../../../image/uuid-5e38d9f0-121d-b5b5-e3d8-2e181fe513ff.png)
Pour en savoir plus sur les demandes Postman, consultez la page d'aide Comment utiliser Postman .