fastly 7.1.0 → 7.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '05963046f4baeae8c192d334a5527c4248a97a7d5bf1de383dfe9e94dcfce871'
-  data.tar.gz: 4cd53d320fbc8c8c1d896b46eeca7f63a83f92dc6f972feba486cf7a27f2354f
+  metadata.gz: c51fd6de296c895b5292180b11c39a13a37eb55358b496d53032bd1ebac8332d
+  data.tar.gz: 859489fb6bac8a1b724077ef601f8640572b7925cea62f8c24b5b0a1de1401f1
 SHA512:
-  metadata.gz: aa75b2d3bfcfb2d5b42bc731ae31465dd10824fd8013f0de6d9d45f5d0190923f1ff391c63606732cf0ced1c619802f848f731473fc730cc9d7c30d102b44a96
-  data.tar.gz: c2e9eaa6cb121d0bfe5b8662dc41b54a00a52e423f54ceafaf26e127e3b1d91ca4e31fac31b4fb7fb57ea2f0bb3dcfe13073014f2ca0565c69abeec6effb823a
+  metadata.gz: c1fca4d1fffd3f8055f601ba5856f577bb18498960d1c8e2018a83191f540fe1bd2e9590dab39e6e47adfb3e00cc5481834e7a5fdfb929949e38ba2e9c91f4ea
+  data.tar.gz: c68f0ba0192cd4b3a6674e3612cc6fb80bc50cc60800338f7c6076be86951696ac7e2aace7de839ab5b66084205f74bf6a9ae74623577094711eb10657eb3f55

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [v7.2.0](https://github.com/fastly/fastly-ruby/releases/tag/release/v7.2.0) (2023-10-24)
+
+**Enhancements:**
+
+- feat(stats): add historical DDoS metrics.
+- feat(stats): add bot challenges.
+
+**Bug fixes:**
+
+- fix(snippets): ensure POST response's dynamic field is numerical.
+
+## [v7.1.1](https://github.com/fastly/fastly-ruby/releases/tag/release/v7.1.1) (2023-09-01)
+
+**Enhancements:**
+
+- feat(events): support extra created_at filters.
+
 ## [v7.1.0](https://github.com/fastly/fastly-ruby/releases/tag/release/v7.1.0) (2023-09-01)
 
 **Enhancements:**

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fastly (7.1.0)
+    fastly (7.2.0)
       typhoeus (~> 1.0, >= 1.0.1)
 
 GEM
@@ -12,7 +12,7 @@ GEM
     coderay (1.1.3)
     ethon (0.16.0)
       ffi (>= 1.15.0)
-    ffi (1.15.5)
+    ffi (1.16.3)
     jaro_winkler (1.5.4)
     method_source (1.0.0)
     parallel (1.21.0)

data/README.md

@@ -8,7 +8,7 @@ A Ruby client library for interacting with most facets of the [Fastly API](https
 To install via RubyGems, add the following to your project's `Gemfile`:
 
 ```ruby
-gem 'fastly', '~> 7.1.0'
+gem 'fastly', '~> 7.2.0'
 ```
 
 Then run `bundle install`.
@@ -227,10 +227,10 @@ Class | Method | Description
 [*Fastly::InvitationsApi*](docs/InvitationsApi.md) | [**create_invitation**](docs/InvitationsApi.md#create_invitation) | Create an invitation
 [*Fastly::InvitationsApi*](docs/InvitationsApi.md) | [**delete_invitation**](docs/InvitationsApi.md#delete_invitation) | Delete an invitation
 [*Fastly::InvitationsApi*](docs/InvitationsApi.md) | [**list_invitations**](docs/InvitationsApi.md#list_invitations) | List invitations
-[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**create_store**](docs/KvStoreApi.md#create_store) | Create an kv store.
-[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**delete_store**](docs/KvStoreApi.md#delete_store) | Delete an kv store.
-[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**get_store**](docs/KvStoreApi.md#get_store) | Describe an kv store.
-[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**get_stores**](docs/KvStoreApi.md#get_stores) | List kv stores.
+[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**create_store**](docs/KvStoreApi.md#create_store) | Create a KV store.
+[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**delete_store**](docs/KvStoreApi.md#delete_store) | Delete a KV store.
+[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**get_store**](docs/KvStoreApi.md#get_store) | Describe a KV store.
+[*Fastly::KvStoreApi*](docs/KvStoreApi.md) | [**get_stores**](docs/KvStoreApi.md#get_stores) | List KV stores.
 [*Fastly::KvStoreItemApi*](docs/KvStoreItemApi.md) | [**delete_key_from_store**](docs/KvStoreItemApi.md#delete_key_from_store) | Delete kv store item.
 [*Fastly::KvStoreItemApi*](docs/KvStoreItemApi.md) | [**get_keys**](docs/KvStoreItemApi.md#get_keys) | List kv store keys.
 [*Fastly::KvStoreItemApi*](docs/KvStoreItemApi.md) | [**get_value_for_key**](docs/KvStoreItemApi.md#get_value_for_key) | Get the value of an kv store item
@@ -588,6 +588,7 @@ Class | Method | Description
 [*Fastly::WafRulesApi*](docs/WafRulesApi.md) | [**get_waf_rule**](docs/WafRulesApi.md#get_waf_rule) | Get a rule
 [*Fastly::WafRulesApi*](docs/WafRulesApi.md) | [**list_waf_rules**](docs/WafRulesApi.md#list_waf_rules) | List available WAF rules
 [*Fastly::WafTagsApi*](docs/WafTagsApi.md) | [**list_waf_tags**](docs/WafTagsApi.md#list_waf_tags) | List tags
+[*Fastly::WholePlatformDdosHistoricalApi*](docs/WholePlatformDdosHistoricalApi.md) | [**get_platform_ddos_historical**](docs/WholePlatformDdosHistoricalApi.md#get_platform_ddos_historical) | Get historical DDoS metrics for the entire Fastly platform
 
 
 ## Issues

data/docs/EventsApi.md

@@ -70,6 +70,10 @@ opts = {
     filter_user_id: 'filter_user_id_example', # String | Limit the results returned to a specific user.
     filter_token_id: 'filter_token_id_example', # String | Limit the returned events to a specific token.
     filter_created_at: 'filter_created_at_example', # String | Limit the returned events to a specific time frame. Accepts sub-parameters: lt, lte, gt, gte (e.g., filter[created_at][gt]=2022-01-12). 
+    filter_created_at_lte: 'filter_created_at_lte_example', # String | Return events on and before a date and time in ISO 8601 format. 
+    filter_created_at_lt: 'filter_created_at_lt_example', # String | Return events before a date and time in ISO 8601 format. 
+    filter_created_at_gte: 'filter_created_at_gte_example', # String | Return events on and after a date and time in ISO 8601 format. 
+    filter_created_at_gt: 'filter_created_at_gt_example', # String | Return events after a date and time in ISO 8601 format. 
     page_number: 1, # Integer | Current page.
     page_size: 20, # Integer | Number of records per page.
     sort: 'created_at', # String | The order in which to list the results by creation date.
@@ -94,6 +98,10 @@ end
 | **filter_user_id** | **String** | Limit the results returned to a specific user. | [optional] |
 | **filter_token_id** | **String** | Limit the returned events to a specific token. | [optional] |
 | **filter_created_at** | **String** | Limit the returned events to a specific time frame. Accepts sub-parameters: lt, lte, gt, gte (e.g., filter[created_at][gt]=2022-01-12).  | [optional] |
+| **filter_created_at_lte** | **String** | Return events on and before a date and time in ISO 8601 format.  | [optional] |
+| **filter_created_at_lt** | **String** | Return events before a date and time in ISO 8601 format.  | [optional] |
+| **filter_created_at_gte** | **String** | Return events on and after a date and time in ISO 8601 format.  | [optional] |
+| **filter_created_at_gt** | **String** | Return events after a date and time in ISO 8601 format.  | [optional] |
 | **page_number** | **Integer** | Current page. | [optional] |
 | **page_size** | **Integer** | Number of records per page. | [optional][default to 20] |
 | **sort** | **String** | The order in which to list the results by creation date. | [optional][default to 'created_at'] |

data/docs/HistoricalDdos.md

@@ -0,0 +1,13 @@
+# Fastly::HistoricalDdos
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** | Whether or not we were able to successfully execute the query. | [optional] |
+| **meta** | [**HistoricalDdosMeta**](HistoricalDdosMeta.md) |  | [optional] |
+| **msg** | **String** | If the query was not successful, this will provide a string that explains why. | [optional] |
+| **data** | [**Array<PlatformDdosDataItems>**](PlatformDdosDataItems.md) | A list of [entries](#entry-data-model). | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/HistoricalDdosMeta.md

@@ -0,0 +1,13 @@
+# Fastly::HistoricalDdosMeta
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **start** | **String** | Start time that was used to perform the query as an ISO-8601-formatted date and time. | [optional] |
+| **_end** | **String** | End time that was used to perform the query as an ISO-8601-formatted date and time. | [optional] |
+| **downsample** | **String** | Downsample that was used to perform the query. One of `hour` or `day`. | [optional] |
+| **metric** | **String** | A comma-separated list of the metrics that were requested. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/HistoricalFieldResultsAttributes.md

@@ -220,6 +220,15 @@
 | **ddos_action_tarpit** | **Integer** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] |
 | **ddos_action_close** | **Integer** | 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** | **Integer** | 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] |
+| **bot_challenge_starts** | **Integer** | The number of challenge-start tokens created. | [optional] |
+| **bot_challenge_complete_tokens_passed** | **Integer** | The number of challenge-complete tokens that passed validation. | [optional] |
+| **bot_challenge_complete_tokens_failed** | **Integer** | The number of challenge-complete tokens that failed validation. | [optional] |
+| **bot_challenge_complete_tokens_checked** | **Integer** | The number of challenge-complete tokens checked. | [optional] |
+| **bot_challenge_complete_tokens_disabled** | **Integer** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] |
+| **bot_challenge_complete_tokens_issued** | **Integer** | The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success. | [optional] |
+| **bot_challenges_issued** | **Integer** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] |
+| **bot_challenges_succeeded** | **Integer** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] |
+| **bot_challenges_failed** | **Integer** | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | [optional] |
 | **service_id** | [**ReadOnlyIdService**](ReadOnlyIdService.md) |  | [optional] |
 | **start_time** | **Integer** |  | [optional] |
 

data/docs/KvStoreApi.md

@@ -10,19 +10,19 @@ api_instance = Fastly::KvStoreApi.new
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**create_store**](KvStoreApi.md#create_store) | **POST** /resources/stores/kv | Create an kv store. |
-| [**delete_store**](KvStoreApi.md#delete_store) | **DELETE** /resources/stores/kv/{store_id} | Delete an kv store. |
-| [**get_store**](KvStoreApi.md#get_store) | **GET** /resources/stores/kv/{store_id} | Describe an kv store. |
-| [**get_stores**](KvStoreApi.md#get_stores) | **GET** /resources/stores/kv | List kv stores. |
+| [**create_store**](KvStoreApi.md#create_store) | **POST** /resources/stores/kv | Create a KV store. |
+| [**delete_store**](KvStoreApi.md#delete_store) | **DELETE** /resources/stores/kv/{store_id} | Delete a KV store. |
+| [**get_store**](KvStoreApi.md#get_store) | **GET** /resources/stores/kv/{store_id} | Describe a KV store. |
+| [**get_stores**](KvStoreApi.md#get_stores) | **GET** /resources/stores/kv | List KV stores. |
 
 
 ## `create_store()`
 
 ```ruby
-create_store(opts): <StoreResponse> # Create an kv store.
+create_store(opts): <StoreResponse> # Create a KV store.
 ```
 
-Create a new kv store.
+Create a new KV store.
 
 ### Examples
 
@@ -34,7 +34,7 @@ opts = {
 }
 
 begin
-  # Create an kv store.
+  # Create a KV store.
   result = api_instance.create_store(opts)
   p result
 rescue Fastly::ApiError => e
@@ -58,10 +58,10 @@ end
 ## `delete_store()`
 
 ```ruby
-delete_store(opts) # Delete an kv store.
+delete_store(opts) # Delete a KV store.
 ```
 
-An kv store must be empty before it can be deleted.  Deleting an kv store that still contains keys will result in a `409` (Conflict).
+A KV store must be empty before it can be deleted.  Deleting a KV store that still contains keys will result in a `409` (Conflict).
 
 ### Examples
 
@@ -72,7 +72,7 @@ opts = {
 }
 
 begin
-  # Delete an kv store.
+  # Delete a KV store.
   api_instance.delete_store(opts)
 rescue Fastly::ApiError => e
   puts "Error when calling KvStoreApi->delete_store: #{e}"
@@ -94,10 +94,10 @@ nil (empty response body)
 ## `get_store()`
 
 ```ruby
-get_store(opts): <StoreResponse> # Describe an kv store.
+get_store(opts): <StoreResponse> # Describe a KV store.
 ```
 
-Get an kv store by ID.
+Get a KV store by ID.
 
 ### Examples
 
@@ -108,7 +108,7 @@ opts = {
 }
 
 begin
-  # Describe an kv store.
+  # Describe a KV store.
   result = api_instance.get_store(opts)
   p result
 rescue Fastly::ApiError => e
@@ -131,7 +131,7 @@ end
 ## `get_stores()`
 
 ```ruby
-get_stores(opts): <InlineResponse2003> # List kv stores.
+get_stores(opts): <InlineResponse2003> # List KV stores.
 ```
 
 Get all stores for a given customer.
@@ -146,7 +146,7 @@ opts = {
 }
 
 begin
-  # List kv stores.
+  # List KV stores.
   result = api_instance.get_stores(opts)
   p result
 rescue Fastly::ApiError => e

data/docs/LoggingLogentriesAdditional.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **port** | **Integer** | The port number. | [optional][default to 20000] |
-| **token** | **String** | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). | [optional] |
+| **token** | **String** | Use token based authentication. | [optional] |
 | **use_tls** | [**LoggingUseTls**](LoggingUseTls.md) |  | [optional][default to LoggingUseTls::no_tls] |
 | **region** | **String** | The region to which to stream logs. | [optional] |
 

data/docs/LoggingLogentriesApi.md

@@ -38,7 +38,7 @@ opts = {
     format: 'format_example', # String | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats).
     format_version: 1, # Integer | 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`. 
     port: 56, # Integer | The port number.
-    token: 'token_example', # String | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)).
+    token: 'token_example', # String | Use token based authentication.
     use_tls: Fastly::LoggingUseTls::no_tls, # LoggingUseTls | 
     region: 'US', # String | The region to which to stream logs.
 }
@@ -64,7 +64,7 @@ end
 | **format** | **String** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). | [optional][default to '%h %l %u %t \"%r\" %>s %b'] |
 | **format_version** | **Integer** | 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][default to FORMAT_VERSION::v2] |
 | **port** | **Integer** | The port number. | [optional][default to 20000] |
-| **token** | **String** | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). | [optional] |
+| **token** | **String** | Use token based authentication. | [optional] |
 | **use_tls** | [**LoggingUseTls**](LoggingUseTls.md) |  | [optional][default to LoggingUseTls::no_tls] |
 | **region** | **String** | The region to which to stream logs. | [optional] |
 
@@ -217,7 +217,7 @@ opts = {
     format: 'format_example', # String | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats).
     format_version: 1, # Integer | 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`. 
     port: 56, # Integer | The port number.
-    token: 'token_example', # String | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)).
+    token: 'token_example', # String | Use token based authentication.
     use_tls: Fastly::LoggingUseTls::no_tls, # LoggingUseTls | 
     region: 'US', # String | The region to which to stream logs.
 }
@@ -244,7 +244,7 @@ end
 | **format** | **String** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). | [optional][default to '%h %l %u %t \"%r\" %>s %b'] |
 | **format_version** | **Integer** | 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][default to FORMAT_VERSION::v2] |
 | **port** | **Integer** | The port number. | [optional][default to 20000] |
-| **token** | **String** | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). | [optional] |
+| **token** | **String** | Use token based authentication. | [optional] |
 | **use_tls** | [**LoggingUseTls**](LoggingUseTls.md) |  | [optional][default to LoggingUseTls::no_tls] |
 | **region** | **String** | The region to which to stream logs. | [optional] |
 

data/docs/LoggingLogentriesResponse.md

@@ -10,7 +10,7 @@
 | **format** | **String** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). | [optional][default to '%h %l %u %t \"%r\" %>s %b'] |
 | **format_version** | **String** | 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][default to '2'] |
 | **port** | **Integer** | The port number. | [optional][default to 20000] |
-| **token** | **String** | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). | [optional] |
+| **token** | **String** | Use token based authentication. | [optional] |
 | **use_tls** | [**LoggingUseTls**](LoggingUseTls.md) |  | [optional][default to LoggingUseTls::no_tls] |
 | **region** | **String** | The region to which to stream logs. | [optional] |
 | **created_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |

data/docs/PlatformDdosDataItems.md

@@ -0,0 +1,10 @@
+# Fastly::PlatformDdosDataItems
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **values** | [**Values**](Values.md) |  | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/PlatformDdosEntry.md

@@ -0,0 +1,10 @@
+# Fastly::PlatformDdosEntry
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **values** | [**Array<ValuesDdos>**](ValuesDdos.md) | An array of values representing the metric values at each point in time. Note that this dataset is sparse: only the keys with non-zero values will be included in the record.  | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/PlatformDdosResponse.md

@@ -0,0 +1,13 @@
+# Fastly::PlatformDdosResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** | Whether or not we were able to successfully execute the query. | [optional] |
+| **meta** | [**HistoricalDdosMeta**](HistoricalDdosMeta.md) |  | [optional] |
+| **msg** | **String** | If the query was not successful, this will provide a string that explains why. | [optional] |
+| **data** | [**Array<PlatformDdosEntry>**](PlatformDdosEntry.md) | A list of timeseries. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/PlatformDdosResponseAllOf.md

@@ -0,0 +1,10 @@
+# Fastly::PlatformDdosResponseAllOf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<PlatformDdosEntry>**](PlatformDdosEntry.md) | A list of timeseries. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/RealtimeEntryAggregated.md

@@ -222,6 +222,15 @@
 | **ddos_action_tarpit** | **Integer** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] |
 | **ddos_action_close** | **Integer** | 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** | **Integer** | 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] |
+| **bot_challenge_starts** | **Integer** | The number of challenge-start tokens created. | [optional] |
+| **bot_challenge_complete_tokens_passed** | **Integer** | The number of challenge-complete tokens that passed validation. | [optional] |
+| **bot_challenge_complete_tokens_failed** | **Integer** | The number of challenge-complete tokens that failed validation. | [optional] |
+| **bot_challenge_complete_tokens_checked** | **Integer** | The number of challenge-complete tokens checked. | [optional] |
+| **bot_challenge_complete_tokens_disabled** | **Integer** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] |
+| **bot_challenges_issued** | **Integer** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] |
+| **bot_challenges_succeeded** | **Integer** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] |
+| **bot_challenges_failed** | **Integer** | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | [optional] |
+| **bot_challenge_complete_tokens_issued** | **Integer** | The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success. | [optional] |
 
 [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
 

data/docs/RealtimeMeasurements.md

@@ -222,6 +222,15 @@
 | **ddos_action_tarpit** | **Integer** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] |
 | **ddos_action_close** | **Integer** | 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** | **Integer** | 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] |
+| **bot_challenge_starts** | **Integer** | The number of challenge-start tokens created. | [optional] |
+| **bot_challenge_complete_tokens_passed** | **Integer** | The number of challenge-complete tokens that passed validation. | [optional] |
+| **bot_challenge_complete_tokens_failed** | **Integer** | The number of challenge-complete tokens that failed validation. | [optional] |
+| **bot_challenge_complete_tokens_checked** | **Integer** | The number of challenge-complete tokens checked. | [optional] |
+| **bot_challenge_complete_tokens_disabled** | **Integer** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] |
+| **bot_challenges_issued** | **Integer** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] |
+| **bot_challenges_succeeded** | **Integer** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] |
+| **bot_challenges_failed** | **Integer** | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | [optional] |
+| **bot_challenge_complete_tokens_issued** | **Integer** | The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success. | [optional] |
 
 [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
 

data/docs/Results.md

@@ -220,6 +220,15 @@
 | **ddos_action_tarpit** | **Integer** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] |
 | **ddos_action_close** | **Integer** | 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** | **Integer** | 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] |
+| **bot_challenge_starts** | **Integer** | The number of challenge-start tokens created. | [optional] |
+| **bot_challenge_complete_tokens_passed** | **Integer** | The number of challenge-complete tokens that passed validation. | [optional] |
+| **bot_challenge_complete_tokens_failed** | **Integer** | The number of challenge-complete tokens that failed validation. | [optional] |
+| **bot_challenge_complete_tokens_checked** | **Integer** | The number of challenge-complete tokens checked. | [optional] |
+| **bot_challenge_complete_tokens_disabled** | **Integer** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] |
+| **bot_challenge_complete_tokens_issued** | **Integer** | The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success. | [optional] |
+| **bot_challenges_issued** | **Integer** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] |
+| **bot_challenges_succeeded** | **Integer** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] |
+| **bot_challenges_failed** | **Integer** | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | [optional] |
 
 [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
 

data/docs/SchemasSnippetResponse.md

@@ -5,10 +5,10 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **name** | **String** | The name for the snippet. | [optional] |
-| **dynamic** | **String** | Sets the snippet version. | [optional] |
 | **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
 | **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
 | **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to '100'] |
+| **dynamic** | **String** | Sets the snippet version. | [optional] |
 | **created_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
 | **deleted_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
 | **updated_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |

data/docs/SchemasSnippetResponseCommon.md

@@ -0,0 +1,15 @@
+# Fastly::SchemasSnippetResponseCommon
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **created_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **deleted_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **updated_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **service_id** | **String** |  | [optional][readonly] |
+| **version** | **String** | String representing the number identifying a version of the service. | [optional][readonly] |
+| **id** | **String** |  | [optional][readonly] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/Snippet.md

@@ -5,10 +5,10 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **name** | **String** | The name for the snippet. | [optional] |
-| **dynamic** | **String** | Sets the snippet version. | [optional] |
 | **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
 | **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
 | **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to '100'] |
