Generated v6.05

Changes

@@ -1,5 +1,26 @@
 Revision history for https://metacpan.org/dist/WebService-Fastly
 
+6.05 2024-06-27
+
+ [Bug fixes]
+ - bugfix(alerts-definitions): For Origin derived metrics, correct `all_bandwidth` type to `integer`
+
+ [Enhancements]
+ - feat(logging-s3): Add `file_max_bytes` configuration field
+ - feat(alerts-definitions): Add `integration_id` parameter to the List Alert Definitions endpoint
+ - feat(alerts-definitions): For Origin derived metrics, add `all_status_4xx_excl_404_rate` and `all_status_404_rate` properties
+ - feat(alerts-definitions): For Domain derived metrics, add `status_4xx_excl_404_rate` and `status_404_rate` properties
+ - feat(alerts-definitions): For Stats derived metrics, add `status_4xx_excl_404_rate`, `status_404_rate`, `all_status_5xx_rate`,
+ `all_status_4xx_rate`, `all_status_gte_400_rate`, and `all_status_lt_500_rate` properties
+ - feat(billing-invoices): For invoice line items, added `ProductLine` property
+
+ [Documentation]
+ - doc(billing-invoices): "Billing Invoices API" relabeled to "Invoices API"
+ - doc(billing-invoices): Updated documentation of `billing_start_date` and `billing_end_date` query parameters of
+ List of invoices endpoint
+ - doc(alerts-definitions): Updated documentation of several fields
+ - doc(notification-service): Updated documentation examples for several fields
+
 6.04 2024-05-24
 
  [Bug fixes]

README.md

