Skip to content

Cloudflare::API::Zones

NAME

Cloudflare::API::Zones - list and retrieve Cloudflare zones

SYNOPSIS

my $zones=$api->zones()->list(status => 'active');
my $zone=$api->zones()->get($zone_id);

DESCRIPTION

Zone lookups use the token configured on Cloudflare::API and do not require its default account ID. Worker routes are managed by Cloudflare::API::Workers using an explicit zone ID.

METHODS

  • list(%query) — List every visible zone. Named arguments become Cloudflare query parameters. The method follows all pages and returns one flat array reference; a large zone set can require many requests and substantial memory.
  • list_page(%query) — Return a lazy HTTP::API::Core::Pagination object for the zone list. Use next() to consume one zone at a time or all() to collect the remaining zones.
  • list_page_response(%query) — Make one list request and return the complete decoded Cloudflare response hash, including result_info when Cloudflare supplies it.
  • get($zone_id, %options) — Retrieve one zone by ID. Returns the decoded zone result. The ID is percent-encoded as a path component; full_response => 1 returns the complete decoded Cloudflare response.

ERRORS

See Cloudflare::API for HTTP, transport, Cloudflare response, and invalid path-component exceptions.

SEE ALSO

Cloudflare::API, Cloudflare::API::Workers

AUTHOR

Andrew Speer andrew.speer@isolutions.com.au

LICENSE and COPYRIGHT

Copyright (c) 2026 Andrew Speer. This software is free software under the same terms as Perl 5.