Saltar al contenido principal
Documentación
Documentación
Adaptive Planning
Última actualización: 2023-06-23
Conjuntos de permisos

Conjuntos de permisos

Punto final de URL

https://api.adaptiveplanning.com/api/rest/security/<version>/<tenant>/users/permissionSets
Versión: v1
Categoría
Actualización de datos
Descripción
Asigne conjuntos de permisos a usuarios de Adaptive Planning.
Permiso obligatorio para invocar
Usuarios
con acceso de administrador
,
conjuntos de permisos
La API de asignación de conjunto de permisos le permite recuperar y asignar conjuntos de permisos de usuario.

VERB HTTPS admitidos:

HTTP Verb
Recurso único
Recurso de recopilación
Descripción
GET
No admitido
Compatible
Recupera todos los usuarios y sus conjuntos de permisos asignados.
POST
Compatible
Compatible
Añade un conjunto de permisos o actualiza un conjunto de permisos existente para un usuario.

GET

Solicitud
/users/permissionSets
Recupera una recopilación de conjuntos de permisos asignados a usuarios
Recupera todos los usuarios y sus conjuntos de permisos asignados. Puede filtrar por instanceCode. Si falta el parámetro de consulta instanceCode, la API recupera todos los usuarios y sus conjuntos de permisos en su instancia por defecto. La paginación utiliza los valores por defecto de límite o compensación si no especifica estos parámetros de consulta.
URI de solicitud de muestra:
HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/
Parámetros de consulta:
Nombre
Descripción
Obligatorias
instanceCode
El identificador exclusivo de una instancia que define el contexto de instancia.
No
limit
El número máximo de objetos en una sola respuesta. El valor por defecto es 500. El máximo es 500.
No
offset
El índice de base cero del primer usuario de una recopilación de respuestas. El valor por defecto es 0.
Utilice la compensación con el parámetro limit para controlar la paginación de una recopilación de respuestas.
No
Respuesta de muestra
Respuesta de muestra de un usuario de instancia sincronizada con Workday
 


  "links": {
      "next": "https://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?offset=10&limit=5",
      "previous": "https://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?offset=0&limit=5"
  },{
  "total": 34,
  "users": [
      {
    "userGuid": "111SampleUserGuid",
    "wid": "14400000000000000000000000000samplewid",
    "userName": "sampleuser1@company.com",
    "permissionSet": [
      {
        "id": 1,
        "name": "samplePermissionSet1"
      }
    ]
  },
      {
    "userGuid": "112SampleUserGuid",
    "wid": "24400000000000000000000000000samplewid",
    "userName": "sampleuser3@company.com",
    "permissionSet": [
      {
        "id": 1,
        "name": "samplePermissionSet1"
      }
    ]
  },
      {
    "userGuid": "113SampleUserGuid",
    "wid": "34400000000000000000000000000samplewid",
    "userName": "sampleuser3@company.com",
    "permissionSet": [
      {
        "id": 2,
        "name": "samplePermissionSet2"
      }
    ]
  },
      {
    "userGuid": "114SampleUserGuid",
    "wid": "44400000000000000000000000000samplewid",
    "userName": "sampleuser4@company.com",
    "permissionSet": [
      {
        "id": 3,
        "name": "samplePermissionSet3"
      }
    ]
  },
      {
    "userGuid": "115SampleUserGuid",
    "wid": "54400000000000000000000000000samplewid",
    "userName": "sampleuser5@company.com",
    "permissionSet": [
      {
        "id": 4,
        "name": "samplePermissionSet4"
      }
    ]
  }
]
}

POST:

Solicitud:
/users/permissionSets:
Asigna o actualiza conjuntos de permisos para usuarios.
Añade un conjunto de permisos o actualiza un conjunto de permisos existente para un usuario. Puede filtrar por instanceCode. Si falta el parámetro de consulta instanceCode, la API asigna los conjuntos de permisos correspondientes a todos los usuarios de su instancia por defecto. En el cuerpo de la solicitud, especifique los siguientes campos de consulta obligatorios: <userIdentifier> y allowSet. Si desea enviar una solicitud masiva para asignar los conjuntos de permisos correspondientes a varios usuarios, especifique una matriz que contenga cada asignación de permisos.
Parámetros de consulta:
Nombre
Descripción
Obligatorias
instanceCode
El identificador exclusivo de una instancia que define el contexto de instancia.
No
userIdentifier
El identificador de usuario para determinar el ID de usuario exclusivo de Adaptive Planning. Valores posibles: userName, wid, userGuid.
Sí
Solicitud de muestra:
HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?userIdentifier=userName
Cuerpo de solicitud de muestra
Cuerpo de solicitud POST de muestra
 
[  
  {  
      "userName": "sampleuser1@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet1"
                  }
      ]
  },
  {
      "userName": "sampleuser2@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet2"
                  }
          ]
  },
  {
      "userName": "sampleuser3@company.com",
          "permissionSet": [
                  {
                      "name": "samplePermissionSet3"
                  }
          ]
  }
]
Parámetros de PayLoad
Nombre
Descripción
Obligatorias
wid
El ID de Workday de un usuario.
No
userName
El nombre de usuario (nombre de inicio de sesión) de un usuario.
No
userGuid
El identificador de usuario exclusivo global, asignado por el sistema en el momento de la creación.
No
nombre
ID
Nombre del conjunto de permisos.
ID de conjunto de permisos
El nombre o el ID del conjunto de permisos son obligatorios.
Sí