Generated v5.5.0

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [v5.5.0](https://github.com/fastly/fastly-php/releases/tag/release/v5.5.0) (2024-07-01)
+
+**Bug fixes:**
+
+- fix(logging): For several endpoints, correct use_tls to be string
+
+**Enhancements:**
+
+- feat(content): `/content/edge_check` endpoint now returns informational values in `hash` when a timeout occurs or when
+  an object is too large.
+- feat(logging-datalog): Added additional regions
+
 ## [v5.4.0](https://github.com/fastly/fastly-php/releases/tag/release/v5.4.0) (2024-06-27)
 
 **Bug fixes:**

docs/Api/ContentApi.md

@@ -26,7 +26,7 @@ Method | HTTP request | Description
 contentCheck($options): \Fastly\Model\Content[] // Check status of content in each POP's cache
 ```
 
-Retrieve headers and MD5 hash of the content for a particular URL from each Fastly edge server. This API is limited to 200 requests per hour.
+Retrieve headers and MD5 hash of the content for a particular URL from each Fastly edge server. This API is limited to 200 requests per hour. If the content takes too long to download, the hash will be set to `error-timeout-$pop`. If the response is too large, it will be set to `warning-too-large-$pop`.
 
 ### Example
 ```php

docs/Api/LoggingDatadogApi.md

@@ -64,7 +64,7 @@ Name | Type | Description  | Notes
 **response_condition** | **string** | The name of an existing condition in the configured endpoint, or leave blank to always execute. | [optional]
 **format** | **string** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). Must produce valid JSON that Datadog can ingest. | [optional] [defaults to '{"ddsource":"fastly","service":"%{req.service_id}V","date":"%{begin:%Y-%m-%dT%H:%M:%S%Z}t","time_start":"%{begin:%Y-%m-%dT%H:%M:%S%Z}t","time_end":"%{end:%Y-%m-%dT%H:%M:%S%Z}t","http":{"request_time_ms":"%D","method":"%m","url":"%{json.escape(req.url)}V","useragent":"%{User-Agent}i","referer":"%{Referer}i","protocol":"%H","request_x_forwarded_for":"%{X-Forwarded-For}i","status_code":"%s"},"network":{"client":{"ip":"%h","name":"%{client.as.name}V","number":"%{client.as.number}V","connection_speed":"%{client.geo.conn_speed}V"},"destination":{"ip":"%A"},"geoip":{"geo_city":"%{client.geo.city.utf8}V","geo_country_code":"%{client.geo.country_code}V","geo_continent_code":"%{client.geo.continent_code}V","geo_region":"%{client.geo.region}V"},"bytes_written":"%B","bytes_read":"%{req.body_bytes_read}V"},"host":"%{Fastly-Orig-Host}i","origin_host":"%v","is_ipv6":"%{if(req.is_ipv6, \"true\", \"false\")}V","is_tls":"%{if(req.is_ssl, \"true\", \"false\")}V","tls_client_protocol":"%{json.escape(tls.client.protocol)}V","tls_client_servername":"%{json.escape(tls.client.servername)}V","tls_client_cipher":"%{json.escape(tls.client.cipher)}V","tls_client_cipher_sha":"%{json.escape(tls.client.ciphers_sha)}V","tls_client_tlsexts_sha":"%{json.escape(tls.client.tlsexts_sha)}V","is_h2":"%{if(fastly_info.is_h2, \"true\", \"false\")}V","is_h2_push":"%{if(fastly_info.h2.is_push, \"true\", \"false\")}V","h2_stream_id":"%{fastly_info.h2.stream_id}V","request_accept_content":"%{Accept}i","request_accept_language":"%{Accept-Language}i","request_accept_encoding":"%{Accept-Encoding}i","request_accept_charset":"%{Accept-Charset}i","request_connection":"%{Connection}i","request_dnt":"%{DNT}i","request_forwarded":"%{Forwarded}i","request_via":"%{Via}i","request_cache_control":"%{Cache-Control}i","request_x_requested_with":"%{X-Requested-With}i","request_x_att_device_id":"%{X-ATT-Device-Id}i","content_type":"%{Content-Type}o","is_cacheable":"%{if(fastly_info.state~\"^(HIT|MISS)$\", \"true\", \"false\")}V","response_age":"%{Age}o","response_cache_control":"%{Cache-Control}o","response_expires":"%{Expires}o","response_last_modified":"%{Last-Modified}o","response_tsv":"%{TSV}o","server_datacenter":"%{server.datacenter}V","req_header_size":"%{req.header_bytes_read}V","resp_header_size":"%{resp.header_bytes_written}V","socket_cwnd":"%{client.socket.cwnd}V","socket_nexthop":"%{client.socket.nexthop}V","socket_tcpi_rcv_mss":"%{client.socket.tcpi_rcv_mss}V","socket_tcpi_snd_mss":"%{client.socket.tcpi_snd_mss}V","socket_tcpi_rtt":"%{client.socket.tcpi_rtt}V","socket_tcpi_rttvar":"%{client.socket.tcpi_rttvar}V","socket_tcpi_rcv_rtt":"%{client.socket.tcpi_rcv_rtt}V","socket_tcpi_rcv_space":"%{client.socket.tcpi_rcv_space}V","socket_tcpi_last_data_sent":"%{client.socket.tcpi_last_data_sent}V","socket_tcpi_total_retrans":"%{client.socket.tcpi_total_retrans}V","socket_tcpi_delta_retrans":"%{client.socket.tcpi_delta_retrans}V","socket_ploss":"%{client.socket.ploss}V"}']
 **format_version** | **int** | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`. | [optional] [one of: 1, 2]
-**region** | **string** | The region that log data will be sent to. | [optional] [one of: 'US', 'EU'] [defaults to 'US']
+**region** | **string** | The region that log data will be sent to. | [optional] [one of: 'US', 'US3', 'US5', 'EU (legacy, same as EU1)', 'EU1', 'AP1'] [defaults to 'US']
 **token** | **string** | The API key from your Datadog account. Required. | [optional]
 
 ### Return type
@@ -228,7 +228,7 @@ Name | Type | Description  | Notes
 **response_condition** | **string** | The name of an existing condition in the configured endpoint, or leave blank to always execute. | [optional]
 **format** | **string** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). Must produce valid JSON that Datadog can ingest. | [optional] [defaults to '{"ddsource":"fastly","service":"%{req.service_id}V","date":"%{begin:%Y-%m-%dT%H:%M:%S%Z}t","time_start":"%{begin:%Y-%m-%dT%H:%M:%S%Z}t","time_end":"%{end:%Y-%m-%dT%H:%M:%S%Z}t","http":{"request_time_ms":"%D","method":"%m","url":"%{json.escape(req.url)}V","useragent":"%{User-Agent}i","referer":"%{Referer}i","protocol":"%H","request_x_forwarded_for":"%{X-Forwarded-For}i","status_code":"%s"},"network":{"client":{"ip":"%h","name":"%{client.as.name}V","number":"%{client.as.number}V","connection_speed":"%{client.geo.conn_speed}V"},"destination":{"ip":"%A"},"geoip":{"geo_city":"%{client.geo.city.utf8}V","geo_country_code":"%{client.geo.country_code}V","geo_continent_code":"%{client.geo.continent_code}V","geo_region":"%{client.geo.region}V"},"bytes_written":"%B","bytes_read":"%{req.body_bytes_read}V"},"host":"%{Fastly-Orig-Host}i","origin_host":"%v","is_ipv6":"%{if(req.is_ipv6, \"true\", \"false\")}V","is_tls":"%{if(req.is_ssl, \"true\", \"false\")}V","tls_client_protocol":"%{json.escape(tls.client.protocol)}V","tls_client_servername":"%{json.escape(tls.client.servername)}V","tls_client_cipher":"%{json.escape(tls.client.cipher)}V","tls_client_cipher_sha":"%{json.escape(tls.client.ciphers_sha)}V","tls_client_tlsexts_sha":"%{json.escape(tls.client.tlsexts_sha)}V","is_h2":"%{if(fastly_info.is_h2, \"true\", \"false\")}V","is_h2_push":"%{if(fastly_info.h2.is_push, \"true\", \"false\")}V","h2_stream_id":"%{fastly_info.h2.stream_id}V","request_accept_content":"%{Accept}i","request_accept_language":"%{Accept-Language}i","request_accept_encoding":"%{Accept-Encoding}i","request_accept_charset":"%{Accept-Charset}i","request_connection":"%{Connection}i","request_dnt":"%{DNT}i","request_forwarded":"%{Forwarded}i","request_via":"%{Via}i","request_cache_control":"%{Cache-Control}i","request_x_requested_with":"%{X-Requested-With}i","request_x_att_device_id":"%{X-ATT-Device-Id}i","content_type":"%{Content-Type}o","is_cacheable":"%{if(fastly_info.state~\"^(HIT|MISS)$\", \"true\", \"false\")}V","response_age":"%{Age}o","response_cache_control":"%{Cache-Control}o","response_expires":"%{Expires}o","response_last_modified":"%{Last-Modified}o","response_tsv":"%{TSV}o","server_datacenter":"%{server.datacenter}V","req_header_size":"%{req.header_bytes_read}V","resp_header_size":"%{resp.header_bytes_written}V","socket_cwnd":"%{client.socket.cwnd}V","socket_nexthop":"%{client.socket.nexthop}V","socket_tcpi_rcv_mss":"%{client.socket.tcpi_rcv_mss}V","socket_tcpi_snd_mss":"%{client.socket.tcpi_snd_mss}V","socket_tcpi_rtt":"%{client.socket.tcpi_rtt}V","socket_tcpi_rttvar":"%{client.socket.tcpi_rttvar}V","socket_tcpi_rcv_rtt":"%{client.socket.tcpi_rcv_rtt}V","socket_tcpi_rcv_space":"%{client.socket.tcpi_rcv_space}V","socket_tcpi_last_data_sent":"%{client.socket.tcpi_last_data_sent}V","socket_tcpi_total_retrans":"%{client.socket.tcpi_total_retrans}V","socket_tcpi_delta_retrans":"%{client.socket.tcpi_delta_retrans}V","socket_ploss":"%{client.socket.ploss}V"}']
 **format_version** | **int** | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`. | [optional] [one of: 1, 2]
