Class ZoneLockdownApi

Namespace

Cloudflare.NET.Zones.Firewall

Assembly

Cloudflare.NET.dll

Implements the API for managing Zone Lockdown rules.

public class ZoneLockdownApi : ApiResource, IZoneLockdownApi

Inheritance

object

ApiResource

ZoneLockdownApi

Implements

IZoneLockdownApi

Inherited Members

ApiResource.HttpClient

ApiResource.Logger

ApiResource.GetAsync<TResult>(string, CancellationToken)

ApiResource.GetAsync<TResult>(string, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.PostAsync<TResult>(string, object, CancellationToken)

ApiResource.PutAsync<TResult>(string, object, CancellationToken)

ApiResource.PutAsync<TResult>(string, object, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.PostAsync<TResult>(string, object, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.PostJsonAsync<TResult>(string, string, CancellationToken)

ApiResource.PutJsonAsync<TResult>(string, string, CancellationToken)

ApiResource.PutJsonAsync<TResult>(string, string, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.PatchAsync<TResult>(string, object, CancellationToken)

ApiResource.PatchAsync<TResult>(string, object, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.DeleteAsync<TResult>(string, CancellationToken)

ApiResource.DeleteAsync<TResult>(string, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.GetStringAsync(string, CancellationToken)

ApiResource.PostMultipartFileAsync<TResult>(string, Stream, string, string, CancellationToken)

ApiResource.GetPagePaginatedResultAsync<TItem>(string, CancellationToken)

ApiResource.GetCursorPaginatedResultAsync<TItem>(string, CancellationToken)

ApiResource.GetCursorPaginatedResultAsync<TWrapper, TItem>(string, Func<TWrapper, IReadOnlyList<TItem>>, CancellationToken)

ApiResource.GetCursorPaginatedResultAsync<TWrapper, TItem>(string, Func<TWrapper, IReadOnlyList<TItem>>, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.GetPaginatedAsync<TItem>(string, int?, CancellationToken)

ApiResource.GetCursorPaginatedAsync<TItem>(string, int?, CancellationToken)

ApiResource.GetCursorPaginatedAsync<TWrapper, TItem>(string, int?, Func<TWrapper, IReadOnlyList<TItem>>, CancellationToken)

ApiResource.GetCursorPaginatedAsync<TWrapper, TItem>(string, int?, Func<TWrapper, IReadOnlyList<TItem>>, IEnumerable<KeyValuePair<string, string>>, CancellationToken)

ApiResource.ProcessResponse<T>(HttpResponseMessage, CancellationToken)

ApiResource.ProcessAndDeserializeAsync<T>(HttpResponseMessage, CancellationToken)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Constructors

ZoneLockdownApi(HttpClient, ILoggerFactory)

Implements the API for managing Zone Lockdown rules.

public ZoneLockdownApi(HttpClient httpClient, ILoggerFactory loggerFactory)

Parameters

httpClient HttpClient

loggerFactory ILoggerFactory

Methods

CreateAsync(string, CreateLockdownRequest, CancellationToken)

Creates a new Lockdown rule for a zone.

public Task<Lockdown> CreateAsync(string zoneId, CreateLockdownRequest request, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

request CreateLockdownRequest

The request containing the details of the rule to create.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<Lockdown>

The created Lockdown rule.

DeleteAsync(string, string, CancellationToken)

Deletes a Lockdown rule from a zone.

public Task<string> DeleteAsync(string zoneId, string lockdownId, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

lockdownId string

The ID of the rule to delete.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<string>

The ID of the deleted rule.

GetAsync(string, string, CancellationToken)

Gets a single Lockdown rule by its ID.

public Task<Lockdown> GetAsync(string zoneId, string lockdownId, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

lockdownId string

The ID of the Lockdown rule.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<Lockdown>

The requested Lockdown rule.

ListAllAsync(string, int?, CancellationToken)

Lists all Lockdown rules for a zone, automatically handling pagination.

public IAsyncEnumerable<Lockdown> ListAllAsync(string zoneId, int? perPage = null, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

perPage int?

The number of results to fetch per API page.

cancellationToken CancellationToken

A cancellation token.

Returns

IAsyncEnumerable<Lockdown>

An asynchronous stream of all Lockdown rules for the zone.

Remarks

This method simplifies fetching all rules by abstracting away the pagination logic.

ListAsync(string, ListLockdownFilters?, CancellationToken)

Lists all Lockdown rules for a zone, allowing for manual pagination.

public Task<PagePaginatedResult<Lockdown>> ListAsync(string zoneId, ListLockdownFilters? filters = null, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

filters ListLockdownFilters

Optional pagination filters.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<PagePaginatedResult<Lockdown>>

A single page of Lockdown rules along with pagination information.

Remarks

This method is intended for developers who need to control the pagination process manually. Use the properties of the returned PagePaginatedResult<T> to determine if there are more pages and to construct the filter for the next call.

UpdateAsync(string, string, UpdateLockdownRequest, CancellationToken)

Updates an existing Lockdown rule.

public Task<Lockdown> UpdateAsync(string zoneId, string lockdownId, UpdateLockdownRequest request, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

lockdownId string

The ID of the rule to update.

request UpdateLockdownRequest

The request containing the fields to update.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<Lockdown>

The updated Lockdown rule.