Compartir a través de


Tipo de recurso directoryAudit

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 los elementos de auditoría de directorio y su colección.

Métodos

Método Tipo de valor devuelto Descripción
List directoryAudit Muestra los elementos de auditoría de directorio de la colección y sus propiedades.
Get directoryAudit Obtiene un elemento de auditoría de directorio específico y sus propiedades.

Propiedades

Propiedad Tipo Descripción
activityDateTime DateTimeOffset Indica la fecha y hora que se realizó la actividad. El tipo Timestamp está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Admite $filter (eq, ge, le) y $orderby.
activityDisplayName Cadena Indica el nombre de la actividad o el nombre de la operación (por ejemplo, "Create User", "Add member to group"). Para obtener una lista de las actividades registradas, consulte Microsoft Entra categorías y actividades del registro de auditoría. Admite $filter (eq, startswith).
additionalDetails Colección keyvalue Indica más detalles sobre la actividad.
categoría Cadena Indica la categoría de recurso a la que se dirige la actividad. Por ejemplo: UserManagement, GroupManagement, ApplicationManagement, RoleManagement. Para obtener una lista de categorías para las actividades registradas, consulte Microsoft Entra categorías y actividades del registro de auditoría.
correlationId Guid Indica un identificador único que ayuda a correlacionar las actividades que se extienden entre varios servicios. Puede utilizarse para realizar un seguimiento de los registros en todos los servicios. Admite $filter (eq).
id Cadena Indica el identificador único de la actividad. Admite $filter (eq).
initiatedBy auditActivityInitiator Indica información sobre el usuario o la aplicación que inició la actividad. Admite $filter (eq) parael identificador de usuario/,displayName de usuario/, user/userPrincipalName, app/appId, app/displayName; y $filter (startswith) para user/userPrincipalName.
loggedByService Cadena Indica información sobre el servicio que inicia la actividad (por ejemplo: Administración de contraseñas de autoservicio, directorio principal, B2C, usuarios invitados, Microsoft Identity Manager o Privileged Identity Management). Admite $filter (eq).
operationType Cadena Indica el tipo de operación que se realizó. Los valores posibles incluyen, entre otros, los siguientes: Add, Assign, Update, Unassigny Delete.
result operationResult Indica el resultado de la actividad. Los valores posibles son: success, failure, timeout y unknownFutureValue.
resultReason Cadena Indica el motivo del error si el resultado es failure o timeout.
targetResources Colección targetResource Información sobre el recurso que cambió debido a la actividad. Admite $filter (eq) para id y displayName; y $filter (startswith) para displayName.
userAgent Cadena Tipo de agente de usuario usado por un usuario en la actividad.

Relaciones

Ninguno

Representación JSON

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

{
  "activityDateTime": "String (timestamp)",
  "activityDisplayName": "String",
  "additionalDetails": [{"@odata.type": "microsoft.graph.keyValue"}],
  "category": "String",
  "correlationId": "Guid",
  "id": "String (identifier)",
  "initiatedBy": {"@odata.type": "microsoft.graph.auditActivityInitiator"},
  "loggedByService": "String",
  "operationType": "String",
  "result": "string",
  "resultReason": "String",
  "targetResources": [{"@odata.type": "microsoft.graph.targetResource"}],
  "userAgent": "String"
}