Puntos de conexión de Server
Parámetros y puntos de conexión de las conexiones de Server
Compartir una conexión de datos de Alteryx Server con un usuario
Compartir una conexión de datos de Alteryx Server con un grupo de usuarios
Quitar los permisos de un usuario para usar una conexión de datos de Alteryx Server
Quitar los permisos de un grupo de usuarios para usar una conexión de datos de Alteryx Server
Para obtener más información sobre las relaciones entre objetos y cómo utilizarlas en la API, ve a la sección Relaciones entre objetos .
Para obtener más información sobre las conexiones de datos, visita la página de ayuda Conexiones de datos .
Recuperar todos los registros de conexión de datos
Para recuperar todos los registros de conexiones de datos de Alteryx Server accesibles, utiliza el punto de conexión
GET {baseURL}/v3/serverDataConnections
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
view (cadena): opcional. Se puede dejar sin un valor. Puedes elegir entre los siguientes valores: “Default" (predeterminado) y "Full" (completo). Si este parámetro se define como “Default" (predeterminado), entonces se devolverá un objeto de vista reducida. Cuando no se especifica, se utiliza el valor “Default" (predeterminado).
Ejemplo de solicitud: cURL
curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Recuperar un registro de conexión de datos específico
Para recuperar detalles sobre una conexión de datos de Alteryx Server existente, utiliza el punto de conexión
GET {baseURL}/v3/serverDataConnections /{dataConnectionId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
dataConnectionId (cadena): obligatorio. Ingresa un ID de conexión de datos de Server para obtener información sobre una conexión de datos específica.
Ejemplo de solicitud: cURL
curl --location --request GET 'http://localhost/webapi/v3/serverDataConnections/61dec3bc536c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Actualizar una conexión de datos existente
Para cambiar el
nombre
de una conexión de datos de Alteryx Server existente, utiliza el punto de conexión
PUT {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
dataConnectionId (cadena): obligatorio. Ingresa un ID de conexión de datos de Server para especificar la conexión de datos que deseas actualizar.
updateServerConnectionContract (cuerpo): obligatorio. Ingresa un nuevo nombre para una conexión de datos:
name (cadena): obligatorio. Ingresa el nuevo nombre de la conexión de datos.
Ejemplo de solicitud: 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'
Compartir una conexión de datos de Alteryx Server con un usuario
Para compartir una conexión de datos existente de Alteryx Server con un usuario existente, utiliza el punto de conexión
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/users
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
dataConnectionId (cadena): obligatorio. Ingresa un ID de conexión de datos de Server para especificar la conexión de datos a la que deseas agregar un usuario.
contract (cuerpo): obligatorio. Ingresa información sobre el usuario que quieres agregar a una conexión de datos:
userId (cadena): obligatorio. Especifica el ID de un usuario que desees agregar a una conexión de datos.
Ejemplo de solicitud: 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'
Compartir una conexión de datos de Alteryx Server con un grupo de usuarios
Para compartir una conexión de datos existente de Alteryx Server con un grupo de usuarios existente, utiliza el punto de conexión
POST {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
dataConnectionId (cadena): obligatorio. Ingresa un ID de conexión de datos de Server para especificar la conexión de datos a la que deseas agregar un grupo de usuarios.
contract (cuerpo): obligatorio. Ingresa información sobre el grupo de usuarios que deseas agregar a una conexión de datos:
userGroupId (cadena): obligatorio. Especifica el ID de un grupo de usuarios que deseas agregar a una conexión de datos.
Ejemplo de solicitud: 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'
Quitar los permisos de un usuario para usar una conexión de datos de Alteryx Server
A fin de quitar los permisos de un usuario para usar una conexión de datos de Alteryx Server existente, utiliza el punto de conexión
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/users/{userId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
dataConnectionId (cadena): obligatorio. Ingresa un ID de conexión de datos de Server para especificar la conexión de datos que deseas actualizar.
userId (cadena): obligatorio. Ingresa un ID de usuario que desees quitar de la conexión de datos.
Ejemplo de solicitud: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/users/61dec95f5436c22101353193' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Quitar los permisos de un grupo de usuarios para usar una conexión de datos de Alteryx Server
A fin de quitar los permisos de un grupo de usuarios para usar una conexión de datos de Alteryx Server existente, utiliza el punto de conexión
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}/userGroups/{userGroupId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
dataConnectionId (cadena): obligatorio. Ingresa un ID de conexión de datos de Server para especificar la conexión de datos que deseas actualizar.
userGroupId (cadena): obligatorio. Ingresa un ID de grupo de usuarios que desees quitar de la conexión de datos.
Ejemplo de solicitud: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa/userGroups/61decb225436c2210135336f' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Eliminar la conexión de datos de Alteryx Server
Para eliminar una conexión de datos de Alteryx Server existente, utiliza el punto de conexión
DELETE {baseURL}/v3/serverDataConnections/{dataConnectionId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Parámetros
dataConnectionId (cadena): obligatorio. Ingresa un ID de conexión de datos de Server para especificar la conexión de datos que deseas eliminar.
Ejemplo de solicitud: cURL
curl --location --request DELETE 'http://localhost/webapi/v3/serverDataConnections/61dec3bc5436c221013530fa' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Relaciones entre objetos
No hay referencias para las conexiones de datos de Server por ahora. El beneficio de tener las conexiones de datos modificables es que puedes asignar o anular el acceso a estas. Esto ayuda a incorporar ciertos permisos a fuentes de datos.
Ejemplos de solicitudes de Postman
GET /v3/serverDataConnections
PUT /v3/serverDataConnections/{dataConnectionId}
Para obtener más información sobre las solicitudes de Postman, visita la página de ayuda Cómo utilizar Postman.