Generated v2.03

Author: github-actions

Changes

@@ -1,5 +1,13 @@
 Revision history for https://metacpan.org/dist/WebService-Fastly
 
+2.03 2023-04-03
+    * fix(purge): avoid escaping URL parameter
+    * feat(object-store): add 'location' property to 'create_store'
+    * feat(object-store): add 'force' property to 'delete_store'
+    * feat(realtime): additional DDoS properties
+    * docs(acl-entries): document batch updating
+    * docs(object-store): new properties for 'set_value_for_key'
+
 2.02 2023-03-23
     * fix(purge): switch authentication type to 'token'
     * feat(domain-ownerships): List domain-ownerships

README.md

@@ -4,7 +4,7 @@ WebService::Fastly - an interface to most facets of the [Fastly API](https://dev
 
 # VERSION
 
-2.02
+2.03
 
 > NOTE: This 2.x release is a new [generated API client](https://dev.to/fastly/better-fastly-api-clients-with-openapi-generator-3lno) for the Fastly API.
 > The previous 1.x version is no longer supported, but can be found at https://github.com/fastly/fastly-perl/tree/v1.x.

docs/AclEntryApi.md

@@ -22,7 +22,7 @@ Method | HTTP request | Description
 
 Update multiple ACL entries
 
-Update multiple ACL entries on the same ACL.
+Update multiple ACL entries on the same ACL. For faster updates to your service, group your changes into large batches. The maximum batch size is 1000 entries. [Contact support](https://support.fastly.com/) to discuss raising this limit.
 
 ### Example
 ```perl

docs/ObjectStoreApi.md

@@ -16,7 +16,7 @@ Method | HTTP request | Description
 
 
 # **create_store**
-> StoreResponse create_store(store => $store)
+> StoreResponse create_store(location => $location, store => $store)
 
 Create an object store.
 
@@ -34,10 +34,11 @@ my $api_instance = WebService::Fastly::ObjectStoreApi->new(
     #api_key_prefix => {'Fastly-Key' => 'Bearer'},
 );
 
+my $location = "location_example"; # string | 
 my $store = WebService::Fastly::Object::Store->new(); # Store | 
 
 eval {
-    my $result = $api_instance->create_store(store => $store);
+    my $result = $api_instance->create_store(location => $location, store => $store);
     print Dumper($result);
 };
 if ($@) {
@@ -49,6 +50,7 @@ if ($@) {
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
+ **location** | **string**|  | [optional] 
  **store** | [**Store**](Store.md)|  | [optional] 
 
 ### Return type
@@ -67,7 +69,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)
 
 # **delete_store**
-> delete_store(store_id => $store_id)
+> delete_store(store_id => $store_id, force => $force)
 
 Delete an object store.
 
@@ -86,9 +88,10 @@ my $api_instance = WebService::Fastly::ObjectStoreApi->new(
 );
 
 my $store_id = "store_id_example"; # string | 
+my $force = null; # boolean | 
 
 eval {
-    $api_instance->delete_store(store_id => $store_id);
+    $api_instance->delete_store(store_id => $store_id, force => $force);
 };
 if ($@) {
     warn "Exception when calling ObjectStoreApi->delete_store: $@\n";
@@ -100,6 +103,7 @@ if ($@) {
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **store_id** | **string**|  | 
+ **force** | **boolean**|  | [optional] 
 
 ### Return type
 

docs/ObjectStoreItemApi.md

@@ -16,7 +16,7 @@ Method | HTTP request | Description
 
 
 # **delete_key_from_store**
-> delete_key_from_store(store_id => $store_id, key_name => $key_name)
+> delete_key_from_store(store_id => $store_id, key_name => $key_name, force => $force)
 
 Delete object store item.
 
@@ -36,9 +36,10 @@ my $api_instance = WebService::Fastly::ObjectStoreItemApi->new(
 
 my $store_id = "store_id_example"; # string | 
 my $key_name = "key_name_example"; # string | 
+my $force = null; # boolean | 
 
 eval {
-    $api_instance->delete_key_from_store(store_id => $store_id, key_name => $key_name);
+    $api_instance->delete_key_from_store(store_id => $store_id, key_name => $key_name, force => $force);
 };
 if ($@) {
     warn "Exception when calling ObjectStoreItemApi->delete_key_from_store: $@\n";
@@ -51,6 +52,7 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **store_id** | **string**|  | 
  **key_name** | **string**|  | 
+ **force** | **boolean**|  | [optional] 
 
 ### Return type
 
@@ -68,7 +70,7 @@ void (empty response body)
 [[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)
 
 # **get_keys**
-> InlineResponse2004 get_keys(store_id => $store_id, cursor => $cursor, limit => $limit)
+> InlineResponse2004 get_keys(store_id => $store_id, cursor => $cursor, limit => $limit, prefix => $prefix)
 
 List object store keys.
 
@@ -89,9 +91,10 @@ my $api_instance = WebService::Fastly::ObjectStoreItemApi->new(
 my $store_id = "store_id_example"; # string | 
 my $cursor = "cursor_example"; # string | 
 my $limit = 100; # int | 
+my $prefix = "prefix_example"; # string | 
 
 eval {
-    my $result = $api_instance->get_keys(store_id => $store_id, cursor => $cursor, limit => $limit);
+    my $result = $api_instance->get_keys(store_id => $store_id, cursor => $cursor, limit => $limit, prefix => $prefix);
     print Dumper($result);
 };
 if ($@) {
@@ -106,6 +109,7 @@ Name | Type | Description  | Notes
  **store_id** | **string**|  | 
  **cursor** | **string**|  | [optional] 
  **limit** | **int**|  | [optional] [default to 100]
+ **prefix** | **string**|  | [optional] 
 
 ### Return type
 
@@ -176,7 +180,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)
 
 # **set_value_for_key**
-> string set_value_for_key(store_id => $store_id, key_name => $key_name, body => $body)
+> string set_value_for_key(store_id => $store_id, key_name => $key_name, if_generation_match => $if_generation_match, time_to_live_sec => $time_to_live_sec, metadata => $metadata, add => $add, append => $append, prepend => $prepend, background_fetch => $background_fetch, body => $body)
 
 Insert an item into an object store
 
@@ -196,10 +200,17 @@ my $api_instance = WebService::Fastly::ObjectStoreItemApi->new(
 
 my $store_id = "store_id_example"; # string | 
 my $key_name = "key_name_example"; # string | 
+my $if_generation_match = 56; # int | 
+my $time_to_live_sec = 56; # int | 
+my $metadata = "metadata_example"; # string | 
+my $add = null; # boolean | 
+my $append = null; # boolean | 
+my $prepend = null; # boolean | 
+my $background_fetch = null; # boolean | 
 my $body = WebService::Fastly::Object::string->new(); # string | 
 
 eval {
-    my $result = $api_instance->set_value_for_key(store_id => $store_id, key_name => $key_name, body => $body);
+    my $result = $api_instance->set_value_for_key(store_id => $store_id, key_name => $key_name, if_generation_match => $if_generation_match, time_to_live_sec => $time_to_live_sec, metadata => $metadata, add => $add, append => $append, prepend => $prepend, background_fetch => $background_fetch, body => $body);
     print Dumper($result);
 };
 if ($@) {
@@ -213,6 +224,13 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **store_id** | **string**|  | 
  **key_name** | **string**|  | 
+ **if_generation_match** | **int**|  | [optional] 
+ **time_to_live_sec** | **int**|  | [optional] 
+ **metadata** | **string**|  | [optional] 
+ **add** | **boolean**|  | [optional] 
+ **append** | **boolean**|  | [optional] 
+ **prepend** | **boolean**|  | [optional] 
+ **background_fetch** | **boolean**|  | [optional] 
  **body** | **string****string**|  | [optional] 
 
 ### Return type

docs/RealtimeMeasurements.md

@@ -219,6 +219,12 @@ Name | Type | Description | Notes
 **fanout_beresp_header_bytes** | **int** | Total header bytes received from backends over Fanout connections. | [optional] 
 **fanout_beresp_body_bytes** | **int** | Total body or message content bytes received from backends over Fanout connections. | [optional] 
 **fanout_conn_time_ms** | **int** | Total duration of Fanout connections with end users. | [optional] 
+**ddos_action_limit_streams_connections** | **int** | For HTTP/2, the number of connections the limit-streams action was applied to. The limit-streams action caps the allowed number of concurrent streams in a connection. | [optional] 
+**ddos_action_limit_streams_requests** | **int** | For HTTP/2, the number of requests made on a connection for which the limit-streams action was taken. The limit-streams action caps the allowed number of concurrent streams in a connection. | [optional] 
+**ddos_action_tarpit_accept** | **int** | The number of times the tarpit-accept action was taken. The tarpit-accept action adds a delay when accepting future connections. | [optional] 
+**ddos_action_tarpit** | **int** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] 
+**ddos_action_close** | **int** | The number of times the close action was taken. The close action aborts the connection as soon as possible. The close action takes effect either right after accept, right after the client hello, or right after the response was sent. | [optional] 
+**ddos_action_blackhole** | **int** | The number of times the blackhole action was taken. The blackhole action quietly closes a TCP connection without sending a reset. The blackhole action quietly closes a TCP connection without notifying its peer (all TCP state is dropped). | [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/Results.md

@@ -217,6 +217,12 @@ Name | Type | Description | Notes
 **fanout_beresp_header_bytes** | **int** | Total header bytes received from backends over Fanout connections. | [optional] 
 **fanout_beresp_body_bytes** | **int** | Total body or message content bytes received from backends over Fanout connections. | [optional] 
 **fanout_conn_time_ms** | **int** | Total duration of Fanout connections with end users. | [optional] 
+**ddos_action_limit_streams_connections** | **int** | For HTTP/2, the number of connections the limit-streams action was applied to. The limit-streams action caps the allowed number of concurrent streams in a connection. | [optional] 
+**ddos_action_limit_streams_requests** | **int** | For HTTP/2, the number of requests made on a connection for which the limit-streams action was taken. The limit-streams action caps the allowed number of concurrent streams in a connection. | [optional] 
+**ddos_action_tarpit_accept** | **int** | The number of times the tarpit-accept action was taken. The tarpit-accept action adds a delay when accepting future connections. | [optional] 
+**ddos_action_tarpit** | **int** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] 
+**ddos_action_close** | **int** | The number of times the close action was taken. The close action aborts the connection as soon as possible. The close action takes effect either right after accept, right after the client hello, or right after the response was sent. | [optional] 
+**ddos_action_blackhole** | **int** | The number of times the blackhole action was taken. The blackhole action quietly closes a TCP connection without sending a reset. The blackhole action quietly closes a TCP connection without notifying its peer (all TCP state is dropped). | [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 = '2.02';
+our $VERSION = '2.03';
 
 1;
 __END__

lib/WebService/Fastly/ApiClient.pm

@@ -163,10 +163,15 @@ sub call_api {
 #  Take value and turn it into a string suitable for inclusion in
 #  the path, by url-encoding.
 #  @param string $value a string which will be part of the path
+#  @param boolean $allow_reserved if set to true, then value will not be url-encoded. Default false.
 #  @return string the serialized object
 sub to_path_value {
-    my ($self, $value) = @_;
-    return uri_escape($self->to_string($value));
+    my ($self, $value, $allow_reserved) = @_;
+    $str = $self->to_string($value);
+    if (!$allow_reserved) {
+        $str = uri_escape($str);
+    }
+    return $str;
 }
 
 

lib/WebService/Fastly/Configuration.pm

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

lib/WebService/Fastly/Object/RealtimeMeasurements.pm

@@ -1635,6 +1635,48 @@ __PACKAGE__->method_documentation({
         format => '',
         read_only => 'false',
             },
+    'ddos_action_limit_streams_connections' => {
+        datatype => 'int',
+        base_name => 'ddos_action_limit_streams_connections',
+        description => 'For HTTP/2, the number of connections the limit-streams action was applied to. The limit-streams action caps the allowed number of concurrent streams in a connection.',
+        format => '',
+        read_only => 'false',
+            },
+    'ddos_action_limit_streams_requests' => {
+        datatype => 'int',
+        base_name => 'ddos_action_limit_streams_requests',
+        description => 'For HTTP/2, the number of requests made on a connection for which the limit-streams action was taken. The limit-streams action caps the allowed number of concurrent streams in a connection.',
+        format => '',
+        read_only => 'false',
+            },
+    'ddos_action_tarpit_accept' => {
+        datatype => 'int',
+        base_name => 'ddos_action_tarpit_accept',
+        description => 'The number of times the tarpit-accept action was taken. The tarpit-accept action adds a delay when accepting future connections.',
+        format => '',
+        read_only => 'false',
+            },
+    'ddos_action_tarpit' => {
+        datatype => 'int',
+        base_name => 'ddos_action_tarpit',
+        description => 'The number of times the tarpit action was taken. The tarpit action delays writing the response to the client.',
+        format => '',
+        read_only => 'false',
+            },
+    'ddos_action_close' => {
+        datatype => 'int',
+        base_name => 'ddos_action_close',
+        description => 'The number of times the close action was taken. The close action aborts the connection as soon as possible. The close action takes effect either right after accept, right after the client hello, or right after the response was sent.',
+        format => '',
+        read_only => 'false',
+            },
+    'ddos_action_blackhole' => {
+        datatype => 'int',
+        base_name => 'ddos_action_blackhole',
+        description => 'The number of times the blackhole action was taken. The blackhole action quietly closes a TCP connection without sending a reset. The blackhole action quietly closes a TCP connection without notifying its peer (all TCP state is dropped).',
+        format => '',
+        read_only => 'false',
+            },
 });
 
 __PACKAGE__->openapi_types( {
@@ -1848,7 +1890,13 @@ __PACKAGE__->openapi_types( {
     'fanout_bereq_body_bytes' => 'int',
     'fanout_beresp_header_bytes' => 'int',
     'fanout_beresp_body_bytes' => 'int',
-    'fanout_conn_time_ms' => 'int'
+    'fanout_conn_time_ms' => 'int',
+    'ddos_action_limit_streams_connections' => 'int',
+    'ddos_action_limit_streams_requests' => 'int',
+    'ddos_action_tarpit_accept' => 'int',
+    'ddos_action_tarpit' => 'int',
+    'ddos_action_close' => 'int',
+    'ddos_action_blackhole' => 'int'
 } );
 
 __PACKAGE__->attribute_map( {
@@ -2062,7 +2110,13 @@ __PACKAGE__->attribute_map( {
     'fanout_bereq_body_bytes' => 'fanout_bereq_body_bytes',
     'fanout_beresp_header_bytes' => 'fanout_beresp_header_bytes',
     'fanout_beresp_body_bytes' => 'fanout_beresp_body_bytes',
-    'fanout_conn_time_ms' => 'fanout_conn_time_ms'
+    'fanout_conn_time_ms' => 'fanout_conn_time_ms',
+    'ddos_action_limit_streams_connections' => 'ddos_action_limit_streams_connections',
+    'ddos_action_limit_streams_requests' => 'ddos_action_limit_streams_requests',
+    'ddos_action_tarpit_accept' => 'ddos_action_tarpit_accept',
+    'ddos_action_tarpit' => 'ddos_action_tarpit',
+    'ddos_action_close' => 'ddos_action_close',
+    'ddos_action_blackhole' => 'ddos_action_blackhole'
 } );
 
 __PACKAGE__->mk_accessors(keys %{__PACKAGE__->attribute_map});