tipo de recurso riskyServicePrincipal

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa Microsoft Entra entidades de servicio que están en riesgo. Protección de Microsoft Entra ID evalúa continuamente el riesgo de la entidad de servicio en función de varias señales y el aprendizaje automático. Esta API proporciona acceso mediante programación a todas las entidades de servicio en riesgo del inquilino de Microsoft Entra.

Hereda de la entidad.

Nota: El uso de la API riskyServicePrincipal requiere una licencia de Id. de carga de trabajo de Microsoft Entra.

Métodos

Método	Tipo devuelto	Descripción
List	colección riskyServicePrincipal	Enumera las entidades de servicio de riesgo y sus propiedades de riesgo.
Get	riskyServicePrincipal	Obtenga una entidad de servicio de riesgo específica y sus propiedades de riesgo.
Dismiss	Ninguno	Descartar el riesgo de una entidad de servicio de riesgo.
Confirmar lo que está en peligro	Ninguno	Confirme que una entidad de servicio de riesgo está en peligro.
Historial de listas	colección riskyServicePrincipalHistoryItem	Obtenga el historial de riesgos de una entidad de servicio Microsoft Entra.

Propiedades

Propiedad	Tipo	Descripción
accountEnabled	Boolean	true si la entidad de servicio está habilitada; en caso contrario, false.
appId	Cadena	Identificador único global de la aplicación asociada (su propiedad appId ), si existe.
displayName	Cadena	El nombre para mostrar de la entidad de servicio.
id	Cadena	Identificador único asignado a la entidad de servicio en riesgo. Heredado de la entidad.
isProcessing	Booleano	Indica si Protección de Microsoft Entra ID está procesando actualmente el estado de riesgo de la entidad de servicio.
riskDetail	riskDetail	Detalles del riesgo detectado. Nota: Los detalles de esta propiedad solo están disponibles para los clientes de Workload Identities Premium. Los eventos de los inquilinos sin esta licencia se devolverán hidden. Los valores posibles son: none, hidden, unknownFutureValue, adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolvable: adminConfirmedServicePrincipalCompromised , adminDismissedAllRiskForServicePrincipal.
riskLastUpdatedDateTime	DateTimeOffset	Fecha y hora en que se actualizó por última vez el estado de riesgo. El tipo DateTimeOffset representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, medianoche UTC del 1 de enero de 2021 es 2021-01-01T00:00:00Z. Admite $filter (eq).
riskLevel	riskLevel	Nivel de la identidad de carga de trabajo de riesgo detectada. Los valores posibles son: low, medium, high, hidden, none, unknownFutureValue. Admite $filter (eq).
riskState	riskState	Estado del riesgo de la entidad de servicio. Los valores posibles son: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised y unknownFutureValue.
servicePrincipalType	Cadena	Identifica si la entidad de servicio representa un Application, un ManagedIdentityo una aplicación heredada (socialIdp). Esto lo establece Microsoft Entra ID internamente y se hereda de servicePrincipal.

Relaciones

Relación	Tipo	Descripción
historia	colección riskyServicePrincipalHistoryItem	Representa el historial de riesgos de Microsoft Entra entidades de servicio.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.riskyServicePrincipal",
  "id": "String (identifier)",
  "accountEnabled": "Boolean",
  "isProcessing": "Boolean",
  "riskLastUpdatedDateTime": "String (timestamp)",
  "riskLevel": "String",
  "riskState": "String",
  "riskDetail": "String",
  "displayName": "String",
  "appId": "String",
  "servicePrincipalType": "String"
}