Puntos de conexión de credenciales
Parámetros y puntos de conexión de las credenciales
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 credenciales, visita la página de ayuda Credenciales .
Nota
No permitimos que se creen credenciales a través de la API. Para crear una credencial como administrador, utiliza la Interfaz de usuario de Server .
Recuperar todos los registros de credenciales
Para obtener información sobre todas las credenciales, utiliza el punto de conexión
GET {baseURL}/v3/credentials
.
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).
userId (cadena): opcional. Para filtrar los resultados por userId, ingresa el ID de un usuario.
userGroupId (cadena): opcional. Para filtrar los resultados por userGroupId, ingresa el ID de un grupo de usuarios.
Recuperar un registro de credencial
Para recuperar información acerca de una credencial, utiliza el punto de conexión
GET {baseURL}/v3/credentials/{credentialId}
.
Parámetros
credentialId (cadena): obligatorio. Ingresa un ID de colección para obtener información acerca de una credencial específica.
Compartir una credencial con un usuario
Para compartir una credencial con un usuario, utiliza el punto de conexión
POST {baseURL}
/v3/credentials/{credentialId}/users
.
Parámetros
credentialId (cadena): obligatorio. Ingresa un ID de colección que desees compartir.
contract (cuerpo): obligatorio. Especifica lo siguiente para compartir una credencial con un usuario:
userId (cadena): obligatorio. Especifica el ID de un usuario con el que deseas compartir una credencial.
Compartir una credencial con un grupo de usuarios
Para compartir una credencial con un grupo de usuarios, utiliza el punto de conexión
POST {baseURL}
/v3/credentials/{credentialId}/userGroups
.
Parámetros
credentialId (cadena): obligatorio. Ingresa un ID de credencial que desees compartir.
contract (cuerpo): obligatorio. Especifica lo siguiente para compartir una credencial con un grupo de usuarios:
userGroupId (cadena): obligatorio. Especifica el ID de un grupo de usuarios con el que desees compartir una credencial.
Quitar un usuario de una credencial
Para quitar un usuario de una credencial, utiliza el punto de conexión
DELETE {baseURL}/v3/credentials/{credentialId}/users/{userId}
.
Parámetros
credentialId (cadena): obligatorio. Ingresa el ID de credencial del que deseas quitar el usuario.
userId (cadena): obligatorio. Ingresa un ID de usuario que desees quitar de la credencial.
Quitar un grupo de usuarios de una credencial
Para quitar un grupo de usuarios de una credencial, utiliza el punto de conexión
DELETE {baseURL}/v3/credentials/{credentialId}/userGroups/{userGroupId}
.
Parámetros
credentialId (cadena): obligatorio. Ingresa el ID de credencial del que deseas quitar el grupo de usuarios.
userGroupId (cadena): obligatorio. Ingresa un ID de grupo de usuarios que desees quitar de la credencial.
Eliminar una credencial
Para quitar una credencial, utiliza el punto de conexión
DELETE {baseURL}/v3/credentials/{credentialId}
.
Parámetros
credentialId (cadena): obligatorio. Ingresa el ID de credencial que deseas eliminar.
force (booleano): opcional. Selecciona si deseas forzar la eliminación de una credencial en caso de que haya algún recurso compartido. Si deseas eliminar la credencial y limpiar todos los recursos compartidos, establece el parámetro force en verdadero. Si no se selecciona, el valor predeterminado es falso. Esto es para protegerse contra una llamada errante.
Relaciones entre objetos
Para obtener información sobre los ID de credencial existentes, utiliza el punto de conexión GET /v3/credentials . El credentialId que obtienes se puede utilizar en las siguientes situaciones:
Cuando deseas obtener información sobre una credencial específica .
Cuando deseas compartir una credencial con un usuario .
Cuando deseas compartir una credencial con un grupo de usuarios .
Cuando deseas quitar un usuario de una credencial .
Cuando deseas quitar un grupo de usuarios de una credencial .
Cuando deseas eliminar una credencial específica .