+| **dynamic** | **String** | Sets the snippet version. | [optional] |
 
 [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
 

data/docs/SnippetAllOf.md

@@ -0,0 +1,10 @@
+# Fastly::SnippetAllOf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **dynamic** | **String** | Sets the snippet version. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/SnippetApi.md

@@ -22,7 +22,7 @@ api_instance = Fastly::SnippetApi.new
 ## `create_snippet()`
 
 ```ruby
-create_snippet(opts): <SnippetResponse> # Create a snippet
+create_snippet(opts): <SnippetResponsePost> # Create a snippet
 ```
 
 Create a snippet for a particular service and version.
@@ -35,10 +35,10 @@ opts = {
     service_id: 'service_id_example', # String | Alphanumeric string identifying the service.
     version_id: 56, # Integer | Integer identifying a service version.
     name: 'name_example', # String | The name for the snippet.
-    dynamic: '0', # String | Sets the snippet version.
     type: 'init', # String | The location in generated VCL where the snippet should be placed.
     content: 'content_example', # String | The VCL code that specifies exactly what the snippet does.
     priority: 'priority_example', # String | Priority determines execution order. Lower numbers execute first.
+    dynamic: '0', # String | Sets the snippet version.
 }
 
 begin
@@ -57,14 +57,14 @@ end
 | **service_id** | **String** | Alphanumeric string identifying the service. |  |
 | **version_id** | **Integer** | Integer identifying a service version. |  |
 | **name** | **String** | The name for the snippet. | [optional] |
-| **dynamic** | **String** | Sets the snippet version. | [optional] |
 | **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
 | **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
 | **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to &#39;100&#39;] |
+| **dynamic** | **String** | Sets the snippet version. | [optional] |
 
 ### Return type
 
-[**SnippetResponse**](SnippetResponse.md)
+[**SnippetResponsePost**](SnippetResponsePost.md)
 
 [[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
 [[Back to README]](../../README.md)
@@ -285,10 +285,10 @@ opts = {
     service_id: 'service_id_example', # String | Alphanumeric string identifying the service.
     snippet_id: 'snippet_id_example', # String | Alphanumeric string identifying a VCL Snippet.
     name: 'name_example', # String | The name for the snippet.
-    dynamic: '0', # String | Sets the snippet version.
     type: 'init', # String | The location in generated VCL where the snippet should be placed.
     content: 'content_example', # String | The VCL code that specifies exactly what the snippet does.
     priority: 'priority_example', # String | Priority determines execution order. Lower numbers execute first.
+    dynamic: '0', # String | Sets the snippet version.
 }
 
 begin
@@ -307,10 +307,10 @@ end
 | **service_id** | **String** | Alphanumeric string identifying the service. |  |
 | **snippet_id** | **String** | Alphanumeric string identifying a VCL Snippet. |  |
 | **name** | **String** | The name for the snippet. | [optional] |
-| **dynamic** | **String** | Sets the snippet version. | [optional] |
 | **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
 | **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
 | **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to &#39;100&#39;] |
+| **dynamic** | **String** | Sets the snippet version. | [optional] |
 
 ### Return type
 

data/docs/SnippetCommon.md

@@ -0,0 +1,13 @@
+# Fastly::SnippetCommon
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | The name for the snippet. | [optional] |
+| **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
+| **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
+| **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to '100'] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/SnippetResponse.md

@@ -5,10 +5,10 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **name** | **String** | The name for the snippet. | [optional] |
-| **dynamic** | **String** | Sets the snippet version. | [optional] |
 | **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
 | **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
 | **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to '100'] |
+| **dynamic** | **String** | Sets the snippet version. | [optional] |
 | **created_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
 | **deleted_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
 | **updated_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |

data/docs/SnippetResponseCommon.md

@@ -0,0 +1,15 @@
+# Fastly::SnippetResponseCommon
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **created_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **deleted_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **updated_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **service_id** | **String** |  | [optional][readonly] |
+| **version** | **String** | String representing the number identifying a version of the service. | [optional][readonly] |
+| **id** | **String** |  | [optional][readonly] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/{SnippetResponseAllOf.md → SnippetResponseCommonAllOf.md}

@@ -1,4 +1,4 @@
-# Fastly::SnippetResponseAllOf
+# Fastly::SnippetResponseCommonAllOf
 
 ## Properties
 

data/docs/SnippetResponsePost.md

@@ -0,0 +1,20 @@
+# Fastly::SnippetResponsePost
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | The name for the snippet. | [optional] |
+| **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
+| **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
+| **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to '100'] |
+| **dynamic** | **Float** | Sets the snippet version. | [optional] |
+| **created_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **deleted_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **updated_at** | **Time** | Date and time in ISO 8601 format. | [optional][readonly] |
+| **service_id** | **String** |  | [optional][readonly] |
+| **version** | **String** | String representing the number identifying a version of the service. | [optional][readonly] |
+| **id** | **String** |  | [optional][readonly] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/SnippetWithDynamicNumber.md

@@ -0,0 +1,14 @@
+# Fastly::SnippetWithDynamicNumber
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | The name for the snippet. | [optional] |
+| **type** | **String** | The location in generated VCL where the snippet should be placed. | [optional] |
+| **content** | **String** | The VCL code that specifies exactly what the snippet does. | [optional] |
+| **priority** | **String** | Priority determines execution order. Lower numbers execute first. | [optional][default to '100'] |
+| **dynamic** | **Float** | Sets the snippet version. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+