Class CustomHostnamesApi

Namespace

Cloudflare.NET.Zones.CustomHostnames

Assembly

Cloudflare.NET.dll

Implements the API for managing Custom Hostnames (Cloudflare for SaaS) at the zone level.

public class CustomHostnamesApi : ApiResource, ICustomHostnamesApi

Inheritance

object

ApiResource

CustomHostnamesApi

Implements

ICustomHostnamesApi

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

CustomHostnamesApi(HttpClient, ILoggerFactory)

Implements the API for managing Custom Hostnames (Cloudflare for SaaS) at the zone level.

public CustomHostnamesApi(HttpClient httpClient, ILoggerFactory loggerFactory)

Parameters

httpClient HttpClient

loggerFactory ILoggerFactory

Methods

CreateAsync(string, CreateCustomHostnameRequest, CancellationToken)

Creates a new custom hostname for the specified zone.

public Task<CustomHostname> CreateAsync(string zoneId, CreateCustomHostnameRequest request, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

request CreateCustomHostnameRequest

The request containing the custom hostname configuration.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<CustomHostname>

The created custom hostname with its initial status and SSL information.

DeleteAsync(string, string, CancellationToken)

Deletes a custom hostname and any associated SSL certificates.

public Task DeleteAsync(string zoneId, string customHostnameId, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

customHostnameId string

The ID of the custom hostname to delete.

cancellationToken CancellationToken

A cancellation token.

Returns

Task

DeleteFallbackOriginAsync(string, CancellationToken)

Deletes the fallback origin configuration for the zone.

public Task DeleteFallbackOriginAsync(string zoneId, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

cancellationToken CancellationToken

A cancellation token.

Returns

Task

GetAsync(string, string, CancellationToken)

Gets the details of a specific custom hostname.

public Task<CustomHostname> GetAsync(string zoneId, string customHostnameId, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

customHostnameId string

The ID of the custom hostname to retrieve.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<CustomHostname>

The custom hostname details including current status and SSL information.

GetFallbackOriginAsync(string, CancellationToken)

Gets the fallback origin for custom hostnames in the zone.

public Task<FallbackOrigin> GetFallbackOriginAsync(string zoneId, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<FallbackOrigin>

The fallback origin configuration.

Remarks

The fallback origin is the default origin server used when a custom hostname does not have a specific custom_origin_server configured.

ListAllAsync(string, ListCustomHostnamesFilters?, CancellationToken)

Lists all custom hostnames for the specified zone, automatically handling pagination.

public IAsyncEnumerable<CustomHostname> ListAllAsync(string zoneId, ListCustomHostnamesFilters? filters = null, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

filters ListCustomHostnamesFilters

Optional filters to apply. Pagination parameters (Page, PerPage) will be managed automatically.

cancellationToken CancellationToken

A cancellation token.

Returns

IAsyncEnumerable<CustomHostname>

An asynchronous stream of all custom hostnames matching the criteria.

ListAsync(string, ListCustomHostnamesFilters?, CancellationToken)

Lists custom hostnames for the specified zone, allowing for manual pagination control.

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

Parameters

zoneId string

The ID of the zone.

filters ListCustomHostnamesFilters

Optional filters to apply, including pagination parameters.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<PagePaginatedResult<CustomHostname>>

A single page of custom hostnames 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, UpdateCustomHostnameRequest, CancellationToken)

Updates an existing custom hostname.

public Task<CustomHostname> UpdateAsync(string zoneId, string customHostnameId, UpdateCustomHostnameRequest request, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

customHostnameId string

The ID of the custom hostname to update.

request UpdateCustomHostnameRequest

The request containing the fields to update.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<CustomHostname>

The updated custom hostname.

Remarks

This is a PATCH operation. Only the properties set in the request will be updated. Sending a PATCH request can also be used to refresh the validation status.

UpdateFallbackOriginAsync(string, UpdateFallbackOriginRequest, CancellationToken)

Updates the fallback origin for custom hostnames in the zone.

public Task<FallbackOrigin> UpdateFallbackOriginAsync(string zoneId, UpdateFallbackOriginRequest request, CancellationToken cancellationToken = default)

Parameters

zoneId string

The ID of the zone.

request UpdateFallbackOriginRequest

The request containing the new fallback origin.

cancellationToken CancellationToken

A cancellation token.

Returns

Task<FallbackOrigin>

The updated fallback origin configuration.