Obtener regla única

Punto final de API que recupera una sola regla de aprovisionamiento SAML por su ID, con resolución de campo completa a diferencia del punto final masivo.

Recupera una regla de aprovisionamiento SAML por su ID dentro de una organización.

PuntoFinal

GET /api/Rule/{partitionGlobalId}/{ruleId}

Solicitar encabezados.

--header 'Authorization: Bearer <your-access-token>'
--header 'Content-Type: application/json'

Parámetros

Nombre	Tipo	Ubicación	Obligatorio	Descripción
partitionGlobalId	GUID	Ruta	Sí	El identificador global de la organización. Para conocer los pasos para recuperar partitionGlobalId, consulta Recuperar IDGlobalDePartición para uso de la API.
ruleId	Entero	Ruta	Sí	El identificador único de la regla

Respuesta

Nota:

• A diferencia del punto final Obtener reglas en masa , el punto final Obtener regla resuelve assignedGroups como objetos de grupo completos.
• definition se devuelve como una cadena codificada en JSON, no como un objeto analizado.
• Los campos opcionales, como description, pueden devolverse como cadenas vacías.
• groupType se devuelve como un valor numérico (respaldado por enumeración).
• Pueden estar presentes campos adicionales, como mappedRole y scope, dependiendo del tipo de grupo y el entorno.

{
  "id": 2607,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Automation Users",
  "description": "",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"cdc34b5b-77d2-4ae1-9744-209d21ce557d\"],\"Conditions\":[{\"ClaimName\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress\",\"ConditionType\":\"Contains\",\"Value\":\"uipath.com\"}]}",
  "assignedGroups": [
    {
      "id": "cdc34b5b-77d2-4ae1-9744-209d21ce557d",
      "name": "Automation Users",
      "displayName": "Automation Users",
      "type": 0,
      "creationTime": "2021-01-22T16:29:33.7917688",
      "lastModificationTime": "2021-01-22T16:29:33.7917689",
      "members": [],
      "mappedRole": null,
      "scope": null
    }
  ]
}

Solicitud de ejemplo

{
  "id": 2607,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Automation Users",
  "description": "",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"cdc34b5b-77d2-4ae1-9744-209d21ce557d\"],\"Conditions\":[{\"ClaimName\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress\",\"ConditionType\":\"Contains\",\"Value\":\"uipath.com\"}]}" ,
  "assignedGroups": [
    {
      "id": "cdc34b5b-77d2-4ae1-9744-209d21ce557d",
      "name": "Automation Users",
      "displayName": "Automation Users",
      "type": 0,
      "creationTime": "2021-01-22T16:29:33.7917688",
      "lastModificationTime": "2021-01-22T16:29:33.7917689",
      "members": []
    }
  ]
}