Skip to main content

Points de terminaison de la connexion à Server

Points de terminaison et paramètres de connexions à 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 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.

PUT /v3/serverDataConnections/{dataConnectionId}

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

Pour en savoir plus sur les demandes Postman, consultez la page d'aide Comment utiliser Postman.

Dans cette section​: