Class ListAuditLogsFilters

Namespace

Cloudflare.NET.AuditLogs.Models

Assembly

Cloudflare.NET.dll

Filtering and pagination options for listing audit logs.

All filter arrays support both inclusion and exclusion. Use the main array for inclusion, and the corresponding Not array for exclusion.

public record ListAuditLogsFilters : IEquatable<ListAuditLogsFilters>

Inheritance

object

ListAuditLogsFilters

Implements

IEquatable<ListAuditLogsFilters>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Examples

// Get logs for specific action types, excluding failures
var filters = new ListAuditLogsFilters(
  ActionTypes: new[] { "create", "update" },
  ActionResultsNot: new[] { "failure" }
);

Constructors

ListAuditLogsFilters(string?, int?, ListOrderDirection?, DateTime?, DateTime?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<int>?, IReadOnlyList<int>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?)

Filtering and pagination options for listing audit logs.

All filter arrays support both inclusion and exclusion. Use the main array for inclusion, and the corresponding Not array for exclusion.

public ListAuditLogsFilters(string? Cursor = null, int? Limit = null, ListOrderDirection? Direction = null, DateTime? Before = null, DateTime? Since = null, IReadOnlyList<string>? Ids = null, IReadOnlyList<string>? IdsNot = null, IReadOnlyList<string>? ActorEmails = null, IReadOnlyList<string>? ActorEmailsNot = null, IReadOnlyList<string>? ActorIds = null, IReadOnlyList<string>? ActorIdsNot = null, IReadOnlyList<string>? ActorIpAddresses = null, IReadOnlyList<string>? ActorIpAddressesNot = null, IReadOnlyList<string>? ActorTokenIds = null, IReadOnlyList<string>? ActorTokenIdsNot = null, IReadOnlyList<string>? ActorTokenNames = null, IReadOnlyList<string>? ActorTokenNamesNot = null, IReadOnlyList<string>? ActorContexts = null, IReadOnlyList<string>? ActorContextsNot = null, IReadOnlyList<string>? ActorTypes = null, IReadOnlyList<string>? ActorTypesNot = null, IReadOnlyList<string>? ActionTypes = null, IReadOnlyList<string>? ActionTypesNot = null, IReadOnlyList<string>? ActionResults = null, IReadOnlyList<string>? ActionResultsNot = null, IReadOnlyList<string>? ResourceIds = null, IReadOnlyList<string>? ResourceIdsNot = null, IReadOnlyList<string>? ResourceProducts = null, IReadOnlyList<string>? ResourceProductsNot = null, IReadOnlyList<string>? ResourceTypes = null, IReadOnlyList<string>? ResourceTypesNot = null, IReadOnlyList<string>? ResourceScopes = null, IReadOnlyList<string>? ResourceScopesNot = null, IReadOnlyList<string>? ZoneIds = null, IReadOnlyList<string>? ZoneIdsNot = null, IReadOnlyList<string>? ZoneNames = null, IReadOnlyList<string>? ZoneNamesNot = null, IReadOnlyList<string>? RawCfRayIds = null, IReadOnlyList<string>? RawCfRayIdsNot = null, IReadOnlyList<string>? RawMethods = null, IReadOnlyList<string>? RawMethodsNot = null, IReadOnlyList<int>? RawStatusCodes = null, IReadOnlyList<int>? RawStatusCodesNot = null, IReadOnlyList<string>? RawUris = null, IReadOnlyList<string>? RawUrisNot = null, IReadOnlyList<string>? AccountNames = null, IReadOnlyList<string>? AccountNamesNot = null)

Parameters

Cursor string

Pagination cursor from previous response.

Limit int?

Maximum results per request (1-1000, default 100).

Direction ListOrderDirection?

Sort direction.

Before DateTime?

Return logs from before this date (RFC3339).

Since DateTime?

Return logs from after this date (RFC3339).

Ids IReadOnlyList<string>

Filter by specific audit log IDs.

IdsNot IReadOnlyList<string>

Exclude specific audit log IDs.

ActorEmails IReadOnlyList<string>

Filter by actor email addresses.

ActorEmailsNot IReadOnlyList<string>

Exclude specific actor email addresses.

ActorIds IReadOnlyList<string>

Filter by actor IDs.

ActorIdsNot IReadOnlyList<string>

Exclude specific actor IDs.

ActorIpAddresses IReadOnlyList<string>

Filter by actor IP addresses.

ActorIpAddressesNot IReadOnlyList<string>

Exclude specific actor IP addresses.

ActorTokenIds IReadOnlyList<string>

Filter by actor token IDs.

ActorTokenIdsNot IReadOnlyList<string>

Exclude specific actor token IDs.

ActorTokenNames IReadOnlyList<string>

Filter by actor token names.

ActorTokenNamesNot IReadOnlyList<string>

Exclude specific actor token names.

ActorContexts IReadOnlyList<string>

Filter by actor contexts (e.g., "dashboard", "api").

ActorContextsNot IReadOnlyList<string>

Exclude specific actor contexts.

ActorTypes IReadOnlyList<string>

Filter by actor types (e.g., "user", "system").

ActorTypesNot IReadOnlyList<string>

Exclude specific actor types.

ActionTypes IReadOnlyList<string>

Filter by action types (e.g., "create", "update", "delete").

ActionTypesNot IReadOnlyList<string>

Exclude specific action types.

ActionResults IReadOnlyList<string>

Filter by action results (e.g., "success", "failure").

ActionResultsNot IReadOnlyList<string>

Exclude specific action results.

ResourceIds IReadOnlyList<string>

Filter by resource IDs.

ResourceIdsNot IReadOnlyList<string>

Exclude specific resource IDs.

ResourceProducts IReadOnlyList<string>

Filter by resource products.

ResourceProductsNot IReadOnlyList<string>

Exclude specific resource products.

ResourceTypes IReadOnlyList<string>

Filter by resource types.

ResourceTypesNot IReadOnlyList<string>

Exclude specific resource types.

ResourceScopes IReadOnlyList<string>

Filter by resource scopes.

ResourceScopesNot IReadOnlyList<string>

Exclude specific resource scopes.

ZoneIds IReadOnlyList<string>

Filter by zone IDs.

ZoneIdsNot IReadOnlyList<string>

Exclude specific zone IDs.

ZoneNames IReadOnlyList<string>

Filter by zone names.

ZoneNamesNot IReadOnlyList<string>

Exclude specific zone names.

RawCfRayIds IReadOnlyList<string>

Filter by Cloudflare Ray IDs.

RawCfRayIdsNot IReadOnlyList<string>

Exclude specific Cloudflare Ray IDs.

RawMethods IReadOnlyList<string>

Filter by HTTP methods.

RawMethodsNot IReadOnlyList<string>

Exclude specific HTTP methods.

RawStatusCodes IReadOnlyList<int>

Filter by HTTP status codes.

RawStatusCodesNot IReadOnlyList<int>

Exclude specific HTTP status codes.

RawUris IReadOnlyList<string>

Filter by request URIs.

RawUrisNot IReadOnlyList<string>

Exclude specific request URIs.

AccountNames IReadOnlyList<string>

Filter by account names.

AccountNamesNot IReadOnlyList<string>

Exclude specific account names.

Examples

// Get logs for specific action types, excluding failures
var filters = new ListAuditLogsFilters(
  ActionTypes: new[] { "create", "update" },
  ActionResultsNot: new[] { "failure" }
);

Properties

AccountNames

Filter by account names.

public IReadOnlyList<string>? AccountNames { get; init; }

Property Value

IReadOnlyList<string>

AccountNamesNot

Exclude specific account names.

public IReadOnlyList<string>? AccountNamesNot { get; init; }

Property Value

IReadOnlyList<string>

ActionResults

Filter by action results (e.g., "success", "failure").

public IReadOnlyList<string>? ActionResults { get; init; }

Property Value

IReadOnlyList<string>

ActionResultsNot

Exclude specific action results.

public IReadOnlyList<string>? ActionResultsNot { get; init; }

Property Value

IReadOnlyList<string>

ActionTypes

Filter by action types (e.g., "create", "update", "delete").

public IReadOnlyList<string>? ActionTypes { get; init; }

Property Value

IReadOnlyList<string>

ActionTypesNot

Exclude specific action types.

public IReadOnlyList<string>? ActionTypesNot { get; init; }

Property Value

IReadOnlyList<string>

ActorContexts

Filter by actor contexts (e.g., "dashboard", "api").

public IReadOnlyList<string>? ActorContexts { get; init; }

Property Value

IReadOnlyList<string>

ActorContextsNot

Exclude specific actor contexts.

public IReadOnlyList<string>? ActorContextsNot { get; init; }

Property Value

IReadOnlyList<string>

ActorEmails

Filter by actor email addresses.

public IReadOnlyList<string>? ActorEmails { get; init; }

Property Value

IReadOnlyList<string>

ActorEmailsNot

Exclude specific actor email addresses.

public IReadOnlyList<string>? ActorEmailsNot { get; init; }

Property Value

IReadOnlyList<string>

ActorIds

Filter by actor IDs.

public IReadOnlyList<string>? ActorIds { get; init; }

Property Value

IReadOnlyList<string>

ActorIdsNot

Exclude specific actor IDs.

public IReadOnlyList<string>? ActorIdsNot { get; init; }

Property Value

IReadOnlyList<string>

ActorIpAddresses

Filter by actor IP addresses.

public IReadOnlyList<string>? ActorIpAddresses { get; init; }

Property Value

IReadOnlyList<string>

ActorIpAddressesNot

Exclude specific actor IP addresses.

public IReadOnlyList<string>? ActorIpAddressesNot { get; init; }

Property Value

IReadOnlyList<string>

ActorTokenIds

Filter by actor token IDs.

public IReadOnlyList<string>? ActorTokenIds { get; init; }

Property Value

IReadOnlyList<string>

