Generated v9.0.0

Author: github-actions

CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [v9.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v9.0.0) (2025-05-12)
+
+**Breaking Changes:**
+
+- deprecated(user): The POST /user endpoint has been deprecated.
+
+- fix(acls_in_compute): Corrected the successful `PATCH` response code from the `/resources/acls/${acl_id}/entries` endpoint.
+
+
+**Enhancements:**
+
+- feat(products): Add endpoint to each service-level product to list services that enable that product.
+- feat(observability-aggregations-for-logs): Add new Observability Aggregations API for Logs.
+- feat(observability-timeseries-for-logs): Add new Observability Timeseries API for Logs.
+- feat(pops): Add new Mexico regions.
+- feat(historical): Add new Mexico regions.
+- feat(ddos-protection): Add `ddos-protection` product.
+- feat(backend): Add the `prefer_ipv6` option to prefer IPv6 during a backend DNS hostname lookup.
+- feat(products): Added new GET endpoint for all services with product enabled on a customer.
+
+**Documentation:**
+
+- doc(kv-store): Add clarification on valid KV Store names.
+- doc(kv-store-item): Add clarification on valid KV Store keys.
+- doc(dictionary): Usages of `edge dictionary` standardized to `dictionary`.
+- doc(acls-in-compute): Add documentation on how to remove a single ACL entry using the existing
+                        `compute-acl-update-acls` operation.
+- doc(acls-in-compute): Correct documentation on `action` field of `compute-acl-update-acls` endpoint.
+
 ## [v8.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v8.0.0) (2025-03-13)
 
 **Breaking Changes:**

README.md

@@ -239,7 +239,7 @@ Name | Type | Description  | Notes
 computeAclUpdateAcls($options) // Update an ACL
 ```
 
-Update an ACL.
+Update an ACL entry with a new operation or action, this allows you to modify an existing entry or delete it.
 
 ### Example
 ```php

docs/Api/AclsInComputeApi.md

@@ -54,6 +54,7 @@ $options['min_tls_version'] = 'min_tls_version_example'; // string | Minimum all
 $options['name'] = 'name_example'; // string | The name of the backend.
 $options['override_host'] = 'override_host_example'; // string | 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.
 $options['port'] = 56; // 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.
+$options['prefer_ipv6'] = True; // bool | Prefer IPv6 connections for DNS hostname lookups.
 $options['request_condition'] = 'request_condition_example'; // string | 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.
 $options['share_key'] = 'share_key_example'; // string | Value that when shared across backends will enable those backends to share the same health check.
 $options['shield'] = 'shield_example'; // string | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding).
@@ -105,6 +106,7 @@ Name | Type | Description  | Notes
 **name** | **string** | The name of the backend. | [optional]
 **override_host** | **string** | 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]
 **request_condition** | **string** | 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** | **string** | Value that when shared across backends will enable those backends to share the same health check. | [optional]
 **shield** | **string** | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). | [optional]
@@ -273,6 +275,7 @@ $options['min_tls_version'] = 'min_tls_version_example'; // string | Minimum all
 $options['name'] = 'name_example'; // string | The name of the backend.
 $options['override_host'] = 'override_host_example'; // string | 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.
 $options['port'] = 56; // 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.
+$options['prefer_ipv6'] = True; // bool | Prefer IPv6 connections for DNS hostname lookups.
 $options['request_condition'] = 'request_condition_example'; // string | 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.
 $options['share_key'] = 'share_key_example'; // string | Value that when shared across backends will enable those backends to share the same health check.
 $options['shield'] = 'shield_example'; // string | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding).
