Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Namespace: microsoft.graph.security
Represents a query against the Microsoft 365 unified audit log. Use this resource to define search parameters and retrieve audit log records.
Inherits from microsoft.graph.entity.
Methods
| Method | Return type | Description |
|---|---|---|
| Get audit log query | auditLogQuery | Read the properties and relationships of an auditLogQuery object. |
| List records | auditLogRecord collection | Get the auditLogRecord resources from the records navigation property. |
Properties
| Property | Type | Description |
|---|---|---|
| administrativeUnitIdFilters | String collection | The collection of administrative unit IDs to filter on. |
| approximateReturnedRecordCount | Int64 | The approximate number of records retrieved by the query. This value can be higher or lower than recordCountLimit due to distributed counting. Read-only. |
| displayName | String | The display name of the audit log query. |
| filterEndDateTime | DateTimeOffset | The end date and time of the audit log query filter. |
| filterStartDateTime | DateTimeOffset | The start date and time of the audit log query filter. |
| id | String | The unique identifier for the audit log query. Inherited from entity. |
| ipAddressFilters | String collection | The collection of IP addresses to filter on. |
| isRecordCountLimitExceeded | Boolean | Indicates whether the query exceeded the per-search record-count limit. The default value is false. A value of true is authoritative and isn't derived from approximateReturnedRecordCount. Read-only. |
| keywordFilter | String | Free text to match against the non-indexed content of each record: the workload-specific properties inside auditData, including its AppAccessContext object. The indexed common-schema properties, such as the operation name, aren't matched by keyword; use their own filters, such as operationFilters, for those. |
| objectIdFilters | String collection | The collection of object IDs to filter on. |
| operationFilters | String collection | The collection of operations to filter on. |
| recordCountLimit | Int64 | The record-count threshold used to limit query result retrieval. Read-only. |
| recordTypeFilters | microsoft.graph.security.auditLogRecordType collection | The collection of record types to filter on. |
| serviceFilters | String collection | The collection of services to filter on. |
| status | microsoft.graph.security.auditLogQueryStatus | The status of the audit log query. Possible values are: notStarted, running, succeeded, failed, cancelled, unknownFutureValue. |
| userPrincipalNameFilters | String collection | The collection of user principal names to filter on. |
Note
An audit log query can complete successfully after exceeding its record-count limit. Use isRecordCountLimitExceeded to determine whether the limit was exceeded. For information about tenant and per-query allocations, see Microsoft Graph service-specific throttling limits.
Relationships
| Relationship | Type | Description |
|---|---|---|
| records | microsoft.graph.security.auditLogRecord collection | The collection of audit log records retrieved by the query. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.security.auditLogQuery",
"id": "String (identifier)",
"displayName": "String",
"filterStartDateTime": "String (timestamp)",
"filterEndDateTime": "String (timestamp)",
"recordTypeFilters": ["String"],
"keywordFilter": "String",
"serviceFilters": ["String"],
"operationFilters": ["String"],
"userPrincipalNameFilters": ["String"],
"ipAddressFilters": ["String"],
"objectIdFilters": ["String"],
"administrativeUnitIdFilters": ["String"],
"status": "String",
"approximateReturnedRecordCount": "Int64",
"isRecordCountLimitExceeded": "Boolean",
"recordCountLimit": "Int64"
}