Generated v2.2.0

Author: github-actions

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [v2.2.0](https://github.com/fastly/fastly-py/releases/tag/release/v2.2.0) (2023-06-20)
+
+**Enhancements:**
+
+- feat(realtime_measurements): add billable request processing time.
+- feat(tokens): add support for the 'get token' endpoint.
+
+**Bug fixes:**
+
+- fix(config): add realtime hostname.
+- fix(historical_stats): generate field results model.
+- fix(kv_store): remove the 'force' property from the 'delete store' endpoint.
+- feat(realtime_measurements): rename object store to kv store.
+
 ## [v2.1.1](https://github.com/fastly/fastly-py/releases/tag/release/v2.1.1) (2023-05-22)
 
 **Bug fixes:**

README.md

@@ -2,6 +2,7 @@
 
 A Python client library for interacting with most facets of the [Fastly API](https://developer.fastly.com/reference/api).
 
+
 ## Requirements
 
 Python >=3.6
@@ -428,6 +429,7 @@ Class | Method | HTTP request | Description
 *TlsSubscriptionsApi* | [**get_tls_sub**](docs/TlsSubscriptionsApi.md#get_tls_sub) | **GET** /tls/subscriptions/{tls_subscription_id} | Get a TLS subscription
 *TlsSubscriptionsApi* | [**list_tls_subs**](docs/TlsSubscriptionsApi.md#list_tls_subs) | **GET** /tls/subscriptions | List TLS subscriptions
 *TlsSubscriptionsApi* | [**patch_tls_sub**](docs/TlsSubscriptionsApi.md#patch_tls_sub) | **PATCH** /tls/subscriptions/{tls_subscription_id} | Update a TLS subscription
+*TokensApi* | [**get_token**](docs/TokensApi.md#get_token) | **GET** /tokens/{token_id} | Get a token
 *TokensApi* | [**get_token_current**](docs/TokensApi.md#get_token_current) | **GET** /tokens/self | Get the current token
 *TokensApi* | [**list_tokens_customer**](docs/TokensApi.md#list_tokens_customer) | **GET** /customer/{customer_id}/tokens | List tokens for a customer
 *TokensApi* | [**list_tokens_user**](docs/TokensApi.md#list_tokens_user) | **GET** /tokens | List tokens for the authenticated user

docs/HistoricalFieldResults.md

@@ -4,7 +4,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**value** | **[{str: (str,)}]** |  | 
+**value** | [**[HistoricalFieldResultsAttributes]**](HistoricalFieldResultsAttributes.md) |  | 
 
 [[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/HistoricalFieldResultsAttributes.md

@@ -0,0 +1,13 @@
+# HistoricalFieldResultsAttributesAllOf
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**service_id** | **bool, date, datetime, dict, float, int, list, str, none_type** |  | [optional] [readonly] 
+**start_time** | **int** |  | [optional] 
+**any string name** | **bool, date, datetime, dict, float, int, list, str, none_type** | any string name can be used but the value must be the correct type | [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/HistoricalFieldResultsAttributesAllOf.md

@@ -132,22 +132,13 @@ with fastly.ApiClient(configuration) as api_client:
     # Create an instance of the API class
     api_instance = kv_store_api.KvStoreApi(api_client)
     store_id = "store_id_example" # str | 
-    force = True # bool |  (optional)
 
     # example passing only required values which don't have defaults set
     try:
         # Delete an kv store.
         api_instance.delete_store(store_id)
     except fastly.ApiException as e:
         print("Exception when calling KvStoreApi->delete_store: %s\n" % e)
-
-    # example passing only required values which don't have defaults set
-    # and optional values
-    try:
-        # Delete an kv store.
-        api_instance.delete_store(store_id, force=force)
-    except fastly.ApiException as e:
-        print("Exception when calling KvStoreApi->delete_store: %s\n" % e)
 ```
 
 
@@ -156,7 +147,6 @@ with fastly.ApiClient(configuration) as api_client:
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **store_id** | **str**|  |
- **force** | **bool**|  | [optional]
 
 ### Return type
 

docs/KvStoreApi.md

@@ -49,22 +49,13 @@ with fastly.ApiClient(configuration) as api_client:
     api_instance = kv_store_item_api.KvStoreItemApi(api_client)
     store_id = "store_id_example" # str | 
     key_name = "key_name_example" # str | 
-    force = True # bool |  (optional)
 
     # example passing only required values which don't have defaults set
     try:
         # Delete kv store item.
         api_instance.delete_key_from_store(store_id, key_name)
     except fastly.ApiException as e:
         print("Exception when calling KvStoreItemApi->delete_key_from_store: %s\n" % e)
-
-    # example passing only required values which don't have defaults set
-    # and optional values
-    try:
-        # Delete kv store item.
-        api_instance.delete_key_from_store(store_id, key_name, force=force)
-    except fastly.ApiException as e:
-        print("Exception when calling KvStoreItemApi->delete_key_from_store: %s\n" % e)
 ```
 
 
@@ -74,7 +65,6 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **store_id** | **str**|  |
  **key_name** | **str**|  |
- **force** | **bool**|  | [optional]
 
 ### Return type
 

docs/KvStoreItemApi.md

@@ -24,6 +24,7 @@ Name | Type | Description | Notes
 **compute_execution_time_ms** | **float** | The amount of active CPU time used to process your requests (in milliseconds). | [optional] 
 **compute_ram_used** | **int** | The amount of RAM used for your service by Fastly (in bytes). | [optional] 
 **compute_request_time_ms** | **float** | The total, actual amount of time used to process your requests, including active CPU time (in milliseconds). | [optional] 
+**compute_request_time_billed_ms** | **float** | The total amount of request processing time you will be billed for, measured in 50 millisecond increments. | [optional] 
 **shield** | **int** | Number of requests from edge to the shield POP. | [optional] 
 **ipv6** | **int** | Number of requests that were received over IPv6. | [optional] 
 **imgopto** | **int** | Number of responses that came from the Fastly Image Optimizer service. If the service receives 10 requests for an image, this stat will be 10 regardless of how many times the image was transformed. | [optional] 
@@ -203,10 +204,10 @@ Name | Type | Description | Notes
 **websocket_resp_body_bytes** | **int** | Total message content bytes sent to end users over passthrough WebSocket connections. | [optional] 
 **fanout_recv_publishes** | **int** | Total published messages received from the publish API endpoint. | [optional] 
 **fanout_send_publishes** | **int** | Total published messages sent to end users. | [optional] 
-**object_store_class_a_operations** | **int** | The total number of class a operations for the object store. | [optional] 
-**object_store_class_b_operations** | **int** | The total number of class b operations for the object store. | [optional] 
-**object_store_read_requests** | **int** | Use object_store_class_b_operations. | [optional] 
-**object_store_write_requests** | **int** | Use object_store_class_a_operations. | [optional] 
+**kv_store_class_a_operations** | **int** | The total number of class a operations for the KV store. | [optional] 
+**kv_store_class_b_operations** | **int** | The total number of class b operations for the KV store. | [optional] 
+**object_store_class_a_operations** | **int** | Use kv_store_class_a_operations. | [optional] 
+**object_store_class_b_operations** | **int** | Use kv_store_class_b_operations. | [optional] 
 **fanout_req_header_bytes** | **int** | Total header bytes received from end users over Fanout connections. | [optional] 
 **fanout_req_body_bytes** | **int** | Total body or message content bytes received from end users over Fanout connections. | [optional] 
 **fanout_resp_header_bytes** | **int** | Total header bytes sent to end users over Fanout connections. | [optional] 

docs/RealtimeMeasurements.md

@@ -155,6 +155,7 @@ Name | Type | Description | Notes
 **segblock_shield_fetches** | **int** | Number of `Range` requests to a shield for segments of resources when using segmented caching. | [optional] 
 **compute_requests** | **int** | The total number of requests that were received for your service by Fastly. | [optional] 
 **compute_request_time_ms** | **float** | The total, actual amount of time used to process your requests, including active CPU time (in milliseconds). | [optional] 
+**compute_request_time_billed_ms** | **float** | The total amount of request processing time you will be billed for, measured in 50 millisecond increments. | [optional] 
 **compute_ram_used** | **int** | The amount of RAM used for your service by Fastly (in bytes). | [optional] 
 **compute_execution_time_ms** | **float** | The amount of active CPU time used to process your requests (in milliseconds). | [optional] 
 **compute_req_header_bytes** | **int** | Total header bytes received by Compute@Edge. | [optional] 
@@ -201,10 +202,10 @@ Name | Type | Description | Notes
 **websocket_conn_time_ms** | **int** | Total duration of passthrough WebSocket connections with end users. | [optional] 
 **fanout_recv_publishes** | **int** | Total published messages received from the publish API endpoint. | [optional] 
 **fanout_send_publishes** | **int** | Total published messages sent to end users. | [optional] 
-**object_store_class_a_operations** | **int** | The total number of class a operations for the object store. | [optional] 
-**object_store_class_b_operations** | **int** | The total number of class b operations for the object store. | [optional] 
-**object_store_read_requests** | **int** | Use object_store_class_b_operations. | [optional] 
-**object_store_write_requests** | **int** | Use object_store_class_a_operations. | [optional] 
+**kv_store_class_a_operations** | **int** | The total number of class a operations for the KV store. | [optional] 
+**kv_store_class_b_operations** | **int** | The total number of class b operations for the KV store. | [optional] 
+**object_store_class_a_operations** | **int** | Use kv_store_class_a_operations. | [optional] 
+**object_store_class_b_operations** | **int** | Use kv_store_class_b_operations. | [optional] 
 **fanout_req_header_bytes** | **int** | Total header bytes received from end users over Fanout connections. | [optional] 
 **fanout_req_body_bytes** | **int** | Total body or message content bytes received from end users over Fanout connections. | [optional] 
 **fanout_resp_header_bytes** | **int** | Total header bytes sent to end users over Fanout connections. | [optional] 

docs/Results.md

@@ -4,13 +4,96 @@ All URIs are relative to *https://api.fastly.com*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
+[**get_token**](TokensApi.md#get_token) | **GET** /tokens/{token_id} | Get a token
 [**get_token_current**](TokensApi.md#get_token_current) | **GET** /tokens/self | Get the current token
 [**list_tokens_customer**](TokensApi.md#list_tokens_customer) | **GET** /customer/{customer_id}/tokens | List tokens for a customer
 [**list_tokens_user**](TokensApi.md#list_tokens_user) | **GET** /tokens | List tokens for the authenticated user
 [**revoke_token**](TokensApi.md#revoke_token) | **DELETE** /tokens/{token_id} | Revoke a token
 [**revoke_token_current**](TokensApi.md#revoke_token_current) | **DELETE** /tokens/self | Revoke the current token
 
 
+# **get_token**
+> TokenResponse get_token(token_id)
+
+Get a token
+
+Get a single token by its id.
+
+### Example
+
+* Api Key Authentication (token):
+
+```python
+import time
+import fastly
+from fastly.api import tokens_api
+from fastly.model.generic_token_error import GenericTokenError
+from fastly.model.token_response import TokenResponse
+from pprint import pprint
+# Defining the host is optional and defaults to https://api.fastly.com
+# See configuration.py for a list of all supported configuration parameters.
+configuration = fastly.Configuration(
+    host = "https://api.fastly.com"
+)
+
+# The client must configure the authentication and authorization parameters
+# in accordance with the API server security policy.
+# Examples for each auth method are provided below, use the example that
+# satisfies your auth use case.
+
+# Configure API key authorization: token
+configuration.api_key['token'] = 'YOUR_API_KEY'
+
+# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
+# configuration.api_key_prefix['token'] = 'Bearer'
+
+# Enter a context with an instance of the API client
+with fastly.ApiClient(configuration) as api_client:
+    # Create an instance of the API class
+    api_instance = tokens_api.TokensApi(api_client)
+    token_id = "5Yo3XXnrQpjc20u0ybrf2g" # str | Alphanumeric string identifying a token.
+
+    # example passing only required values which don't have defaults set
+    try:
+        # Get a token
+        api_response = api_instance.get_token(token_id)
+        pprint(api_response)
+    except fastly.ApiException as e:
+        print("Exception when calling TokensApi->get_token: %s\n" % e)
+```
+
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **token_id** | **str**| Alphanumeric string identifying a token. |
+
+### Return type
+
+[**TokenResponse**](TokenResponse.md)
+
+### Authorization
+
+[token](../README.md#token)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | OK |  -  |
+**401** | Missing or expired token. |  -  |
+**403** | Invalid token. |  -  |
+**404** | Token lookup failed. |  -  |
+
+[[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_token_current**
 > TokenResponse get_token_current()