Generated v4.2.0

fastly · Oct 24, 2023 · 55b3b05 · 55b3b05
1 parent 252abc9
commit 55b3b05
Show file tree

Hide file tree

Showing 61 changed files with 1,324 additions and 104 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## [v4.2.0](https://github.com/fastly/fastly-rust/releases/tag/release/v4.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.
+
 ## [v4.1.1](https://github.com/fastly/fastly-rust/releases/tag/release/v4.1.1) (2023-09-01)
 
 **Enhancements:**

diff --git a/Cargo.toml b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "fastly-api"
-version = "4.1.1"
+version = "4.2.0"
 authors = ["Fastly <[email protected]>"]
 edition = "2021"
 description = "Fastly API client"

diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@ Rust 2021 Edition
 Add the following to `Cargo.toml` under `[dependencies]`:
 
 ```toml
-fastly-api = "4.1.1"
+fastly-api = "4.2.0"
 ```
 
 ## Usage
@@ -229,10 +229,10 @@ Class | Method | HTTP request | Description
 *InvitationsApi* | [**create_invitation**](docs/InvitationsApi.md#create_invitation) | **POST** /invitations | Create an invitation
 *InvitationsApi* | [**delete_invitation**](docs/InvitationsApi.md#delete_invitation) | **DELETE** /invitations/{invitation_id} | Delete an invitation
 *InvitationsApi* | [**list_invitations**](docs/InvitationsApi.md#list_invitations) | **GET** /invitations | List invitations
-*KvStoreApi* | [**create_store**](docs/KvStoreApi.md#create_store) | **POST** /resources/stores/kv | Create an kv store.
-*KvStoreApi* | [**delete_store**](docs/KvStoreApi.md#delete_store) | **DELETE** /resources/stores/kv/{store_id} | Delete an kv store.
-*KvStoreApi* | [**get_store**](docs/KvStoreApi.md#get_store) | **GET** /resources/stores/kv/{store_id} | Describe an kv store.
-*KvStoreApi* | [**get_stores**](docs/KvStoreApi.md#get_stores) | **GET** /resources/stores/kv | List kv stores.
+*KvStoreApi* | [**create_store**](docs/KvStoreApi.md#create_store) | **POST** /resources/stores/kv | Create a KV store.
+*KvStoreApi* | [**delete_store**](docs/KvStoreApi.md#delete_store) | **DELETE** /resources/stores/kv/{store_id} | Delete a KV store.
+*KvStoreApi* | [**get_store**](docs/KvStoreApi.md#get_store) | **GET** /resources/stores/kv/{store_id} | Describe a KV store.
+*KvStoreApi* | [**get_stores**](docs/KvStoreApi.md#get_stores) | **GET** /resources/stores/kv | List KV stores.
 *KvStoreItemApi* | [**delete_key_from_store**](docs/KvStoreItemApi.md#delete_key_from_store) | **DELETE** /resources/stores/kv/{store_id}/keys/{key_name} | Delete kv store item.
 *KvStoreItemApi* | [**get_keys**](docs/KvStoreItemApi.md#get_keys) | **GET** /resources/stores/kv/{store_id}/keys | List kv store keys.
 *KvStoreItemApi* | [**get_value_for_key**](docs/KvStoreItemApi.md#get_value_for_key) | **GET** /resources/stores/kv/{store_id}/keys/{key_name} | Get the value of an kv store item
@@ -590,6 +590,7 @@ Class | Method | HTTP request | Description
 *WafRulesApi* | [**get_waf_rule**](docs/WafRulesApi.md#get_waf_rule) | **GET** /waf/rules/{waf_rule_id} | Get a rule
 *WafRulesApi* | [**list_waf_rules**](docs/WafRulesApi.md#list_waf_rules) | **GET** /waf/rules | List available WAF rules
 *WafTagsApi* | [**list_waf_tags**](docs/WafTagsApi.md#list_waf_tags) | **GET** /waf/tags | List tags
+*WholePlatformDdosHistoricalApi* | [**get_platform_ddos_historical**](docs/WholePlatformDdosHistoricalApi.md#get_platform_ddos_historical) | **GET** /metrics/platform/ddos | Get historical DDoS metrics for the entire Fastly platform
 
 
 ## Issues

diff --git a/docs/HistoricalDdos.md b/docs/HistoricalDdos.md
@@ -0,0 +1,14 @@
+# HistoricalDdos
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**status** | Option<**String**> | Whether or not we were able to successfully execute the query. | 
+**meta** | Option<[**crate::models::HistoricalDdosMeta**](HistoricalDdosMeta.md)> |  | 
+**msg** | Option<**String**> | If the query was not successful, this will provide a string that explains why. | 
+**data** | Option<[**Vec&lt;crate::models::PlatformDdosDataItems&gt;**](PlatformDdosDataItems.md)> | A list of [entries](#entry-data-model). | 
+
+[[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+
diff --git a/docs/HistoricalDdosMeta.md b/docs/HistoricalDdosMeta.md
@@ -0,0 +1,14 @@
+# HistoricalDdosMeta
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**start** | Option<**String**> | Start time that was used to perform the query as an ISO-8601-formatted date and time. | 
+**end** | Option<**String**> | End time that was used to perform the query as an ISO-8601-formatted date and time. | 
+**downsample** | Option<**String**> | Downsample that was used to perform the query. One of `hour` or `day`. | 
+**metric** | Option<**String**> | A comma-separated list of the metrics that were requested. | 
+
+[[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+
diff --git a/docs/KvStoreApi.md b/docs/KvStoreApi.md
@@ -4,16 +4,16 @@ All URIs are relative to *https://api.fastly.com*
 
 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
 
-Create a new kv store.
+Create a new KV store.
 
 ```rust
 let cfg = &Configuration::default();
@@ -49,7 +49,7 @@ Name | Type | Description  | Required | Notes
 
 ## delete_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).
 
 ```rust
 let cfg = &Configuration::default();
@@ -84,7 +84,7 @@ Name | Type | Description  | Required | Notes
 
 ## get_store
 
-Get an kv store by ID.
+Get a KV store by ID.
 
 ```rust
 let cfg = &Configuration::default();

diff --git a/docs/LoggingLogentriesAdditional.md b/docs/LoggingLogentriesAdditional.md
@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **port** | Option<**i32**> | The port number. | [default to 20000]
-**token** | Option<**String**> | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). | 
+**token** | Option<**String**> | Use token based authentication. | 
 **use_tls** | Option<[**crate::models::LoggingUseTls**](LoggingUseTls.md)> |  | 
 **region** | Option<**String**> | The region to which to stream logs. | 
 

diff --git a/docs/LoggingLogentriesApi.md b/docs/LoggingLogentriesApi.md
@@ -37,7 +37,7 @@ Name | Type | Description  | Required | Notes
 **format** | Option\<**String**> | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). |  |[default to %h %l %u %t "%r" %&gt;s %b]
 **format_version** | Option\<**i32**> | 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`.  |  |[default to FormatVersion_v2]
 **port** | Option\<**i32**> | The port number. |  |[default to 20000]
-**token** | Option\<**String**> | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). |  |
+**token** | Option\<**String**> | Use token based authentication. |  |
 **use_tls** | Option\<[**crate::models::LoggingUseTls**](logging_use_tls.md)> |  |  |
 **region** | Option\<**String**> | The region to which to stream logs. |  |
 
@@ -193,7 +193,7 @@ Name | Type | Description  | Required | Notes
 **format** | Option\<**String**> | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). |  |[default to %h %l %u %t "%r" %&gt;s %b]
 **format_version** | Option\<**i32**> | 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`.  |  |[default to FormatVersion_v2]
 **port** | Option\<**i32**> | The port number. |  |[default to 20000]
-**token** | Option\<**String**> | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). |  |
+**token** | Option\<**String**> | Use token based authentication. |  |
 **use_tls** | Option\<[**crate::models::LoggingUseTls**](logging_use_tls.md)> |  |  |
 **region** | Option\<**String**> | The region to which to stream logs. |  |
 

diff --git a/docs/LoggingLogentriesResponse.md b/docs/LoggingLogentriesResponse.md
@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 **format** | Option<**String**> | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). | [default to %h %l %u %t "%r" %&gt;s %b]
 **format_version** | Option<**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`.  | [default to FormatVersion_v2]
 **port** | Option<**i32**> | The port number. | [default to 20000]
-**token** | Option<**String**> | Use token based authentication ([https://logentries.com/doc/input-token/](https://logentries.com/doc/input-token/)). | 
+**token** | Option<**String**> | Use token based authentication. | 
 **use_tls** | Option<[**crate::models::LoggingUseTls**](LoggingUseTls.md)> |  | 
 **region** | Option<**String**> | The region to which to stream logs. | 
 **created_at** | Option<**String**> | Date and time in ISO 8601 format. | [readonly]

diff --git a/docs/PlatformDdosDataItems.md b/docs/PlatformDdosDataItems.md
@@ -0,0 +1,11 @@
+# PlatformDdosDataItems
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**values** | Option<[**crate::models::Values**](Values.md)> |  | 
+
+[[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+
diff --git a/docs/PlatformDdosEntry.md b/docs/PlatformDdosEntry.md
@@ -0,0 +1,11 @@
+# PlatformDdosEntry
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**values** | Option<[**Vec&lt;crate::models::ValuesDdos&gt;**](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.  | 
+
+[[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+
diff --git a/docs/PlatformDdosResponse.md b/docs/PlatformDdosResponse.md
@@ -0,0 +1,14 @@
+# PlatformDdosResponse
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**status** | Option<**String**> | Whether or not we were able to successfully execute the query. | 
+**meta** | Option<[**crate::models::HistoricalDdosMeta**](HistoricalDdosMeta.md)> |  | 
+**msg** | Option<**String**> | If the query was not successful, this will provide a string that explains why. | 
+**data** | Option<[**Vec&lt;crate::models::PlatformDdosEntry&gt;**](PlatformDdosEntry.md)> | A list of timeseries. | 
+
+[[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+
diff --git a/docs/PlatformDdosResponseAllOf.md b/docs/PlatformDdosResponseAllOf.md
@@ -0,0 +1,11 @@
+# PlatformDdosResponseAllOf
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | Option<[**Vec&lt;crate::models::PlatformDdosEntry&gt;**](PlatformDdosEntry.md)> | A list of timeseries. | 
+
+[[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+
diff --git a/docs/RealtimeEntryAggregated.md b/docs/RealtimeEntryAggregated.md
@@ -222,6 +222,15 @@ Name | Type | Description | Notes
 **ddos_action_tarpit** | Option<**i32**> | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | 
 **ddos_action_close** | Option<**i32**> | 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. | 
 **ddos_action_blackhole** | Option<**i32**> | 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). | 
+**bot_challenge_starts** | Option<**i32**> | The number of challenge-start tokens created. | 
+**bot_challenge_complete_tokens_passed** | Option<**i32**> | The number of challenge-complete tokens that passed validation. | 
+**bot_challenge_complete_tokens_failed** | Option<**i32**> | The number of challenge-complete tokens that failed validation. | 
+**bot_challenge_complete_tokens_checked** | Option<**i32**> | The number of challenge-complete tokens checked. | 
+**bot_challenge_complete_tokens_disabled** | Option<**i32**> | The number of challenge-complete tokens not checked because the feature was disabled. | 
+**bot_challenges_issued** | Option<**i32**> | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | 
+**bot_challenges_succeeded** | Option<**i32**> | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | 
+**bot_challenges_failed** | Option<**i32**> | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | 
+**bot_challenge_complete_tokens_issued** | Option<**i32**> | The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success. | 
 
 [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

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

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

diff --git a/docs/SchemasSnippetResponse.md b/docs/SchemasSnippetResponse.md
@@ -5,10 +5,10 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **name** | Option<**String**> | The name for the snippet. | 
-**dynamic** | Option<**String**> | Sets the snippet version. | 
 **_type** | Option<**String**> | The location in generated VCL where the snippet should be placed. | 
 **content** | Option<**String**> | The VCL code that specifies exactly what the snippet does. | 
 **priority** | Option<**String**> | Priority determines execution order. Lower numbers execute first. | [default to 100]
+**dynamic** | Option<**String**> | Sets the snippet version. | 
 **created_at** | Option<**String**> | Date and time in ISO 8601 format. | [readonly]
 **deleted_at** | Option<**String**> | Date and time in ISO 8601 format. | [readonly]
 **updated_at** | Option<**String**> | Date and time in ISO 8601 format. | [readonly]

diff --git a/docs/SchemasSnippetResponseCommon.md b/docs/SchemasSnippetResponseCommon.md
@@ -0,0 +1,16 @@
+# SchemasSnippetResponseCommon
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**created_at** | Option<**String**> | Date and time in ISO 8601 format. | [readonly]
+**deleted_at** | Option<**String**> | Date and time in ISO 8601 format. | [readonly]
+**updated_at** | Option<**String**> | Date and time in ISO 8601 format. | [readonly]
+**service_id** | Option<**String**> |  | [readonly]
+**version** | Option<**String**> | String representing the number identifying a version of the service. | [readonly]
+**id** | Option<**String**> |  | [readonly]
+
+[[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+