ActorTokenIdsNot

Exclude specific actor token IDs.

public IReadOnlyList<string>? ActorTokenIdsNot { get; init; }

Property Value

IReadOnlyList<string>

ActorTokenNames

Filter by actor token names.

public IReadOnlyList<string>? ActorTokenNames { get; init; }

Property Value

IReadOnlyList<string>

ActorTokenNamesNot

Exclude specific actor token names.

public IReadOnlyList<string>? ActorTokenNamesNot { get; init; }

Property Value

IReadOnlyList<string>

ActorTypes

Filter by actor types (e.g., "user", "system").

public IReadOnlyList<string>? ActorTypes { get; init; }

Property Value

IReadOnlyList<string>

ActorTypesNot

Exclude specific actor types.

public IReadOnlyList<string>? ActorTypesNot { get; init; }

Property Value

IReadOnlyList<string>

Before

Return logs from before this date (RFC3339).

public DateTime? Before { get; init; }

Property Value

DateTime?

Cursor

Pagination cursor from previous response.

public string? Cursor { get; init; }

Property Value

string

Direction

Sort direction.

public ListOrderDirection? Direction { get; init; }

Property Value

ListOrderDirection?

Ids

Filter by specific audit log IDs.

public IReadOnlyList<string>? Ids { get; init; }

Property Value

IReadOnlyList<string>

IdsNot

Exclude specific audit log IDs.

public IReadOnlyList<string>? IdsNot { get; init; }

Property Value

IReadOnlyList<string>

Limit

Maximum results per request (1-1000, default 100).

public int? Limit { get; init; }

Property Value

int?

RawCfRayIds

Filter by Cloudflare Ray IDs.

public IReadOnlyList<string>? RawCfRayIds { get; init; }

Property Value

IReadOnlyList<string>

RawCfRayIdsNot

Exclude specific Cloudflare Ray IDs.

public IReadOnlyList<string>? RawCfRayIdsNot { get; init; }

Property Value

IReadOnlyList<string>

RawMethods

Filter by HTTP methods.

public IReadOnlyList<string>? RawMethods { get; init; }

Property Value

IReadOnlyList<string>

RawMethodsNot

Exclude specific HTTP methods.

public IReadOnlyList<string>? RawMethodsNot { get; init; }

Property Value

IReadOnlyList<string>

RawStatusCodes

Filter by HTTP status codes.

public IReadOnlyList<int>? RawStatusCodes { get; init; }

Property Value

IReadOnlyList<int>

RawStatusCodesNot

Exclude specific HTTP status codes.

public IReadOnlyList<int>? RawStatusCodesNot { get; init; }

Property Value

IReadOnlyList<int>

RawUris

Filter by request URIs.

public IReadOnlyList<string>? RawUris { get; init; }

Property Value

IReadOnlyList<string>

RawUrisNot

Exclude specific request URIs.

public IReadOnlyList<string>? RawUrisNot { get; init; }

Property Value

IReadOnlyList<string>

ResourceIds

Filter by resource IDs.

public IReadOnlyList<string>? ResourceIds { get; init; }

Property Value

IReadOnlyList<string>

ResourceIdsNot

Exclude specific resource IDs.

public IReadOnlyList<string>? ResourceIdsNot { get; init; }

Property Value

IReadOnlyList<string>

ResourceProducts

Filter by resource products.

public IReadOnlyList<string>? ResourceProducts { get; init; }

Property Value

IReadOnlyList<string>

ResourceProductsNot

Exclude specific resource products.

public IReadOnlyList<string>? ResourceProductsNot { get; init; }

Property Value

IReadOnlyList<string>

ResourceScopes

Filter by resource scopes.

public IReadOnlyList<string>? ResourceScopes { get; init; }

Property Value

IReadOnlyList<string>

ResourceScopesNot

Exclude specific resource scopes.

public IReadOnlyList<string>? ResourceScopesNot { get; init; }

Property Value

IReadOnlyList<string>

ResourceTypes

Filter by resource types.

public IReadOnlyList<string>? ResourceTypes { get; init; }

Property Value

IReadOnlyList<string>

ResourceTypesNot

Exclude specific resource types.

public IReadOnlyList<string>? ResourceTypesNot { get; init; }

Property Value

IReadOnlyList<string>

Since

Return logs from after this date (RFC3339).

public DateTime? Since { get; init; }

Property Value

DateTime?

ZoneIds

Filter by zone IDs.

public IReadOnlyList<string>? ZoneIds { get; init; }

Property Value

IReadOnlyList<string>

ZoneIdsNot

Exclude specific zone IDs.

public IReadOnlyList<string>? ZoneIdsNot { get; init; }

Property Value

IReadOnlyList<string>

ZoneNames

Filter by zone names.

public IReadOnlyList<string>? ZoneNames { get; init; }

Property Value

IReadOnlyList<string>

ZoneNamesNot

Exclude specific zone names.

public IReadOnlyList<string>? ZoneNamesNot { get; init; }

Property Value

IReadOnlyList<string>