Package codes.thischwa.cf

Klasse CfDnsClient

java.lang.Object
codes.thischwa.cf.CfDnsClient
public class CfDnsClient extends Object
CfDnsClient is a client interface to interact with Cloudflare DNS service. It allows managing DNS records and zones within the Cloudflare system, including creating, updating, retrieving, and deleting DNS records.

Example: 


 // Create a new CfDnsClient instance
 CfDnsClient cfDnsClient = new CfDnsClient(
     "email@example.com",
     "yourApiKey"
 );

 // Retrieve a zone
 ZoneEntity zone = cfDnsClient.zoneInfo("example.com");
 System.out.println("Zone ID: " + zone.getId());

 // Retrieve records of a zone
 List<RecordEntity> records = cfDnsClient.sldListAll(zone, "sld");
 records.forEach(record ->
     System.out.println("Record Type: " + record.getType() + ", Value: " + record.getContent())
 );

  • Konstruktordetails

    • CfDnsClient

      public CfDnsClient(String authEmail, String authKey)
      Constructs a CfDnsClient instance for interacting with the Cloudflare DNS API.
      Parameter:
      authEmail - The email address associated with the Cloudflare account, used for authentication.
      authKey - The API key of the Cloudflare account, used as part of the authentication process.

    • CfDnsClient

      public CfDnsClient(String baseUrl, String authEmail, String authKey)
      Constructs a CfDnsClient instance for interacting with the Cloudflare DNS API.
      Parameter:
      baseUrl - The base URL of the Cloudflare API to be used for requests.
      authEmail - The email address associated with the Cloudflare account, used for authentication.
      authKey - The API key of the Cloudflare account, used as part of the authentication process.

    • CfDnsClient

      public CfDnsClient(boolean emptyResultThrowsException, String baseUrl, String authEmail, String authKey)
      Constructs a new instance of CfDnsClient, which facilitates interactions with the Cloudflare DNS API.
      Parameter:
      emptyResultThrowsException - Specifies if an exception should be thrown when the API response is empty. Default is true.
      baseUrl - The base URL for the Cloudflare API endpoint.
      authEmail - The email associated with the Cloudflare account for authentication.
      authKey - The API key for authenticating the client with Cloudflare services.

  • Methodendetails

    • zoneListAll

      public List<ZoneEntity> zoneListAll() throws CloudflareApiException
      Retrieves a list of all zones from the Cloudflare API.
      Gibt zurück:
      A list of ZoneEntity objects representing the zones retrieved from the Cloudflare API.
      Löst aus:
      CloudflareApiException - If an error occurs during the API request or response handling.

    • zoneListAll

      public List<ZoneEntity> zoneListAll(PagingRequest pagingRequest) throws CloudflareApiException
      Retrieves a list of all DNS zones using the provided paging request parameters.
      Parameter:
      pagingRequest - the pagination request object containing parameters for paging and filtering zone data
      Gibt zurück:
      a list of ZoneEntity objects representing the DNS zones retrieved from the API
      Löst aus:
      CloudflareApiException - if there is an error during the API request or response processing

    • zoneInfo

      public ZoneEntity zoneInfo(String name) throws CloudflareApiException
      Retrieves detailed information about a specific zone by its name.
      Parameter:
      name - The name of the zone to retrieve information for.
      Gibt zurück:
      A ZoneEntity object that contains details of the specified zone.
      Löst aus:
      CloudflareApiException - If an error occurs while making the API request or processing the response.

    • sldListAll

      public List<RecordEntity> sldListAll(ZoneEntity zone, String sld) throws CloudflareApiException
      Retrieves all record entities for a specific second-level domain (SLD) within a given DNS zone.
      Parameter:
      zone - The DNS zone entity for which the SLD records are to be fetched.
      sld - The second-level domain name for which the records are retrieved.
      Gibt zurück:
      A list of RecordEntity objects representing the DNS records associated with the provided SLD.
      Löst aus:
      CloudflareApiException - If an error occurs while interacting with the Cloudflare API.

    • sldListAll

      public List<RecordEntity> sldListAll(ZoneEntity zone, String sld, PagingRequest pagingRequest) throws CloudflareApiException
      Retrieves all record entities for a specific second-level domain (SLD) within a given DNS zone.
      Parameter:
      zone - The DNS zone entity for which the SLD records are to be fetched.
      sld - The second-level domain name for which the records are retrieved.
      pagingRequest - The paging request.
      Gibt zurück:
      A list of RecordEntity objects representing the DNS records associated with the provided SLD.
      Löst aus:
      CloudflareApiException - If an error occurs while interacting with the Cloudflare API.

    • sldInfo

      public RecordEntity sldInfo(ZoneEntity zone, String sld, RecordType type) throws CloudflareApiException
      Retrieves detailed information about a specific second-level domain (SLD) record for a given zone and record type from the Cloudflare API.
      Parameter:
      zone - the zone entity that contains information about the DNS zone
      sld - the second-level domain (SLD) for which the record information is requested
      type - the type of DNS record (e.g., A, AAAA, CNAME) being queried
      Gibt zurück:
      the record entity containing detailed information about the requested SLD and record type
      Löst aus:
      CloudflareApiException - if an error occurs during interaction with the Cloudflare API

    • recordCreate

      public RecordEntity recordCreate(ZoneEntity zone, String sld, int ttl, RecordType type, String content) throws CloudflareApiException
      Creates a DNS record in the specified DNS zone with the provided details.
      Parameter:
      zone - the DNS zone in which the record will be created
      sld - the second-level domain (SLD) used for constructing the fully qualified domain name (FQDN)
      ttl - the time-to-live (TTL) value for the DNS record
      type - the type of the DNS record (e.g., A, AAAA, CNAME)
      content - the content or value of the DNS record
      Gibt zurück:
      the created DNS record as a RecordEntity object
      Löst aus:
      CloudflareApiException - if an error occurs while interacting with the Cloudflare API

    • recordCreate

      public RecordEntity recordCreate(ZoneEntity zone, RecordEntity rec) throws CloudflareApiException
      Creates a new DNS record in the specified zone using the Cloudflare API.
      Parameter:
      zone - The zone entity where the record will be created. Contains details such as zone ID.
      rec - The record entity representing the DNS record to be created, including its attributes.
      Gibt zurück:
      The created record entity as returned by the Cloudflare API.
      Löst aus:
      CloudflareApiException - If an error occurs while interacting with the Cloudflare API.

    • recordDelete

      public boolean recordDelete(ZoneEntity zone, RecordEntity rec) throws CloudflareApiException
      Deletes a DNS record of the specified type within a given zone on the Cloudflare API.
      Parameter:
      zone - The zone entity that specifies the zone in which the record exists.
      rec - The record entity that represents the DNS record to be deleted.
      Gibt zurück:
      true if the DNS record was successfully deleted; false otherwise.
      Löst aus:
      CloudflareApiException - if there is an issue during the API communication or the request fails for any reason.

    • recordDelete

      public boolean recordDelete(ZoneEntity zone, String id) throws CloudflareApiException
      Deletes a DNS record of the specified type within a given zone on the Cloudflare API.
      Parameter:
      zone - The zone entity that specifies the zone in which the record exists.
      id - The record entity that represents the DNS record to be deleted.
      Gibt zurück:
      true if the DNS record was successfully deleted; false otherwise.
      Löst aus:
      CloudflareApiException - if there is an issue during the API communication or the request fails for any reason.

    • recordUpdate

      public RecordEntity recordUpdate(ZoneEntity zone, RecordEntity rec) throws CloudflareApiException
      Updates an existing DNS record in a specified Cloudflare zone.
      Parameter:
      zone - the zone entity containing the ID of the target zone
      rec - the record entity containing the ID of the DNS record to be updated and its updated data
      Gibt zurück:
      the updated record entity as returned by the Cloudflare API
      Löst aus:
      CloudflareApiException - if an error occurs while interacting with the Cloudflare API

    • recordDeleteTypeIfExists

      public void recordDeleteTypeIfExists(ZoneEntity zone, String sld, RecordType... recordTypes) throws CloudflareApiException
      Deletes DNS records of a specific type within a given zone if they exist. If no record of the specified type exists, it logs this occurrence without throwing an exception.
      Parameter:
      zone - The DNS zone entity in which the record exists.
      sld - The second-level domain for which the record is being checked.
      recordTypes - The types of DNS records that should be deleted, if they exist.
      Löst aus:
      CloudflareApiException - If an error occurs during API communication.