Generated v6.2.0

fastly · Oct 24, 2023 · 4fe9a1f · 4fe9a1f
1 parent 7a32aee
commit 4fe9a1f
Show file tree

Hide file tree

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

diff --git a/README.md b/README.md
@@ -214,10 +214,10 @@ Class | Method | Description
 *Fastly.InvitationsApi* | [**createInvitation**](docs/InvitationsApi.md#createInvitation) | Create an invitation
 *Fastly.InvitationsApi* | [**deleteInvitation**](docs/InvitationsApi.md#deleteInvitation) | Delete an invitation
 *Fastly.InvitationsApi* | [**listInvitations**](docs/InvitationsApi.md#listInvitations) | List invitations
-*Fastly.KvStoreApi* | [**createStore**](docs/KvStoreApi.md#createStore) | Create an kv store.
-*Fastly.KvStoreApi* | [**deleteStore**](docs/KvStoreApi.md#deleteStore) | Delete an kv store.
-*Fastly.KvStoreApi* | [**getStore**](docs/KvStoreApi.md#getStore) | Describe an kv store.
-*Fastly.KvStoreApi* | [**getStores**](docs/KvStoreApi.md#getStores) | List kv stores.
+*Fastly.KvStoreApi* | [**createStore**](docs/KvStoreApi.md#createStore) | Create a KV store.
+*Fastly.KvStoreApi* | [**deleteStore**](docs/KvStoreApi.md#deleteStore) | Delete a KV store.
+*Fastly.KvStoreApi* | [**getStore**](docs/KvStoreApi.md#getStore) | Describe a KV store.
+*Fastly.KvStoreApi* | [**getStores**](docs/KvStoreApi.md#getStores) | List KV stores.
 *Fastly.KvStoreItemApi* | [**deleteKeyFromStore**](docs/KvStoreItemApi.md#deleteKeyFromStore) | Delete kv store item.
 *Fastly.KvStoreItemApi* | [**getKeys**](docs/KvStoreItemApi.md#getKeys) | List kv store keys.
 *Fastly.KvStoreItemApi* | [**getValueForKey**](docs/KvStoreItemApi.md#getValueForKey) | Get the value of an kv store item
@@ -575,6 +575,7 @@ Class | Method | Description
 *Fastly.WafRulesApi* | [**getWafRule**](docs/WafRulesApi.md#getWafRule) | Get a rule
 *Fastly.WafRulesApi* | [**listWafRules**](docs/WafRulesApi.md#listWafRules) | List available WAF rules
 *Fastly.WafTagsApi* | [**listWafTags**](docs/WafTagsApi.md#listWafTags) | List tags
+*Fastly.WholePlatformDdosHistoricalApi* | [**getPlatformDdosHistorical**](docs/WholePlatformDdosHistoricalApi.md#getPlatformDdosHistorical) | Get historical DDoS metrics for the entire Fastly platform
 
 
 ## Issues

diff --git a/docs/HistoricalDdos.md b/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** | [**[PlatformDdosDataItems]**](PlatformDdosDataItems.md) | A list of [entries](#entry-data-model). | [optional] 
+
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
diff --git a/docs/HistoricalDdosMeta.md b/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)
diff --git a/docs/HistoricalFieldResultsAttributes.md b/docs/HistoricalFieldResultsAttributes.md
@@ -220,6 +220,15 @@ Name | Type | Description | Notes
 **ddos_action_tarpit** | **Number** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] 
 **ddos_action_close** | **Number** | 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** | **Number** | 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** | **Number** | The number of challenge-start tokens created. | [optional] 
+**bot_challenge_complete_tokens_passed** | **Number** | The number of challenge-complete tokens that passed validation. | [optional] 
+**bot_challenge_complete_tokens_failed** | **Number** | The number of challenge-complete tokens that failed validation. | [optional] 
+**bot_challenge_complete_tokens_checked** | **Number** | The number of challenge-complete tokens checked. | [optional] 
+**bot_challenge_complete_tokens_disabled** | **Number** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] 
+**bot_challenge_complete_tokens_issued** | **Number** | 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** | **Number** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] 
+**bot_challenges_succeeded** | **Number** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] 
+**bot_challenges_failed** | **Number** | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | [optional] 
 **service_id** | [**ReadOnlyIdService**](ReadOnlyIdService.md) |  | [optional] 
 **start_time** | **Number** |  | [optional] 
 

diff --git a/docs/KvStoreApi.md b/docs/KvStoreApi.md
@@ -7,10 +7,10 @@ const apiInstance = new Fastly.KvStoreApi();
 
 Method | Fastly API endpoint | Description
 ------------- | ------------- | -------------
-[**createStore**](KvStoreApi.md#createStore) | **POST** /resources/stores/kv | Create an kv store.
-[**deleteStore**](KvStoreApi.md#deleteStore) | **DELETE** /resources/stores/kv/{store_id} | Delete an kv store.
-[**getStore**](KvStoreApi.md#getStore) | **GET** /resources/stores/kv/{store_id} | Describe an kv store.
-[**getStores**](KvStoreApi.md#getStores) | **GET** /resources/stores/kv | List kv stores.
+[**createStore**](KvStoreApi.md#createStore) | **POST** /resources/stores/kv | Create a KV store.
+[**deleteStore**](KvStoreApi.md#deleteStore) | **DELETE** /resources/stores/kv/{store_id} | Delete a KV store.
+[**getStore**](KvStoreApi.md#getStore) | **GET** /resources/stores/kv/{store_id} | Describe a KV store.
+[**getStores**](KvStoreApi.md#getStores) | **GET** /resources/stores/kv | List KV stores.
 
 
 ## `createStore`
@@ -19,7 +19,7 @@ Method | Fastly API endpoint | Description
 createStore({ , [location, ][store] })
 ```
 
-Create a new kv store.
+Create a new KV store.
 
 ### Example
 
@@ -56,7 +56,7 @@ Name | Type | Description  | Notes
 deleteStore({ store_id })
 ```
 
-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).
 
 ### Example
 
@@ -91,7 +91,7 @@ null (empty response body)
 getStore({ store_id })
 ```
 
-Get an kv store by ID.
+Get a KV store by ID.
 
 ### Example
 

diff --git a/docs/LoggingLogentriesAdditional.md b/docs/LoggingLogentriesAdditional.md
@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **port** | **Number** | The port number. | [optional]  [defaults 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] 
 **region** | **String** | The region to which to stream logs. | [optional]  [one of: "US", "US-2", "US-3", "EU", "CA", "AU", "AP"]
 

diff --git a/docs/LoggingLogentriesApi.md b/docs/LoggingLogentriesApi.md
@@ -60,7 +60,7 @@ Name | Type | Description  | Notes
 **format** | **String** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). | [optional] [defaults to '%h %l %u %t "%r" %&gt;s %b']
 **format_version** | **Number** | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.  | [optional] [one of: 1, 2]
 **port** | **Number** | The port number. | [optional] [defaults 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]
 **region** | **String** | The region to which to stream logs. | [optional] [one of: "US", "US-2", "US-3", "EU", "CA", "AU", "AP"]
 
@@ -232,7 +232,7 @@ Name | Type | Description  | Notes
 **format** | **String** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). | [optional] [defaults to '%h %l %u %t "%r" %&gt;s %b']
 **format_version** | **Number** | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.  | [optional] [one of: 1, 2]
 **port** | **Number** | The port number. | [optional] [defaults 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]
 **region** | **String** | The region to which to stream logs. | [optional] [one of: "US", "US-2", "US-3", "EU", "CA", "AU", "AP"]
 

diff --git a/docs/LoggingLogentriesResponse.md b/docs/LoggingLogentriesResponse.md
@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 **format** | **String** | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats). | [optional]  [defaults to '%h %l %u %t "%r" %&gt;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]  [one of: "1", "2"]
 **port** | **Number** | The port number. | [optional]  [defaults 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] 
 **region** | **String** | The region to which to stream logs. | [optional]  [one of: "US", "US-2", "US-3", "EU", "CA", "AU", "AP"]
 **created_at** | **Date** | Date and time in ISO 8601 format. | [optional] [readonly] 

diff --git a/docs/PlatformDdosDataItems.md b/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)
diff --git a/docs/PlatformDdosEntry.md b/docs/PlatformDdosEntry.md
@@ -0,0 +1,10 @@
+# Fastly.PlatformDdosEntry
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**values** | [**[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)
diff --git a/docs/PlatformDdosResponse.md b/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** | [**[PlatformDdosEntry]**](PlatformDdosEntry.md) | A list of timeseries. | [optional] 
+
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
diff --git a/docs/PlatformDdosResponseAllOf.md b/docs/PlatformDdosResponseAllOf.md
@@ -0,0 +1,10 @@
+# Fastly.PlatformDdosResponseAllOf
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | [**[PlatformDdosEntry]**](PlatformDdosEntry.md) | A list of timeseries. | [optional] 
+
+
+[[Back to API list]](../../README.md#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** | **Number** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] 
 **ddos_action_close** | **Number** | 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** | **Number** | 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** | **Number** | The number of challenge-start tokens created. | [optional] 
+**bot_challenge_complete_tokens_passed** | **Number** | The number of challenge-complete tokens that passed validation. | [optional] 
+**bot_challenge_complete_tokens_failed** | **Number** | The number of challenge-complete tokens that failed validation. | [optional] 
+**bot_challenge_complete_tokens_checked** | **Number** | The number of challenge-complete tokens checked. | [optional] 
+**bot_challenge_complete_tokens_disabled** | **Number** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] 
+**bot_challenges_issued** | **Number** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] 
+**bot_challenges_succeeded** | **Number** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] 
+**bot_challenges_failed** | **Number** | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | [optional] 
+**bot_challenge_complete_tokens_issued** | **Number** | 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)
diff --git a/docs/RealtimeMeasurements.md b/docs/RealtimeMeasurements.md
@@ -222,6 +222,15 @@ Name | Type | Description | Notes
 **ddos_action_tarpit** | **Number** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] 
 **ddos_action_close** | **Number** | 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** | **Number** | 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** | **Number** | The number of challenge-start tokens created. | [optional] 
+**bot_challenge_complete_tokens_passed** | **Number** | The number of challenge-complete tokens that passed validation. | [optional] 
+**bot_challenge_complete_tokens_failed** | **Number** | The number of challenge-complete tokens that failed validation. | [optional] 
+**bot_challenge_complete_tokens_checked** | **Number** | The number of challenge-complete tokens checked. | [optional] 
+**bot_challenge_complete_tokens_disabled** | **Number** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] 
+**bot_challenges_issued** | **Number** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] 
+**bot_challenges_succeeded** | **Number** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] 
+**bot_challenges_failed** | **Number** | The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution. | [optional] 
+**bot_challenge_complete_tokens_issued** | **Number** | 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)
diff --git a/docs/Results.md b/docs/Results.md
@@ -220,6 +220,15 @@ Name | Type | Description | Notes
 **ddos_action_tarpit** | **Number** | The number of times the tarpit action was taken. The tarpit action delays writing the response to the client. | [optional] 
 **ddos_action_close** | **Number** | 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** | **Number** | 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** | **Number** | The number of challenge-start tokens created. | [optional] 
+**bot_challenge_complete_tokens_passed** | **Number** | The number of challenge-complete tokens that passed validation. | [optional] 
+**bot_challenge_complete_tokens_failed** | **Number** | The number of challenge-complete tokens that failed validation. | [optional] 
+**bot_challenge_complete_tokens_checked** | **Number** | The number of challenge-complete tokens checked. | [optional] 
+**bot_challenge_complete_tokens_disabled** | **Number** | The number of challenge-complete tokens not checked because the feature was disabled. | [optional] 
+**bot_challenge_complete_tokens_issued** | **Number** | 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** | **Number** | The number of challenges issued. For example, the issuance of a CAPTCHA challenge. | [optional] 
+**bot_challenges_succeeded** | **Number** | The number of successful challenge solutions processed. For example, a correct CAPTCHA solution. | [optional] 
+**bot_challenges_failed** | **Number** | 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)