@@ -4,7 +4,7 @@ WebService::Fastly - an interface to most facets of the Fastly API (https://www.
 
 # VERSION
 
-6.04
+6.05
 
 
 # SYNOPSIS
@@ -611,6 +611,8 @@ The fastly-perl API client currently does not support the following endpoints:
 - [`/resources/stores/kv/{store_id}/batch`](https://www.fastly.com/documentation/reference/api/services/resources/kv-store-item) (PUT)
 - [`/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/preview/domains/{tls_preview_domain_id}`](https://www.fastly.com/documentation/reference/api/) (GET, PATCH)
+- [`/tls/preview/domains`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
 - [`/v1/channel/{service_id}/ts/h/limit/{max_entries}`](https://www.fastly.com/documentation/reference/api/metrics-stats/origin-insights) (GET)
 - [`/v1/channel/{service_id}/ts/h`](https://www.fastly.com/documentation/reference/api/metrics-stats/origin-insights) (GET)
 - [`/v1/channel/{service_id}/ts/{start_timestamp}`](https://www.fastly.com/documentation/reference/api/metrics-stats/origin-insights) (GET)

docs/BillingInvoicesApi.md

@@ -84,8 +84,8 @@ my $api_instance = WebService::Fastly::BillingInvoicesApi->new(
  #api_key_prefix => {'Fastly-Key' => 'Bearer'},
 );
 
-my $billing_start_date = 2023-01-01T00:00:00Z; # string | 
-my $billing_end_date = 2023-01-31T00:00:00Z; # string | 
+my $billing_start_date = 2023-01-01; # string | 
+my $billing_end_date = 2023-01-31; # string | 
 my $limit = '100'; # string | Number of results per page. The maximum is 200.
 my $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.
 

docs/Invoicelineitems.md

@@ -15,6 +15,7 @@ Name | Type | Description | Notes
 **units** | **double** | Total number of units of usage. | [optional] 
 **product_name** | **string** | The name of the product. | [optional] 
 **product_group** | **string** | The broader classification of the product (e.g., `Compute` or `Full-Site Delivery`). | [optional] 
+**product_line** | **string** | The broader classification of the product (e.g., `Network Services` or `Security`). | [optional] 
 **region** | **string** | The geographical area applicable for regionally based products. | [optional] 
 **usage_type** | **string** | The unit of measure (e.g., `requests` or `bandwidth`). | [optional] 
 

docs/LoggingS3Additional.md

@@ -19,6 +19,7 @@ Name | Type | Description | Notes
 **secret_key** | **string** | The secret key for your S3 account. Not required if `iam_role` is provided. | [optional] 
 **server_side_encryption_kms_key_id** | **string** | Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`. | [optional] [default to 'null']
 **server_side_encryption** | **string** | Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption. | [optional] [default to 'null']
+**file_max_bytes** | **int** | The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.) | [optional] 
 
 [[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/LoggingS3Api.md

@@ -18,7 +18,7 @@ Method | HTTP request | Description
 
 
 # **create_log_aws_s3**
-> LoggingS3Response create_log_aws_s3(service_id => $service_id, version_id => $version_id, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption)
+> LoggingS3Response create_log_aws_s3(service_id => $service_id, version_id => $version_id, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption, file_max_bytes => $file_max_bytes)
 
 Create an AWS S3 log endpoint
 
@@ -59,9 +59,10 @@ my $redundancy = 'null'; # string | The S3 redundancy level.
 my $secret_key = "secret_key_example"; # string | The secret key for your S3 account. Not required if `iam_role` is provided.
 my $server_side_encryption_kms_key_id = 'null'; # string | Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`.
 my $server_side_encryption = 'null'; # string | Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption.
+my $file_max_bytes = 56; # int | The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.)
 
 eval {
- my $result = $api_instance->create_log_aws_s3(service_id => $service_id, version_id => $version_id, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption);
+ my $result = $api_instance->create_log_aws_s3(service_id => $service_id, version_id => $version_id, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption, file_max_bytes => $file_max_bytes);
  print Dumper($result);
 };
 if ($@) {
@@ -96,6 +97,7 @@ Name | Type | Description | Notes
  **secret_key** | **string**| The secret key for your S3 account. Not required if `iam_role` is provided. | [optional] 
  **server_side_encryption_kms_key_id** | **string**| Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`. | [optional] [default to 'null']
  **server_side_encryption** | **string**| Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption. | [optional] [default to 'null']
+ **file_max_bytes** | **int**| The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.) | [optional] 
 
 ### Return type
 
@@ -276,7 +278,7 @@ Name | Type | Description | Notes
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **update_log_aws_s3**
-> LoggingS3Response update_log_aws_s3(service_id => $service_id, version_id => $version_id, logging_s3_name => $logging_s3_name, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption)
+> LoggingS3Response update_log_aws_s3(service_id => $service_id, version_id => $version_id, logging_s3_name => $logging_s3_name, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption, file_max_bytes => $file_max_bytes)
 
 Update an AWS S3 log endpoint
 
@@ -318,9 +320,10 @@ my $redundancy = 'null'; # string | The S3 redundancy level.
 my $secret_key = "secret_key_example"; # string | The secret key for your S3 account. Not required if `iam_role` is provided.
 my $server_side_encryption_kms_key_id = 'null'; # string | Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`.
 my $server_side_encryption = 'null'; # string | Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption.
+my $file_max_bytes = 56; # int | The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.)
 
 eval {
- my $result = $api_instance->update_log_aws_s3(service_id => $service_id, version_id => $version_id, logging_s3_name => $logging_s3_name, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption);
+ my $result = $api_instance->update_log_aws_s3(service_id => $service_id, version_id => $version_id, logging_s3_name => $logging_s3_name, name => $name, placement => $placement, response_condition => $response_condition, format => $format, format_version => $format_version, message_type => $message_type, timestamp_format => $timestamp_format, compression_codec => $compression_codec, period => $period, gzip_level => $gzip_level, access_key => $access_key, acl => $acl, bucket_name => $bucket_name, domain => $domain, iam_role => $iam_role, path => $path, public_key => $public_key, redundancy => $redundancy, secret_key => $secret_key, server_side_encryption_kms_key_id => $server_side_encryption_kms_key_id, server_side_encryption => $server_side_encryption, file_max_bytes => $file_max_bytes);
  print Dumper($result);
 };
 if ($@) {
@@ -356,6 +359,7 @@ Name | Type | Description | Notes
  **secret_key** | **string**| The secret key for your S3 account. Not required if `iam_role` is provided. | [optional] 
  **server_side_encryption_kms_key_id** | **string**| Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`. | [optional] [default to 'null']
  **server_side_encryption** | **string**| Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption. | [optional] [default to 'null']
+ **file_max_bytes** | **int**| The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.) | [optional] 
 
 ### Return type
 

docs/LoggingS3Response.md

@@ -34,6 +34,7 @@ Name | Type | Description | Notes
 **secret_key** | **string** | The secret key for your S3 account. Not required if `iam_role` is provided. | [optional] 
 **server_side_encryption_kms_key_id** | **string** | Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`. | [optional] [default to 'null']
 **server_side_encryption** | **string** | Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption. | [optional] [default to 'null']
+**file_max_bytes** | **int** | The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.) | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

lib/WebService/Fastly.pm

@@ -2,7 +2,7 @@ package WebService::Fastly;
 
 use strict;
 use 5.008_005;
-our $VERSION = '6.04';
+our $VERSION = '6.05';
 
 1;
 __END__

lib/WebService/Fastly/Configuration.pm

@@ -24,7 +24,7 @@ use utf8;
 use Log::Any qw($log);
 use Carp;
 
-use constant VERSION => '6.04';
+use constant VERSION => '6.05';
 
 =head1 Name
 
@@ -44,7 +44,7 @@ default: 180
 
 String. custom UserAgent header
 
-default: fastly-perl/6.04
+default: fastly-perl/6.05
 
 =item api_key: (optional)
 
@@ -93,7 +93,7 @@ sub new {
 
  # class/static variables
  $p{http_timeout} //= 180;
- $p{http_user_agent} //= 'fastly-perl/6.04';
+ $p{http_user_agent} //= 'fastly-perl/6.05';
 
  # authentication setting
  $p{api_key} //= {};

lib/WebService/Fastly/LoggingS3Api.pm

@@ -74,6 +74,7 @@ sub new {
 # @param string $secret_key The secret key for your S3 account. Not required if `iam_role` is provided. (optional)
 # @param string $server_side_encryption_kms_key_id Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`. (optional, default to 'null')
 # @param string $server_side_encryption Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption. (optional, default to 'null')
+# @param int $file_max_bytes The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.) (optional)
 {
  my $params = {
  'service_id' => {
@@ -191,6 +192,11 @@ sub new {
  description => 'Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption.',
  required => '0',
  },
+ 'file_max_bytes' => {
+ data_type => 'int',
+ description => 'The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.)',
+ required => '0',
+ },
  };
  __PACKAGE__->method_documentation->{ 'create_log_aws_s3' } = {
  summary => 'Create an AWS S3 log endpoint',
@@ -347,6 +353,11 @@ sub create_log_aws_s3 {
  $form_params->{'server_side_encryption'} = $self->{api_client}->to_form_value($args{'server_side_encryption'});
  }
 
+ # form params
+ if ( exists $args{'file_max_bytes'} ) {
+ $form_params->{'file_max_bytes'} = $self->{api_client}->to_form_value($args{'file_max_bytes'});
+ }
+
  my $_body_data;
  # authentication setting, if any
  my $auth_settings = [qw(token )];
@@ -682,6 +693,7 @@ sub list_log_aws_s3 {
 # @param string $secret_key The secret key for your S3 account. Not required if `iam_role` is provided. (optional)
 # @param string $server_side_encryption_kms_key_id Optional server-side KMS Key Id. Must be set if `server_side_encryption` is set to `aws:kms` or `AES256`. (optional, default to 'null')
 # @param string $server_side_encryption Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption. (optional, default to 'null')
+# @param int $file_max_bytes The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.) (optional)
 {
  my $params = {
  'service_id' => {
@@ -804,6 +816,11 @@ sub list_log_aws_s3 {
  description => 'Set this to `AES256` or `aws:kms` to enable S3 Server Side Encryption.',
  required => '0',
  },
+ 'file_max_bytes' => {
+ data_type => 'int',
+ description => 'The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.)',
+ required => '0',
+ },
  };
  __PACKAGE__->method_documentation->{ 'update_log_aws_s3' } = {
  summary => 'Update an AWS S3 log endpoint',
@@ -972,6 +989,11 @@ sub update_log_aws_s3 {
  $form_params->{'server_side_encryption'} = $self->{api_client}->to_form_value($args{'server_side_encryption'});
  }
 
+ # form params
+ if ( exists $args{'file_max_bytes'} ) {
+ $form_params->{'file_max_bytes'} = $self->{api_client}->to_form_value($args{'file_max_bytes'});
+ }
+
  my $_body_data;
  # authentication setting, if any
  my $auth_settings = [qw(token )];