-**region** | **string** | The region that log data will be sent to. | [optional] [one of: 'US', 'EU'] [defaults to 'US']
+**region** | **string** | The region that log data will be sent to. | [optional] [one of: 'US', 'US3', 'US5', 'EU (legacy, same as EU1)', 'EU1', 'AP1'] [defaults to 'US']
 **token** | **string** | The API key from your Datadog account. Required. | [optional]
 
 ### Return type

docs/Api/LoggingKafkaApi.md

@@ -54,7 +54,7 @@ $options['parse_log_keyvals'] = True; // bool | Enables parsing of key=value tup
 $options['auth_method'] = 'auth_method_example'; // string | SASL authentication method.
 $options['user'] = 'user_example'; // string | SASL user.
 $options['password'] = 'password_example'; // string | SASL password.
-$options['use_tls'] = new \Fastly\Model\LoggingUseTls(); // \Fastly\Model\LoggingUseTls
+$options['use_tls'] = new \Fastly\Model\LoggingUseTlsString(); // \Fastly\Model\LoggingUseTlsString
 
 try {
     $result = $apiInstance->createLogKafka($options);
@@ -89,7 +89,7 @@ Name | Type | Description  | Notes
 **auth_method** | **string** | SASL authentication method. | [optional] [one of: 'plain', 'scram-sha-256', 'scram-sha-512']
 **user** | **string** | SASL user. | [optional]
 **password** | **string** | SASL password. | [optional]
-**use_tls** | [**\Fastly\Model\LoggingUseTls**](../Model/LoggingUseTls.md) |  | [optional]
+**use_tls** | [**\Fastly\Model\LoggingUseTlsString**](../Model/LoggingUseTlsString.md) |  | [optional]
 
 ### Return type
 

docs/Api/LoggingLogentriesApi.md

@@ -43,7 +43,7 @@ $options['format'] = '%h %l %u %t \"%r\" %>s %b'; // string | A Fastly [log f
 $options['format_version'] = self::FORMAT_VERSION_v2; // int | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.
 $options['port'] = 20000; // int | The port number.
 $options['token'] = 'token_example'; // string | Use token based authentication.
-$options['use_tls'] = new \Fastly\Model\LoggingUseTls(); // \Fastly\Model\LoggingUseTls
+$options['use_tls'] = new \Fastly\Model\LoggingUseTlsString(); // \Fastly\Model\LoggingUseTlsString
 $options['region'] = 'region_example'; // string | The region to which to stream logs.
 
 try {
@@ -68,7 +68,7 @@ Name | Type | Description  | Notes
 **format_version** | **int** | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`. | [optional] [one of: 1, 2]
 **port** | **int** | The port number. | [optional] [defaults to 20000]
 **token** | **string** | Use token based authentication. | [optional]
-**use_tls** | [**\Fastly\Model\LoggingUseTls**](../Model/LoggingUseTls.md) |  | [optional]
+**use_tls** | [**\Fastly\Model\LoggingUseTlsString**](../Model/LoggingUseTlsString.md) |  | [optional]
 **region** | **string** | The region to which to stream logs. | [optional] [one of: 'US', 'US-2', 'US-3', 'EU', 'CA', 'AU', 'AP']
 
 ### Return type
@@ -210,7 +210,7 @@ $options['format'] = '%h %l %u %t \"%r\" %>s %b'; // string | A Fastly [log f
 $options['format_version'] = self::FORMAT_VERSION_v2; // int | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.
 $options['port'] = 20000; // int | The port number.
 $options['token'] = 'token_example'; // string | Use token based authentication.
-$options['use_tls'] = new \Fastly\Model\LoggingUseTls(); // \Fastly\Model\LoggingUseTls
+$options['use_tls'] = new \Fastly\Model\LoggingUseTlsString(); // \Fastly\Model\LoggingUseTlsString
 $options['region'] = 'region_example'; // string | The region to which to stream logs.
 
 try {
@@ -236,7 +236,7 @@ Name | Type | Description  | Notes
 **format_version** | **int** | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`. | [optional] [one of: 1, 2]
 **port** | **int** | The port number. | [optional] [defaults to 20000]
 **token** | **string** | Use token based authentication. | [optional]
-**use_tls** | [**\Fastly\Model\LoggingUseTls**](../Model/LoggingUseTls.md) |  | [optional]
+**use_tls** | [**\Fastly\Model\LoggingUseTlsString**](../Model/LoggingUseTlsString.md) |  | [optional]
 **region** | **string** | The region to which to stream logs. | [optional] [one of: 'US', 'US-2', 'US-3', 'EU', 'CA', 'AU', 'AP']
 
 ### Return type

docs/Api/LoggingSplunkApi.md

@@ -49,7 +49,7 @@ $options['request_max_entries'] = 0; // int | The maximum number of logs sent in
 $options['request_max_bytes'] = 0; // int | The maximum number of bytes sent in one request. Defaults `0` for unbounded.
 $options['url'] = 'url_example'; // string | The URL to post logs to.
 $options['token'] = 'token_example'; // string | A Splunk token for use in posting logs over HTTP to your collector.
-$options['use_tls'] = new \Fastly\Model\LoggingUseTls(); // \Fastly\Model\LoggingUseTls
+$options['use_tls'] = new \Fastly\Model\LoggingUseTlsString(); // \Fastly\Model\LoggingUseTlsString
 
 try {
     $result = $apiInstance->createLogSplunk($options);
@@ -79,7 +79,7 @@ Name | Type | Description  | Notes
 **request_max_bytes** | **int** | The maximum number of bytes sent in one request. Defaults `0` for unbounded. | [optional] [defaults to 0]
 **url** | **string** | The URL to post logs to. | [optional]
 **token** | **string** | A Splunk token for use in posting logs over HTTP to your collector. | [optional]
-**use_tls** | [**\Fastly\Model\LoggingUseTls**](../Model/LoggingUseTls.md) |  | [optional]
+**use_tls** | [**\Fastly\Model\LoggingUseTlsString**](../Model/LoggingUseTlsString.md) |  | [optional]
 
 ### Return type
 
@@ -226,7 +226,7 @@ $options['request_max_entries'] = 0; // int | The maximum number of logs sent in
 $options['request_max_bytes'] = 0; // int | The maximum number of bytes sent in one request. Defaults `0` for unbounded.
 $options['url'] = 'url_example'; // string | The URL to post logs to.
 $options['token'] = 'token_example'; // string | A Splunk token for use in posting logs over HTTP to your collector.
-$options['use_tls'] = new \Fastly\Model\LoggingUseTls(); // \Fastly\Model\LoggingUseTls
+$options['use_tls'] = new \Fastly\Model\LoggingUseTlsString(); // \Fastly\Model\LoggingUseTlsString
 
 try {
     $result = $apiInstance->updateLogSplunk($options);
@@ -257,7 +257,7 @@ Name | Type | Description  | Notes
 **request_max_bytes** | **int** | The maximum number of bytes sent in one request. Defaults `0` for unbounded. | [optional] [defaults to 0]
 **url** | **string** | The URL to post logs to. | [optional]
 **token** | **string** | A Splunk token for use in posting logs over HTTP to your collector. | [optional]
-**use_tls** | [**\Fastly\Model\LoggingUseTls**](../Model/LoggingUseTls.md) |  | [optional]
+**use_tls** | [**\Fastly\Model\LoggingUseTlsString**](../Model/LoggingUseTlsString.md) |  | [optional]
 
 ### Return type
 

docs/Api/LoggingSyslogApi.md

@@ -51,7 +51,7 @@ $options['message_type'] = new \Fastly\Model\LoggingMessageType(); // \Fastly\Mo
 $options['hostname'] = 'hostname_example'; // string | The hostname used for the syslog endpoint.
 $options['ipv4'] = 'ipv4_example'; // string | The IPv4 address used for the syslog endpoint.
 $options['token'] = 'null'; // string | Whether to prepend each message with a specific token.
-$options['use_tls'] = new \Fastly\Model\LoggingUseTls(); // \Fastly\Model\LoggingUseTls
+$options['use_tls'] = new \Fastly\Model\LoggingUseTlsString(); // \Fastly\Model\LoggingUseTlsString
 
 try {
     $result = $apiInstance->createLogSyslog($options);
@@ -83,7 +83,7 @@ Name | Type | Description  | Notes
 **hostname** | **string** | The hostname used for the syslog endpoint. | [optional]
 **ipv4** | **string** | The IPv4 address used for the syslog endpoint. | [optional]
 **token** | **string** | Whether to prepend each message with a specific token. | [optional] [defaults to 'null']
-**use_tls** | [**\Fastly\Model\LoggingUseTls**](../Model/LoggingUseTls.md) |  | [optional]
+**use_tls** | [**\Fastly\Model\LoggingUseTlsString**](../Model/LoggingUseTlsString.md) |  | [optional]
 
 ### Return type
 
@@ -232,7 +232,7 @@ $options['message_type'] = new \Fastly\Model\LoggingMessageType(); // \Fastly\Mo
 $options['hostname'] = 'hostname_example'; // string | The hostname used for the syslog endpoint.
 $options['ipv4'] = 'ipv4_example'; // string | The IPv4 address used for the syslog endpoint.
 $options['token'] = 'null'; // string | Whether to prepend each message with a specific token.
-$options['use_tls'] = new \Fastly\Model\LoggingUseTls(); // \Fastly\Model\LoggingUseTls
+$options['use_tls'] = new \Fastly\Model\LoggingUseTlsString(); // \Fastly\Model\LoggingUseTlsString
 
 try {
     $result = $apiInstance->updateLogSyslog($options);
@@ -265,7 +265,7 @@ Name | Type | Description  | Notes
 **hostname** | **string** | The hostname used for the syslog endpoint. | [optional]
 **ipv4** | **string** | The IPv4 address used for the syslog endpoint. | [optional]
 **token** | **string** | Whether to prepend each message with a specific token. | [optional] [defaults to 'null']
-**use_tls** | [**\Fastly\Model\LoggingUseTls**](../Model/LoggingUseTls.md) |  | [optional]
+**use_tls** | [**\Fastly\Model\LoggingUseTlsString**](../Model/LoggingUseTlsString.md) |  | [optional]
 
 ### Return type