Skip to content

Commit a2955c5

Browse files
stainless-app[bot]stainless-bot
stainless-app[bot]
authored and
stainless-bot
committed
feat(api): OpenAPI spec update via Stainless API (#1190)
1 parent c309481 commit a2955c5

5 files changed

Lines changed: 84 additions & 22 deletions

File tree

‎.stats.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
11
configured_endpoints: 1256
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-8698fc16cc1cd7549c7f51bf3f3118b80e198b25fee1f20e4aaeb226608dafd1.yml
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-129ae207bac48d5f0a569cefeb5ff52209e7ef746666eb4e8f72aeb08a7748aa.yml

‎src/cloudflare/resources/dns/firewall/firewall.py‎

Lines changed: 32 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -89,11 +89,16 @@ def create(
8989
9090
ecs_fallback: Forward client IP (resolver) subnet if no EDNS Client Subnet is sent.
9191
92-
maximum_cache_ttl: Maximum DNS Cache TTL.
92+
maximum_cache_ttl: Maximum DNS cache TTL. This setting sets an upper bound on DNS TTLs for purposes
93+
of caching between DNS Firewall and the upstream servers. Higher TTLs will be
94+
decreased to the maximum defined here for caching purposes.
9395
94-
minimum_cache_ttl: Minimum DNS Cache TTL.
96+
minimum_cache_ttl: Minimum DNS cache TTL. This setting sets a lower bound on DNS TTLs for purposes
97+
of caching between DNS Firewall and the upstream servers. Lower TTLs will be
98+
increased to the minimum defined here for caching purposes.
9599
96-
negative_cache_ttl: Negative DNS Cache TTL.
100+
negative_cache_ttl: Negative DNS cache TTL. This setting controls how long DNS Firewall should cache
101+
negative responses (e.g., NXDOMAIN) from the upstream servers.
97102
98103
ratelimit: Ratelimit in queries per second per datacenter (applies to DNS queries sent to
99104
the upstream nameservers configured on the cluster).
@@ -272,15 +277,20 @@ def edit(
272277
273278
ecs_fallback: Forward client IP (resolver) subnet if no EDNS Client Subnet is sent.
274279
275-
maximum_cache_ttl: Maximum DNS Cache TTL.
280+
maximum_cache_ttl: Maximum DNS cache TTL. This setting sets an upper bound on DNS TTLs for purposes
281+
of caching between DNS Firewall and the upstream servers. Higher TTLs will be
282+
decreased to the maximum defined here for caching purposes.
276283
277-
minimum_cache_ttl: Minimum DNS Cache TTL.
284+
minimum_cache_ttl: Minimum DNS cache TTL. This setting sets a lower bound on DNS TTLs for purposes
285+
of caching between DNS Firewall and the upstream servers. Lower TTLs will be
286+
increased to the minimum defined here for caching purposes.
278287
279288
name: DNS Firewall Cluster Name.
280289
281290
attack_mitigation: Attack mitigation settings.
282291
283-
negative_cache_ttl: Negative DNS Cache TTL.
292+
negative_cache_ttl: Negative DNS cache TTL. This setting controls how long DNS Firewall should cache
293+
negative responses (e.g., NXDOMAIN) from the upstream servers.
284294
285295
ratelimit: Ratelimit in queries per second per datacenter (applies to DNS queries sent to
286296
the upstream nameservers configured on the cluster).
@@ -422,11 +432,16 @@ async def create(
422432
423433
ecs_fallback: Forward client IP (resolver) subnet if no EDNS Client Subnet is sent.
424434
425-
maximum_cache_ttl: Maximum DNS Cache TTL.
435+
maximum_cache_ttl: Maximum DNS cache TTL. This setting sets an upper bound on DNS TTLs for purposes
436+
of caching between DNS Firewall and the upstream servers. Higher TTLs will be
437+
decreased to the maximum defined here for caching purposes.
426438
427-
minimum_cache_ttl: Minimum DNS Cache TTL.
439+
minimum_cache_ttl: Minimum DNS cache TTL. This setting sets a lower bound on DNS TTLs for purposes
440+
of caching between DNS Firewall and the upstream servers. Lower TTLs will be
441+
increased to the minimum defined here for caching purposes.
428442
429-
negative_cache_ttl: Negative DNS Cache TTL.
443+
negative_cache_ttl: Negative DNS cache TTL. This setting controls how long DNS Firewall should cache
444+
negative responses (e.g., NXDOMAIN) from the upstream servers.
430445
431446
ratelimit: Ratelimit in queries per second per datacenter (applies to DNS queries sent to
432447
the upstream nameservers configured on the cluster).
@@ -605,15 +620,20 @@ async def edit(
605620
606621
ecs_fallback: Forward client IP (resolver) subnet if no EDNS Client Subnet is sent.
607622
608-
maximum_cache_ttl: Maximum DNS Cache TTL.
623+
maximum_cache_ttl: Maximum DNS cache TTL. This setting sets an upper bound on DNS TTLs for purposes
624+
of caching between DNS Firewall and the upstream servers. Higher TTLs will be
625+
decreased to the maximum defined here for caching purposes.
609626
610-
minimum_cache_ttl: Minimum DNS Cache TTL.
627+
minimum_cache_ttl: Minimum DNS cache TTL. This setting sets a lower bound on DNS TTLs for purposes
628+
of caching between DNS Firewall and the upstream servers. Lower TTLs will be
629+
increased to the minimum defined here for caching purposes.
611630
612631
name: DNS Firewall Cluster Name.
613632
614633
attack_mitigation: Attack mitigation settings.
615634
616-
negative_cache_ttl: Negative DNS Cache TTL.
635+
negative_cache_ttl: Negative DNS cache TTL. This setting controls how long DNS Firewall should cache
636+
negative responses (e.g., NXDOMAIN) from the upstream servers.
617637
618638
ratelimit: Ratelimit in queries per second per datacenter (applies to DNS queries sent to
619639
the upstream nameservers configured on the cluster).

‎src/cloudflare/types/dns/firewall/firewall.py‎

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,20 @@ class Firewall(BaseModel):
2424
"""Forward client IP (resolver) subnet if no EDNS Client Subnet is sent."""
2525

2626
maximum_cache_ttl: float
27-
"""Maximum DNS Cache TTL."""
27+
"""Maximum DNS cache TTL.
28+
29+
This setting sets an upper bound on DNS TTLs for purposes of caching between DNS
30+
Firewall and the upstream servers. Higher TTLs will be decreased to the maximum
31+
defined here for caching purposes.
32+
"""
2833

2934
minimum_cache_ttl: float
30-
"""Minimum DNS Cache TTL."""
35+
"""Minimum DNS cache TTL.
36+
37+
This setting sets a lower bound on DNS TTLs for purposes of caching between DNS
38+
Firewall and the upstream servers. Lower TTLs will be increased to the minimum
39+
defined here for caching purposes.
40+
"""
3141

3242
modified_on: datetime
3343
"""Last modification of DNS Firewall cluster."""
@@ -41,7 +51,11 @@ class Firewall(BaseModel):
4151
"""Attack mitigation settings."""
4252

4353
negative_cache_ttl: Optional[float] = None
44-
"""Negative DNS Cache TTL."""
54+
"""Negative DNS cache TTL.
55+
56+
This setting controls how long DNS Firewall should cache negative responses
57+
(e.g., NXDOMAIN) from the upstream servers.
58+
"""
4559

4660
ratelimit: Optional[float] = None
4761
"""

‎src/cloudflare/types/dns/firewall_create_params.py‎

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,27 @@ class FirewallCreateParams(TypedDict, total=False):
3030
"""Forward client IP (resolver) subnet if no EDNS Client Subnet is sent."""
3131

3232
maximum_cache_ttl: float
33-
"""Maximum DNS Cache TTL."""
33+
"""Maximum DNS cache TTL.
34+
35+
This setting sets an upper bound on DNS TTLs for purposes of caching between DNS
36+
Firewall and the upstream servers. Higher TTLs will be decreased to the maximum
37+
defined here for caching purposes.
38+
"""
3439

3540
minimum_cache_ttl: float
36-
"""Minimum DNS Cache TTL."""
41+
"""Minimum DNS cache TTL.
42+
43+
This setting sets a lower bound on DNS TTLs for purposes of caching between DNS
44+
Firewall and the upstream servers. Lower TTLs will be increased to the minimum
45+
defined here for caching purposes.
46+
"""
3747

3848
negative_cache_ttl: Optional[float]
39-
"""Negative DNS Cache TTL."""
49+
"""Negative DNS cache TTL.
50+
51+
This setting controls how long DNS Firewall should cache negative responses
52+
(e.g., NXDOMAIN) from the upstream servers.
53+
"""
4054

4155
ratelimit: Optional[float]
4256
"""

‎src/cloudflare/types/dns/firewall_edit_params.py‎

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,20 @@ class FirewallEditParams(TypedDict, total=False):
2828
"""Forward client IP (resolver) subnet if no EDNS Client Subnet is sent."""
2929

3030
maximum_cache_ttl: Required[float]
31-
"""Maximum DNS Cache TTL."""
31+
"""Maximum DNS cache TTL.
32+
33+
This setting sets an upper bound on DNS TTLs for purposes of caching between DNS
34+
Firewall and the upstream servers. Higher TTLs will be decreased to the maximum
35+
defined here for caching purposes.
36+
"""
3237

3338
minimum_cache_ttl: Required[float]
34-
"""Minimum DNS Cache TTL."""
39+
"""Minimum DNS cache TTL.
40+
41+
This setting sets a lower bound on DNS TTLs for purposes of caching between DNS
42+
Firewall and the upstream servers. Lower TTLs will be increased to the minimum
43+
defined here for caching purposes.
44+
"""
3545

3646
name: Required[str]
3747
"""DNS Firewall Cluster Name."""
@@ -42,7 +52,11 @@ class FirewallEditParams(TypedDict, total=False):
4252
"""Attack mitigation settings."""
4353

4454
negative_cache_ttl: Optional[float]
45-
"""Negative DNS Cache TTL."""
55+
"""Negative DNS cache TTL.
56+
57+
This setting controls how long DNS Firewall should cache negative responses
58+
(e.g., NXDOMAIN) from the upstream servers.
59+
"""
4660

4761
ratelimit: Optional[float]
4862
"""

0 commit comments

Comments
 (0)