Generated v10.0.0

Author: github-actions

CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [v10.0.0](https://github.com/fastly/fastly-py/releases/tag/release/v10.0.0) (2025-06-11)
+
+**Breaking Changes:**
+
+- removed(properties): Remove logging placement value `waf_debug`.
+
+
+**Bug fixes:**
+
+- fix(backend): Marked `prefer_ipv6` as nullable.
+
+
+**Enhancements:**
+
+- feat(historical): The following Next-Gen WAF metrics have been updated to include both Edge WAF and
+-                   Core WAF counts:`ngwaf_requests_total_count`, `ngwaf_requests_blocked_count`,
+
+
+**Documentation:**
+
+- doc(domain-discovery): Correct documentation of valid values of `scope` query parameter.
+- doc(observability-aggregations-for-logs): Correct documentation of valid values of `log-aggregations-filter` query
+                                            parameter.
+- doc(backend): Tweak language of `prefer_ipv6` description.
+- doc(service): Add documentation for `filter[versions.active]` query parameter when getting detailed information on
+                a specified service.
+
+
 ## [v9.0.0](https://github.com/fastly/fastly-py/releases/tag/release/v9.0.0) (2025-05-12)
 
 **Breaking Changes:**

README.md

@@ -639,26 +639,39 @@ The fastly-py API client currently does not support the following endpoints:
 - [`/domains/v1/tools/suggest`](https://www.fastly.com/documentation/reference/api/) (GET)
 - [`/domains/v1/{domain_id}`](https://www.fastly.com/documentation/reference/api/) (DELETE, GET, PATCH)
 - [`/domains/v1`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
+- [`/ngwaf/v1/workspaces/{workspace_id}/events/{event_id}`](https://www.fastly.com/documentation/reference/api/ngwaf/events) (GET, PATCH)
+- [`/ngwaf/v1/workspaces/{workspace_id}/events`](https://www.fastly.com/documentation/reference/api/ngwaf/events) (GET)
+- [`/ngwaf/v1/workspaces/{workspace_id}/redactions/{redaction_id}`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/redactions) (DELETE, GET, PATCH)
+- [`/ngwaf/v1/workspaces/{workspace_id}/redactions`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/redactions) (GET, POST)
+- [`/ngwaf/v1/workspaces/{workspace_id}/requests/{request_id}`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/requests) (GET)
+- [`/ngwaf/v1/workspaces/{workspace_id}/requests`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/requests) (GET)
+- [`/ngwaf/v1/workspaces/{workspace_id}/rules/{rule_id}`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/rules) (DELETE, GET, PATCH)
+- [`/ngwaf/v1/workspaces/{workspace_id}/rules`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/rules) (GET, POST)
+- [`/ngwaf/v1/workspaces/{workspace_id}/timeseries`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/timeseries) (GET)
+- [`/ngwaf/v1/workspaces/{workspace_id}/virtual-patches/{virtual_patch_id}`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/virtual-patches) (GET, PATCH)
+- [`/ngwaf/v1/workspaces/{workspace_id}/virtual-patches`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/virtual-patches) (GET)
+- [`/ngwaf/v1/workspaces/{workspace_id}`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/workspaces) (DELETE, GET, PATCH)
+- [`/ngwaf/v1/workspaces`](https://www.fastly.com/documentation/reference/api/ngwaf/v1/workspaces) (GET, POST)
 - [`/notifications/integration-types`](https://developer.fastly.com/reference/api/observability/notification) (GET)
 - [`/notifications/integrations/{integration_id}/rotateSigningKey`](https://developer.fastly.com/reference/api/observability/notification) (POST)
 - [`/notifications/integrations/{integration_id}/signingKey`](https://developer.fastly.com/reference/api/observability/notification) (GET)
 - [`/notifications/integrations/{integration_id}`](https://developer.fastly.com/reference/api/observability/notification) (DELETE, GET, PATCH)
 - [`/notifications/integrations`](https://developer.fastly.com/reference/api/observability/notification) (GET, POST)
 - [`/notifications/mailinglist-confirmations`](https://developer.fastly.com/reference/api/observability/notification) (POST)
 - [`/resources/stores/kv/{store_id}/batch`](https://www.fastly.com/documentation/reference/api/services/resources/kv-store-item) (PUT)
-- [`/security/workspaces/{workspace_id}/events/{event_id}`](https://docs.fastly.com/en/ngwaf/) (GET, PATCH)
-- [`/security/workspaces/{workspace_id}/events`](https://docs.fastly.com/en/ngwaf/) (GET)
-- [`/security/workspaces/{workspace_id}/redactions/{redaction_id}`](https://docs.fastly.com/en/ngwaf/) (DELETE, GET, PATCH)
-- [`/security/workspaces/{workspace_id}/redactions`](https://docs.fastly.com/en/ngwaf/) (GET, POST)
-- [`/security/workspaces/{workspace_id}/requests/{request_id}`](https://docs.fastly.com/en/ngwaf/) (GET)
-- [`/security/workspaces/{workspace_id}/requests`](https://docs.fastly.com/en/ngwaf/) (GET)
-- [`/security/workspaces/{workspace_id}/rules/{rule_id}`](https://docs.fastly.com/en/ngwaf/) (DELETE, GET, PATCH)
-- [`/security/workspaces/{workspace_id}/rules`](https://docs.fastly.com/en/ngwaf/) (GET, POST)
-- [`/security/workspaces/{workspace_id}/timeseries`](https://docs.fastly.com/en/ngwaf/) (GET)
-- [`/security/workspaces/{workspace_id}/virtual-patches/{virtual_patch_id}`](https://docs.fastly.com/en/ngwaf/) (GET, PATCH)
-- [`/security/workspaces/{workspace_id}/virtual-patches`](https://docs.fastly.com/en/ngwaf/) (GET)
-- [`/security/workspaces/{workspace_id}`](https://docs.fastly.com/en/ngwaf/) (DELETE, GET, PATCH)
-- [`/security/workspaces`](https://docs.fastly.com/en/ngwaf/) (GET, POST)
+- [`/security/workspaces/{workspace_id}/events/{event_id}`](https://www.fastly.com/documentation/reference/api/security/events) (GET, PATCH)
+- [`/security/workspaces/{workspace_id}/events`](https://www.fastly.com/documentation/reference/api/security/events) (GET)
+- [`/security/workspaces/{workspace_id}/redactions/{redaction_id}`](https://www.fastly.com/documentation/reference/api/security/redactions) (DELETE, GET, PATCH)
+- [`/security/workspaces/{workspace_id}/redactions`](https://www.fastly.com/documentation/reference/api/security/redactions) (GET, POST)
+- [`/security/workspaces/{workspace_id}/requests/{request_id}`](https://www.fastly.com/documentation/reference/api/security/requests) (GET)
+- [`/security/workspaces/{workspace_id}/requests`](https://www.fastly.com/documentation/reference/api/security/requests) (GET)
+- [`/security/workspaces/{workspace_id}/rules/{rule_id}`](https://www.fastly.com/documentation/reference/api/security/rules) (DELETE, GET, PATCH)
+- [`/security/workspaces/{workspace_id}/rules`](https://www.fastly.com/documentation/reference/api/security/rules) (GET, POST)
+- [`/security/workspaces/{workspace_id}/timeseries`](https://www.fastly.com/documentation/reference/api/security/timeseries) (GET)
+- [`/security/workspaces/{workspace_id}/virtual-patches/{virtual_patch_id}`](https://www.fastly.com/documentation/reference/api/security/virtual-patches) (GET, PATCH)
+- [`/security/workspaces/{workspace_id}/virtual-patches`](https://www.fastly.com/documentation/reference/api/security/virtual-patches) (GET)
+- [`/security/workspaces/{workspace_id}`](https://www.fastly.com/documentation/reference/api/security/workspaces) (DELETE, GET, PATCH)
+- [`/security/workspaces`](https://www.fastly.com/documentation/reference/api/security/workspaces) (GET, POST)
 - [`/tls/activations/{tls_activation_id}`](https://www.fastly.com/documentation/reference/api/tls/mutual-tls/activations) (GET, PATCH)
 - [`/tls/activations`](https://www.fastly.com/documentation/reference/api/tls/mutual-tls/activations) (GET)
 - [`/tls/configurations/{tls_configuration_id}`](https://www.fastly.com/documentation/reference/api/) (DELETE, GET, PATCH)

docs/Backend.md

@@ -22,7 +22,7 @@ Name | Type | Description | Notes
 **name** | **str** | The name of the backend. | [optional] 
 **override_host** | **str, none_type** | If set, will replace the client-supplied HTTP `Host` header on connections to this backend. Applied after VCL has been processed, so this setting will take precedence over changing `bereq.http.Host` in VCL. | [optional] 
 **port** | **int** | Port on which the backend server is listening for connections from Fastly. Setting `port` to 80 or 443 will also set `use_ssl` automatically (to false and true respectively), unless explicitly overridden by setting `use_ssl` in the same request. | [optional] 
-**prefer_ipv6** | **bool** | Prefer IPv6 connections for DNS hostname lookups. | [optional] 
+**prefer_ipv6** | **bool, none_type** | Prefer IPv6 connections to origins for hostname backends. | [optional] 
 **request_condition** | **str** | Name of a Condition, which if satisfied, will select this backend during a request. If set, will override any `auto_loadbalance` setting. By default, the first backend added to a service is selected for all requests. | [optional] 
 **share_key** | **str, none_type** | Value that when shared across backends will enable those backends to share the same health check. | [optional] 
 **shield** | **str, none_type** | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). | [optional] 

docs/BackendApi.md

@@ -70,7 +70,7 @@ with fastly.ApiClient(configuration) as api_client:
     name = "test-backend" # str | The name of the backend. (optional)
     override_host = "override_host_example" # str, none_type | If set, will replace the client-supplied HTTP `Host` header on connections to this backend. Applied after VCL has been processed, so this setting will take precedence over changing `bereq.http.Host` in VCL. (optional)
     port = 1 # int | Port on which the backend server is listening for connections from Fastly. Setting `port` to 80 or 443 will also set `use_ssl` automatically (to false and true respectively), unless explicitly overridden by setting `use_ssl` in the same request. (optional)
-    prefer_ipv6 = True # bool | Prefer IPv6 connections for DNS hostname lookups. (optional)
+    prefer_ipv6 = True # bool, none_type | Prefer IPv6 connections to origins for hostname backends. (optional)
     request_condition = "request_condition_example" # str | Name of a Condition, which if satisfied, will select this backend during a request. If set, will override any `auto_loadbalance` setting. By default, the first backend added to a service is selected for all requests. (optional)
     share_key = "C" # str, none_type | Value that when shared across backends will enable those backends to share the same health check. (optional)
     shield = "shield_example" # str, none_type | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). (optional)
@@ -132,7 +132,7 @@ Name | Type | Description  | Notes
  **name** | **str**| The name of the backend. | [optional]
  **override_host** | **str, none_type**| If set, will replace the client-supplied HTTP `Host` header on connections to this backend. Applied after VCL has been processed, so this setting will take precedence over changing `bereq.http.Host` in VCL. | [optional]
  **port** | **int**| Port on which the backend server is listening for connections from Fastly. Setting `port` to 80 or 443 will also set `use_ssl` automatically (to false and true respectively), unless explicitly overridden by setting `use_ssl` in the same request. | [optional]
- **prefer_ipv6** | **bool**| Prefer IPv6 connections for DNS hostname lookups. | [optional]
+ **prefer_ipv6** | **bool, none_type**| Prefer IPv6 connections to origins for hostname backends. | [optional]
  **request_condition** | **str**| Name of a Condition, which if satisfied, will select this backend during a request. If set, will override any `auto_loadbalance` setting. By default, the first backend added to a service is selected for all requests. | [optional]
  **share_key** | **str, none_type**| Value that when shared across backends will enable those backends to share the same health check. | [optional]
  **shield** | **str, none_type**| Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). | [optional]
@@ -476,7 +476,7 @@ with fastly.ApiClient(configuration) as api_client:
     name = "test-backend" # str | The name of the backend. (optional)
     override_host = "override_host_example" # str, none_type | If set, will replace the client-supplied HTTP `Host` header on connections to this backend. Applied after VCL has been processed, so this setting will take precedence over changing `bereq.http.Host` in VCL. (optional)
     port = 1 # int | Port on which the backend server is listening for connections from Fastly. Setting `port` to 80 or 443 will also set `use_ssl` automatically (to false and true respectively), unless explicitly overridden by setting `use_ssl` in the same request. (optional)
-    prefer_ipv6 = True # bool | Prefer IPv6 connections for DNS hostname lookups. (optional)
+    prefer_ipv6 = True # bool, none_type | Prefer IPv6 connections to origins for hostname backends. (optional)
     request_condition = "request_condition_example" # str | Name of a Condition, which if satisfied, will select this backend during a request. If set, will override any `auto_loadbalance` setting. By default, the first backend added to a service is selected for all requests. (optional)
     share_key = "C" # str, none_type | Value that when shared across backends will enable those backends to share the same health check. (optional)
     shield = "shield_example" # str, none_type | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). (optional)
@@ -539,7 +539,7 @@ Name | Type | Description  | Notes
  **name** | **str**| The name of the backend. | [optional]
  **override_host** | **str, none_type**| If set, will replace the client-supplied HTTP `Host` header on connections to this backend. Applied after VCL has been processed, so this setting will take precedence over changing `bereq.http.Host` in VCL. | [optional]
  **port** | **int**| Port on which the backend server is listening for connections from Fastly. Setting `port` to 80 or 443 will also set `use_ssl` automatically (to false and true respectively), unless explicitly overridden by setting `use_ssl` in the same request. | [optional]
- **prefer_ipv6** | **bool**| Prefer IPv6 connections for DNS hostname lookups. | [optional]
+ **prefer_ipv6** | **bool, none_type**| Prefer IPv6 connections to origins for hostname backends. | [optional]
  **request_condition** | **str**| Name of a Condition, which if satisfied, will select this backend during a request. If set, will override any `auto_loadbalance` setting. By default, the first backend added to a service is selected for all requests. | [optional]
  **share_key** | **str, none_type**| Value that when shared across backends will enable those backends to share the same health check. | [optional]
  **shield** | **str, none_type**| Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). | [optional]

docs/BackendResponse.md

@@ -22,7 +22,7 @@ Name | Type | Description | Notes
 **name** | **str** | The name of the backend. | [optional] 
 **override_host** | **str, none_type** | If set, will replace the client-supplied HTTP `Host` header on connections to this backend. Applied after VCL has been processed, so this setting will take precedence over changing `bereq.http.Host` in VCL. | [optional] 
 **port** | **int** | Port on which the backend server is listening for connections from Fastly. Setting `port` to 80 or 443 will also set `use_ssl` automatically (to false and true respectively), unless explicitly overridden by setting `use_ssl` in the same request. | [optional] 
-**prefer_ipv6** | **bool** | Prefer IPv6 connections for DNS hostname lookups. | [optional] 
+**prefer_ipv6** | **bool, none_type** | Prefer IPv6 connections to origins for hostname backends. | [optional] 
 **request_condition** | **str** | Name of a Condition, which if satisfied, will select this backend during a request. If set, will override any `auto_loadbalance` setting. By default, the first backend added to a service is selected for all requests. | [optional] 
 **share_key** | **str, none_type** | Value that when shared across backends will enable those backends to share the same health check. | [optional] 
 **shield** | **str, none_type** | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). | [optional] 

docs/LoggingPlacement.md

@@ -5,7 +5,7 @@ Where in the generated VCL the logging call should be placed. If not set, endpoi
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**value** | **str** | Where in the generated VCL the logging call should be placed. If not set, endpoints with `format_version` of 2 are placed in `vcl_log` and those with `format_version` of 1 are placed in `vcl_deliver`.  |  must be one of ["none", "waf_debug", "null", ]
+**value** | **str** | Where in the generated VCL the logging call should be placed. If not set, endpoints with `format_version` of 2 are placed in `vcl_log` and those with `format_version` of 1 are placed in `vcl_deliver`.  |  must be one of ["none", "null", ]
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/Results.md

@@ -268,9 +268,9 @@ Name | Type | Description | Notes
 **compute_cache_operations_count** | **int** | Number of cache operations executed by the Compute platform. | [optional] 
 **ngwaf_requests_total_count** | **int** | Total number of Next-Gen WAF (Edge WAF & Core WAF) requests. | [optional] 
 **ngwaf_requests_unknown_count** | **int** | Count of Edge WAF requests with an unknown outcome. | [optional] 
-**ngwaf_requests_allowed_count** | **int** | Count of Edge WAF requests allowed. | [optional] 
+**ngwaf_requests_allowed_count** | **int** | Count of Next-Gen WAF (Edge WAF & Core WAF) requests allowed. | [optional] 
 **ngwaf_requests_logged_count** | **int** | Count of Edge WAF requests logged. | [optional] 
-**ngwaf_requests_blocked_count** | **int** | Count of Edge WAF requests blocked. | [optional] 
+**ngwaf_requests_blocked_count** | **int** | Count of Next-Gen WAF (Edge WAF & Core WAF) requests blocked. | [optional] 
 **ngwaf_requests_timeout_count** | **int** | Count of Edge WAF requests timed outcome. | [optional] 
 **ngwaf_requests_challenged_count** | **int** | Count of Edge WAF requests challenged. | [optional] 
 **service_id** | **str** |  | [optional] [readonly] 

docs/ServiceApi.md

@@ -297,6 +297,7 @@ with fastly.ApiClient(configuration) as api_client:
     api_instance = service_api.ServiceApi(api_client)
     service_id = "SU1Z0isxPaozGVKXdv0eY" # str | Alphanumeric string identifying the service.
     version = NumberVersion(1) # NumberVersion | Number identifying a version of the service. (optional)
+    filter_versions_active = True # bool | Limits the versions array to the active versions. Accepts `true` or `false` (defaults to false). (optional)
 
     # example passing only required values which don't have defaults set
     try:
@@ -310,7 +311,7 @@ with fastly.ApiClient(configuration) as api_client:
     # and optional values
     try:
         # Get service details
-        api_response = api_instance.get_service_detail(service_id, version=version)
+        api_response = api_instance.get_service_detail(service_id, version=version, filter_versions_active=filter_versions_active)
         pprint(api_response)
     except fastly.ApiException as e:
         print("Exception when calling ServiceApi->get_service_detail: %s\n" % e)
@@ -323,6 +324,7 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **service_id** | **str**| Alphanumeric string identifying the service. |
  **version** | **NumberVersion**| Number identifying a version of the service. | [optional]
+ **filter_versions_active** | **bool**| Limits the versions array to the active versions. Accepts `true` or `false` (defaults to false). | [optional]
 
 ### Return type
 

fastly/__init__.py

@@ -10,7 +10,7 @@
 """
 
 
-__version__ = "9.0.0"
+__version__ = "10.0.0"
 
 # import ApiClient
 from fastly.api_client import ApiClient