Python Cloudflare DNS A record create or update example
This is based on our previous post Python Cloudflare DNS A record update example but also creates the record if it doesn’t exist.
#!/usr/bin/env python3
import CloudFlare
import argparse
import sys
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("-e", "--email", required=True, help="The Cloudflare login email to use")
parser.add_argument("-n", "--hostname", required=True, help="The hostname to update, e.g. mydyndns.mydomain.com")
parser.add_argument("-k", "--api-key", required=True, help="The Cloudflare global API key to use. NOTE: Domain-specific API tokens will NOT work!")
parser.add_argument("-i", "--ip-address", required=True, help="Which IP address to update the record to")
parser.add_argument("-t", "--ttl", default=60, type=int, help="The TTL of the records in seconds (or 1 for auto)")
args = parser.parse_args()
# Initialize Cloudflare API client
cf = CloudFlare.CloudFlare(
email=args.email,
token=args.api_key
)
# Get zone ID (for the domain). This is why we need the API key and the domain API token won't be sufficient
zone = ".".join(args.hostname.split(".")[-2:]) # domain = test.mydomain.com => zone = mydomain.com
zones = cf.zones.get(params={"name": zone})
if len(zones) == 0:
print(f"Could not find CloudFlare zone {zone}, please check domain {args.hostname}")
sys.exit(2)
zone_id = zones[0]["id"]
# Fetch existing A record
a_records = cf.zones.dns_records.get(zone_id, params={"name": args.hostname, "type": "A"})
if len(a_records): # Have an existing record
print("Found existing record, updating...")
a_record = a_records[0]
# Update record & save to cloudflare
a_record["content"] = args.ip_address
cf.zones.dns_records.put(zone_id, a_record["id"], data=a_record)
else: # No existing record. Create !
print("Record doesn't existing, creating new record...")
a_record = {}
a_record["type"] = "A"
a_record["name"] = args.hostname
a_record["ttl"] = args.ttl # 1 == auto
a_record["content"] = args.ip_address
cf.zones.dns_records.post(zone_id, data=a_record)
Usage example:
./update-dns.py --api-key ... --email [email protected] --ttl 300 --ip 1.2.3.4 --hostname mysubdomain.domain.com