@@ -325,6 +328,7 @@ Name | Type | Description  | Notes
 **name** | **string** | The name of the backend. | [optional]
 **override_host** | **string** | 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]
 **request_condition** | **string** | 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** | **string** | Value that when shared across backends will enable those backends to share the same health check. | [optional]
 **shield** | **string** | Identifier of the POP to use as a [shield](https://docs.fastly.com/en/guides/shielding). | [optional]

docs/Api/BackendApi.md

@@ -0,0 +1,211 @@
+# Fastly\Api\DdosProtectionApi
+
+
+```php
+$apiInstance = new Fastly\Api\DdosProtectionApi(
+    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
+    // This is optional, `GuzzleHttp\Client` will be used as default.
+    new GuzzleHttp\Client(),
+    $config
+);
+```
+
+## Methods
+
+> [!NOTE]
+> All URIs are relative to `https://api.fastly.com`
+
+Method | HTTP request | Description
+------ | ------------ | -----------
+[**ddosProtectionEventGet()**](DdosProtectionApi.md#ddosProtectionEventGet) | **GET** /ddos-protection/v1/events/{event_id} | Get event by ID
+[**ddosProtectionEventList()**](DdosProtectionApi.md#ddosProtectionEventList) | **GET** /ddos-protection/v1/events | Get events
+[**ddosProtectionEventRuleList()**](DdosProtectionApi.md#ddosProtectionEventRuleList) | **GET** /ddos-protection/v1/events/{event_id}/rules | Get all rules for an event
+[**ddosProtectionRuleGet()**](DdosProtectionApi.md#ddosProtectionRuleGet) | **GET** /ddos-protection/v1/rules/{rule_id} | Get a rule by ID
+[**ddosProtectionTrafficStatsRuleGet()**](DdosProtectionApi.md#ddosProtectionTrafficStatsRuleGet) | **GET** /ddos-protection/v1/events/{event_id}/rules/{rule_id}/traffic-stats | Get traffic stats for a rule
+
+
+## `ddosProtectionEventGet()`
+
+```php
+ddosProtectionEventGet($options): \Fastly\Model\DdosProtectionEvent // Get event by ID
+```
+
+Get event by ID.
+
+### Example
+```php
+    $options['event_id'] = 'event_id_example'; // string | Unique ID of the event.
+
+try {
+    $result = $apiInstance->ddosProtectionEventGet($options);
+} catch (Exception $e) {
+    echo 'Exception when calling DdosProtectionApi->ddosProtectionEventGet: ', $e->getMessage(), PHP_EOL;
+}
+```
+
+### Options
+
+Note: the input parameter is an associative array with the keys listed below.
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**event_id** | **string** | Unique ID of the event. |
+
+### Return type
+
+[**\Fastly\Model\DdosProtectionEvent**](../Model/DdosProtectionEvent.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+
+## `ddosProtectionEventList()`
+
+```php
+ddosProtectionEventList($options): \Fastly\Model\InlineResponse2002 // Get events
+```
+
+Get events.
+
+### Example
+```php
+    $options['cursor'] = 'cursor_example'; // string | Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
+$options['limit'] = 20; // int | Limit how many results are returned.
+$options['service_id'] = 'service_id_example'; // string | Filter results based on a service_id.
+$options['from'] = 2023-01-01T02:30Z; // \DateTime | Represents the start of a date-time range expressed in RFC 3339 format.
+$options['to'] = 2023-01-01T02:30Z; // \DateTime | Represents the end of a date-time range expressed in RFC 3339 format.
+$options['name'] = 'name_example'; // string
+
+try {
+    $result = $apiInstance->ddosProtectionEventList($options);
+} catch (Exception $e) {
+    echo 'Exception when calling DdosProtectionApi->ddosProtectionEventList: ', $e->getMessage(), PHP_EOL;
+}
+```
+
+### Options
+
+Note: the input parameter is an associative array with the keys listed below.
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**cursor** | **string** | Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty. | [optional]
+**limit** | **int** | Limit how many results are returned. | [optional] [defaults to 20]
+**service_id** | **string** | Filter results based on a service_id. | [optional]
+**from** | **\DateTime** | Represents the start of a date-time range expressed in RFC 3339 format. | [optional]
+**to** | **\DateTime** | Represents the end of a date-time range expressed in RFC 3339 format. | [optional]
+**name** | **string** |  | [optional]
+
+### Return type
+
+[**\Fastly\Model\InlineResponse2002**](../Model/InlineResponse2002.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+
+## `ddosProtectionEventRuleList()`
+
+```php
+ddosProtectionEventRuleList($options): \Fastly\Model\InlineResponse2003 // Get all rules for an event
+```
+
+Get all rules for an event.
+
+### Example
+```php
+    $options['event_id'] = 'event_id_example'; // string | Unique ID of the event.
+$options['cursor'] = 'cursor_example'; // string | Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
+$options['limit'] = 20; // int | Limit how many results are returned.
+
+try {
+    $result = $apiInstance->ddosProtectionEventRuleList($options);
+} catch (Exception $e) {
+    echo 'Exception when calling DdosProtectionApi->ddosProtectionEventRuleList: ', $e->getMessage(), PHP_EOL;
+}
+```
+
+### Options
+
+Note: the input parameter is an associative array with the keys listed below.
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**event_id** | **string** | Unique ID of the event. |
+**cursor** | **string** | Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty. | [optional]
+**limit** | **int** | Limit how many results are returned. | [optional] [defaults to 20]
+
+### Return type
+
+[**\Fastly\Model\InlineResponse2003**](../Model/InlineResponse2003.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+
+## `ddosProtectionRuleGet()`
+
+```php
+ddosProtectionRuleGet($options): \Fastly\Model\DdosProtectionRule // Get a rule by ID
+```
+
+Get a rule by ID.
+
+### Example
+```php
+    $options['rule_id'] = 'rule_id_example'; // string | Unique ID of the rule.
+
+try {
+    $result = $apiInstance->ddosProtectionRuleGet($options);
+} catch (Exception $e) {
+    echo 'Exception when calling DdosProtectionApi->ddosProtectionRuleGet: ', $e->getMessage(), PHP_EOL;
+}
+```
+
+### Options
+
+Note: the input parameter is an associative array with the keys listed below.
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**rule_id** | **string** | Unique ID of the rule. |
+
+### Return type
+
+[**\Fastly\Model\DdosProtectionRule**](../Model/DdosProtectionRule.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+
+## `ddosProtectionTrafficStatsRuleGet()`
+
+```php
+ddosProtectionTrafficStatsRuleGet($options): \Fastly\Model\DdosProtectionTrafficStats // Get traffic stats for a rule
+```
+
+Get traffic stats for a rule.
+
+### Example
+```php
+    $options['event_id'] = 'event_id_example'; // string | Unique ID of the event.
+$options['rule_id'] = 'rule_id_example'; // string | Unique ID of the rule.
+
+try {
+    $result = $apiInstance->ddosProtectionTrafficStatsRuleGet($options);
+} catch (Exception $e) {
+    echo 'Exception when calling DdosProtectionApi->ddosProtectionTrafficStatsRuleGet: ', $e->getMessage(), PHP_EOL;
+}
+```
+
+### Options
+
+Note: the input parameter is an associative array with the keys listed below.
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**event_id** | **string** | Unique ID of the event. |
+**rule_id** | **string** | Unique ID of the rule. |
+
+### Return type
+
+[**\Fastly\Model\DdosProtectionTrafficStats**](../Model/DdosProtectionTrafficStats.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)

docs/Api/DdosProtectionApi.md

@@ -17,17 +17,17 @@ $apiInstance = new Fastly\Api\DictionaryApi(
 
 Method | HTTP request | Description
 ------ | ------------ | -----------
-[**createDictionary()**](DictionaryApi.md#createDictionary) | **POST** /service/{service_id}/version/{version_id}/dictionary | Create an edge dictionary
-[**deleteDictionary()**](DictionaryApi.md#deleteDictionary) | **DELETE** /service/{service_id}/version/{version_id}/dictionary/{dictionary_name} | Delete an edge dictionary
-[**getDictionary()**](DictionaryApi.md#getDictionary) | **GET** /service/{service_id}/version/{version_id}/dictionary/{dictionary_name} | Get an edge dictionary
-[**listDictionaries()**](DictionaryApi.md#listDictionaries) | **GET** /service/{service_id}/version/{version_id}/dictionary | List edge dictionaries
-[**updateDictionary()**](DictionaryApi.md#updateDictionary) | **PUT** /service/{service_id}/version/{version_id}/dictionary/{dictionary_name} | Update an edge dictionary
+[**createDictionary()**](DictionaryApi.md#createDictionary) | **POST** /service/{service_id}/version/{version_id}/dictionary | Create a dictionary
+[**deleteDictionary()**](DictionaryApi.md#deleteDictionary) | **DELETE** /service/{service_id}/version/{version_id}/dictionary/{dictionary_name} | Delete a dictionary
+[**getDictionary()**](DictionaryApi.md#getDictionary) | **GET** /service/{service_id}/version/{version_id}/dictionary/{dictionary_name} | Get a dictionary
+[**listDictionaries()**](DictionaryApi.md#listDictionaries) | **GET** /service/{service_id}/version/{version_id}/dictionary | List dictionaries
+[**updateDictionary()**](DictionaryApi.md#updateDictionary) | **PUT** /service/{service_id}/version/{version_id}/dictionary/{dictionary_name} | Update a dictionary
 
 
 ## `createDictionary()`
 
 ```php
-createDictionary($options): \Fastly\Model\DictionaryResponse // Create an edge dictionary
+createDictionary($options): \Fastly\Model\DictionaryResponse // Create a dictionary
 ```
 
 Create named dictionary for a particular service and version.
@@ -67,7 +67,7 @@ Name | Type | Description  | Notes
 ## `deleteDictionary()`
 
 ```php
-deleteDictionary($options): \Fastly\Model\InlineResponse200 // Delete an edge dictionary
+deleteDictionary($options): \Fastly\Model\InlineResponse200 // Delete a dictionary
 ```
 
 Delete named dictionary for a particular service and version.
@@ -105,7 +105,7 @@ Name | Type | Description  | Notes
 ## `getDictionary()`
 
 ```php
-getDictionary($options): \Fastly\Model\DictionaryResponse // Get an edge dictionary
+getDictionary($options): \Fastly\Model\DictionaryResponse // Get a dictionary
 ```
 
 Retrieve a single dictionary by name for the version and service.
@@ -143,7 +143,7 @@ Name | Type | Description  | Notes
 ## `listDictionaries()`
 
 ```php
-listDictionaries($options): \Fastly\Model\DictionaryResponse[] // List edge dictionaries
+listDictionaries($options): \Fastly\Model\DictionaryResponse[] // List dictionaries
 ```
 
 List all dictionaries for the version of the service.
@@ -179,7 +179,7 @@ Name | Type | Description  | Notes
 ## `updateDictionary()`
 
 ```php
-updateDictionary($options): \Fastly\Model\DictionaryResponse // Update an edge dictionary
+updateDictionary($options): \Fastly\Model\DictionaryResponse // Update a dictionary
 ```
 
 Update named dictionary for a particular service and version.

docs/Api/DictionaryApi.md

@@ -17,13 +17,13 @@ $apiInstance = new Fastly\Api\DictionaryInfoApi(
 
 Method | HTTP request | Description
 ------ | ------------ | -----------
-[**getDictionaryInfo()**](DictionaryInfoApi.md#getDictionaryInfo) | **GET** /service/{service_id}/version/{version_id}/dictionary/{dictionary_id}/info | Get edge dictionary metadata
+[**getDictionaryInfo()**](DictionaryInfoApi.md#getDictionaryInfo) | **GET** /service/{service_id}/version/{version_id}/dictionary/{dictionary_id}/info | Get dictionary metadata
 
 
 ## `getDictionaryInfo()`
 
 ```php
-getDictionaryInfo($options): \Fastly\Model\DictionaryInfoResponse // Get edge dictionary metadata
+getDictionaryInfo($options): \Fastly\Model\DictionaryInfoResponse // Get dictionary metadata
 ```
 
 Retrieve metadata for a single dictionary by ID for a version and service.