1# Terraform Data Sources Reference
2 
3Query existing Cloudflare resources to reference in your configurations.
4 
5## v5 Data Source Names
6 
7| v4 Name | v5 Name | Notes |
8|---------|---------|-------|
9| `cloudflare_record` | `cloudflare_dns_record` | |
10| `cloudflare_worker_script` | `cloudflare_workers_script` | Note: plural |
11| `cloudflare_access_*` | `cloudflare_zero_trust_*` | Access → Zero Trust |
12 
13## Zone Data Sources
14 
15```hcl
16# Get zone by name
17data "cloudflare_zone" "example" {
18  name = "example.com"
19}
20 
21# Use in resources
22resource "cloudflare_dns_record" "www" {
23  zone_id = data.cloudflare_zone.example.id
24  name = "www"
25  # ...
26}
27```
28 
29## Account Data Sources
30 
31```hcl
32# List all accounts
33data "cloudflare_accounts" "main" {
34  name = "My Account"
35}
36 
37# Use account ID
38resource "cloudflare_worker_script" "api" {
39  account_id = data.cloudflare_accounts.main.accounts[0].id
40  # ...
41}
42```
43 
44## Worker Data Sources
45 
46```hcl
47# Get existing worker script (v5: cloudflare_workers_script)
48data "cloudflare_workers_script" "existing" {
49  account_id = var.account_id
50  name = "existing-worker"
51}
52 
53# Reference in service bindings
54resource "cloudflare_workers_script" "consumer" {
55  service_binding {
56    name = "UPSTREAM"
57    service = data.cloudflare_workers_script.existing.name
58  }
59}
60```
61 
62## KV Data Sources
63 
64```hcl
65# Get KV namespace
66data "cloudflare_workers_kv_namespace" "existing" {
67  account_id = var.account_id
68  namespace_id = "abc123"
69}
70 
71# Use in worker binding
72resource "cloudflare_workers_script" "api" {
73  kv_namespace_binding {
74    name = "KV"
75    namespace_id = data.cloudflare_workers_kv_namespace.existing.id
76  }
77}
78```
79 
80## Lists Data Source
81 
82```hcl
83# Get IP lists for WAF rules
84data "cloudflare_list" "blocked_ips" {
85  account_id = var.account_id
86  name = "blocked_ips"
87}
88```
89 
90## IP Ranges Data Source
91 
92```hcl
93# Get Cloudflare IP ranges (for firewall rules)
94data "cloudflare_ip_ranges" "cloudflare" {}
95 
96output "ipv4_cidrs" {
97  value = data.cloudflare_ip_ranges.cloudflare.ipv4_cidr_blocks
98}
99 
100output "ipv6_cidrs" {
101  value = data.cloudflare_ip_ranges.cloudflare.ipv6_cidr_blocks
102}
103 
104# Use in security group rules (AWS example)
105resource "aws_security_group_rule" "allow_cloudflare" {
106  type = "ingress"
107  from_port = 443
108  to_port = 443
109  protocol = "tcp"
110  cidr_blocks = data.cloudflare_ip_ranges.cloudflare.ipv4_cidr_blocks
111  security_group_id = aws_security_group.web.id
112}
113```
114 
115## Common Patterns
116 
117### Import ID Formats
118 
119| Resource | Import ID Format |
120|----------|------------------|
121| `cloudflare_zone` | `<zone-id>` |
122| `cloudflare_dns_record` | `<zone-id>/<record-id>` |
123| `cloudflare_workers_script` | `<account-id>/<script-name>` |
124| `cloudflare_workers_kv_namespace` | `<account-id>/<namespace-id>` |
125| `cloudflare_r2_bucket` | `<account-id>/<bucket-name>` |
126| `cloudflare_d1_database` | `<account-id>/<database-id>` |
127| `cloudflare_pages_project` | `<account-id>/<project-name>` |
128 
129```bash
130# Example: Import DNS record
131terraform import cloudflare_dns_record.example <zone-id>/<record-id>
132```
133 
134### Reference Across Modules
135 
136```hcl
137# modules/worker/main.tf
138data "cloudflare_zone" "main" {
139  name = var.domain
140}
141 
142resource "cloudflare_worker_route" "api" {
143  zone_id = data.cloudflare_zone.main.id
144  pattern = "api.${var.domain}/*"
145  script_name = cloudflare_worker_script.api.name
146}
147```
148 
149### Output Important Values
150 
151```hcl
152output "zone_id" {
153  value = cloudflare_zone.main.id
154  description = "Zone ID for DNS management"
155}
156 
157output "worker_url" {
158  value = "https://${cloudflare_worker_domain.api.hostname}"
159  description = "Worker API endpoint"
160}
161 
162output "kv_namespace_id" {
163  value = cloudflare_workers_kv_namespace.app.id
164  sensitive = false
165}
166 
167output "name_servers" {
168  value = cloudflare_zone.main.name_servers
169  description = "Name servers for domain registration"
170}
171```
172 
173## See Also
174 
175- [README](./README.md) - Provider setup
176- [Configuration Reference](./configuration.md) - All resource types
177- [Patterns](./patterns.md) - Architecture patterns
178- [Troubleshooting](./gotchas.md) - Common issues
179