fastly 5.3.1 → 6.0.1

data/docs/DomainInspectorRealtimeApi.md

@@ -0,0 +1,132 @@
+# Fastly::DomainInspectorRealtimeApi
+
+
+```ruby
+require 'fastly'
+api_instance = Fastly::DomainInspectorRealtimeApi.new
+```
+
+## Methods
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**get_domain_inspector_last120_seconds**](DomainInspectorRealtimeApi.md#get_domain_inspector_last120_seconds) | **GET** /v1/domains/{service_id}/ts/h | Get real-time domain data for the last 120 seconds |
+| [**get_domain_inspector_last_max_entries**](DomainInspectorRealtimeApi.md#get_domain_inspector_last_max_entries) | **GET** /v1/domains/{service_id}/ts/h/limit/{max_entries} | Get a limited number of real-time domain data entries |
+| [**get_domain_inspector_last_second**](DomainInspectorRealtimeApi.md#get_domain_inspector_last_second) | **GET** /v1/domains/{service_id}/ts/{start_timestamp} | Get real-time domain data from a specified time |
+
+
+## `get_domain_inspector_last120_seconds()`
+
+```ruby
+get_domain_inspector_last120_seconds(opts): <DomainInspector> # Get real-time domain data for the last 120 seconds
+```
+
+Get data for the 120 seconds preceding the latest timestamp available for a service.
+
+### Examples
+
+```ruby
+api_instance = Fastly::DomainInspectorRealtimeApi.new
+opts = {
+    service_id: 'service_id_example', # String | Alphanumeric string identifying the service.
+}
+
+begin
+  # Get real-time domain data for the last 120 seconds
+  result = api_instance.get_domain_inspector_last120_seconds(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling DomainInspectorRealtimeApi->get_domain_inspector_last120_seconds: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **service_id** | **String** | Alphanumeric string identifying the service. |  |
+
+### Return type
+
+[**DomainInspector**](DomainInspector.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+## `get_domain_inspector_last_max_entries()`
+
+```ruby
+get_domain_inspector_last_max_entries(opts): <DomainInspector> # Get a limited number of real-time domain data entries
+```
+
+Get data for the `max_entries` seconds preceding the latest timestamp available for a service, up to a maximum of 120 entries.
+
+### Examples
+
+```ruby
+api_instance = Fastly::DomainInspectorRealtimeApi.new
+opts = {
+    service_id: 'service_id_example', # String | Alphanumeric string identifying the service.
+    max_entries: 1, # Integer | Maximum number of results to show.
+}
+
+begin
+  # Get a limited number of real-time domain data entries
+  result = api_instance.get_domain_inspector_last_max_entries(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling DomainInspectorRealtimeApi->get_domain_inspector_last_max_entries: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **service_id** | **String** | Alphanumeric string identifying the service. |  |
+| **max_entries** | **Integer** | Maximum number of results to show. |  |
+
+### Return type
+
+[**DomainInspector**](DomainInspector.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+## `get_domain_inspector_last_second()`
+
+```ruby
+get_domain_inspector_last_second(opts): <DomainInspector> # Get real-time domain data from a specified time
+```
+
+Get real-time domain data for the specified reporting period. Specify `0` to get a single entry for the last complete second. The `Timestamp` field included in the response provides the time index of the latest entry in the dataset and can be provided as the `start_timestamp` of the next request for a seamless continuation of the dataset from one request to the next. Due to processing latency, the earliest entry in the response dataset may be earlier than `start_timestamp` by the value of `AggregateDelay`. 
+
+### Examples
+
+```ruby
+api_instance = Fastly::DomainInspectorRealtimeApi.new
+opts = {
+    service_id: 'service_id_example', # String | Alphanumeric string identifying the service.
+    start_timestamp: 56, # Integer | Timestamp in seconds (Unix epoch time).
+}
+
+begin
+  # Get real-time domain data from a specified time
+  result = api_instance.get_domain_inspector_last_second(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling DomainInspectorRealtimeApi->get_domain_inspector_last_second: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **service_id** | **String** | Alphanumeric string identifying the service. |  |
+| **start_timestamp** | **Integer** | Timestamp in seconds (Unix epoch time). |  |
+
+### Return type
+
+[**DomainInspector**](DomainInspector.md)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)

data/docs/DomainInspectorRealtimeEntry.md

@@ -0,0 +1,12 @@
+# Fastly::DomainInspectorRealtimeEntry
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **recorded** | [**RecordedTimestamp**](RecordedTimestamp.md) |  | [optional] |
+| **aggregated** | [**Hash<String, DomainInspectorMeasurements>**](DomainInspectorMeasurements.md) | Groups [measurements](#measurements-data-model) by backend name and then by IP address. | [optional] |
+| **datacenter** | **Hash<String, Hash<String, DomainInspectorMeasurements>>** | Groups [measurements](#measurements-data-model) by POP, then backend name, and then IP address. See the [POPs API](/reference/api/utils/pops/) for details about POP identifiers. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/EventAttributes.md

@@ -10,7 +10,7 @@
 | **description** | **String** | Description of the event. | [optional] |
 | **event_type** | **String** | Type of event. Can be used with `filter[event_type]` | [optional] |
 | **ip** | **String** | IP addresses that the event was requested from. | [optional] |
-| **metadata** | **Object** | Hash of key value pairs of additional information. | [optional] |
+| **metadata** | **Hash<String, Object>** | Hash of key value pairs of additional information. | [optional] |
 | **service_id** | **String** |  | [optional][readonly] |
 | **user_id** | **String** |  | [optional][readonly] |
 | **token_id** | **String** |  | [optional][readonly] |

data/docs/{EventsResponseAllOf.md → EventData.md}

@@ -1,4 +1,4 @@
-# Fastly::EventsResponseAllOf
+# Fastly::EventData
 
 ## Properties
 

data/docs/HistoricalDomains.md

@@ -0,0 +1,13 @@
+# Fastly::HistoricalDomains
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** | Whether or not we were able to successfully execute the query. | [optional] |
+| **meta** | [**HistoricalDomainsMeta**](HistoricalDomainsMeta.md) |  | [optional] |
+| **msg** | **String** | If the query was not successful, this will provide a string that explains why. | [optional] |
+| **data** | [**Array<HistoricalDomainsData>**](HistoricalDomainsData.md) | A list of [entries](#entry-data-model), each representing one unique combination of dimensions, such as domain, region, or POP. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/HistoricalDomainsData.md

@@ -0,0 +1,11 @@
+# Fastly::HistoricalDomainsData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **dimensions** | [**DomainInspectorEntryDimensions**](DomainInspectorEntryDimensions.md) |  | [optional] |
+| **values** | [**Array<Values>**](Values.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/HistoricalDomainsMeta.md

@@ -0,0 +1,18 @@
+# Fastly::HistoricalDomainsMeta
+
+## 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 `minute`, `hour`, or `day`. | [optional] |
+| **metrics** | **String** | A comma-separated list of the metrics that were requested. | [optional] |
+| **limit** | **Float** | The maximum number of results shown per page. | [optional] |
+| **next_cursor** | **String** | A string that can be used to request the next page of results, if any. | [optional] |
+| **sort** | **String** | A comma-separated list of keys the results are sorted by. | [optional] |
+| **group_by** | **String** | A comma-separated list of dimensions being summed over in the query. | [optional] |
+| **filters** | [**HistoricalDomainsMetaFilters**](HistoricalDomainsMetaFilters.md) |  | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/HistoricalDomainsMetaFilters.md

@@ -0,0 +1,12 @@
+# Fastly::HistoricalDomainsMetaFilters
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **region** | **String** |  | [optional] |
+| **datacenter** | **String** |  | [optional] |
+| **domain** | **String** |  | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/HistoricalDomainsResponse.md

@@ -0,0 +1,13 @@
+# Fastly::HistoricalDomainsResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** | Whether or not we were able to successfully execute the query. | [optional] |
+| **meta** | [**HistoricalDomainsMeta**](HistoricalDomainsMeta.md) |  | [optional] |
+| **msg** | **String** | If the query was not successful, this will provide a string that explains why. | [optional] |
+| **data** | [**Array<DomainInspectorEntry>**](DomainInspectorEntry.md) | A list of timeseries. Each individual timeseries represents a unique combination of dimensions, such as domain, region or POP. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/HistoricalDomainsResponseAllOf.md

@@ -0,0 +1,10 @@
+# Fastly::HistoricalDomainsResponseAllOf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<DomainInspectorEntry>**](DomainInspectorEntry.md) | A list of timeseries. Each individual timeseries represents a unique combination of dimensions, such as domain, region or POP. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/{HistoricalFieldResultsAttributesAllOf.md → HistoricalFieldResultsAttributesAdditional.md}

@@ -1,4 +1,4 @@
-# Fastly::HistoricalFieldResultsAttributesAllOf
+# Fastly::HistoricalFieldResultsAttributesAdditional
 
 ## Properties
 

data/docs/HistoricalOriginsResponse.md

@@ -0,0 +1,13 @@
+# Fastly::HistoricalOriginsResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** | Whether or not we were able to successfully execute the query. | [optional] |
+| **meta** | [**OriginInspectorHistoricalMeta**](OriginInspectorHistoricalMeta.md) |  | [optional] |
+| **msg** | **String** | If the query was not successful, this will provide a string that explains why. | [optional] |
+| **data** | [**Array<OriginInspectorEntry>**](OriginInspectorEntry.md) | A list of timeseries. Each individual timeseries represents a unique combination of dimensions, such as origin host, region or POP. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/HistoricalOriginsResponseAllOf.md

@@ -0,0 +1,10 @@
+# Fastly::HistoricalOriginsResponseAllOf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<OriginInspectorEntry>**](OriginInspectorEntry.md) | A list of timeseries. Each individual timeseries represents a unique combination of dimensions, such as origin host, region or POP. | [optional] |
+
+[[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
+

data/docs/IamRolesApi.md

@@ -10,12 +10,92 @@ api_instance = Fastly::IamRolesApi.new
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**add_role_permissions**](IamRolesApi.md#add_role_permissions) | **POST** /roles/{role_id}/permissions | Add permissions to a role |
+| [**create_a_role**](IamRolesApi.md#create_a_role) | **POST** /roles | Create a role |
 | [**delete_a_role**](IamRolesApi.md#delete_a_role) | **DELETE** /roles/{role_id} | Delete a role |
 | [**get_a_role**](IamRolesApi.md#get_a_role) | **GET** /roles/{role_id} | Get a role |
 | [**list_role_permissions**](IamRolesApi.md#list_role_permissions) | **GET** /roles/{role_id}/permissions | List permissions in a role |
 | [**list_roles**](IamRolesApi.md#list_roles) | **GET** /roles | List roles |
+| [**remove_role_permissions**](IamRolesApi.md#remove_role_permissions) | **DELETE** /roles/{role_id}/permissions | Remove permissions from a role |
+| [**update_a_role**](IamRolesApi.md#update_a_role) | **PATCH** /roles/{role_id} | Update a role |
 
 
+## `add_role_permissions()`
+
+```ruby
+add_role_permissions(opts): Object # Add permissions to a role
+```
+
+Add permissions to a role.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamRolesApi.new
+opts = {
+    role_id: 'role_id_example', # String | Alphanumeric string identifying the role.
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Add permissions to a role
+  result = api_instance.add_role_permissions(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling IamRolesApi->add_role_permissions: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **role_id** | **String** | Alphanumeric string identifying the role. |  |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+**Object**
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+## `create_a_role()`
+
+```ruby
+create_a_role(opts): Object # Create a role
+```
+
+Create a role.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamRolesApi.new
+opts = {
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Create a role
+  result = api_instance.create_a_role(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling IamRolesApi->create_a_role: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+**Object**
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
 ## `delete_a_role()`
 
 ```ruby
@@ -165,3 +245,80 @@ end
 
 [[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
 [[Back to README]](../../README.md)
+## `remove_role_permissions()`
+
+```ruby
+remove_role_permissions(opts) # Remove permissions from a role
+```
+
+Remove permissions from a role.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamRolesApi.new
+opts = {
+    role_id: 'role_id_example', # String | Alphanumeric string identifying the role.
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Remove permissions from a role
+  api_instance.remove_role_permissions(opts)
+rescue Fastly::ApiError => e
+  puts "Error when calling IamRolesApi->remove_role_permissions: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **role_id** | **String** | Alphanumeric string identifying the role. |  |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+nil (empty response body)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+## `update_a_role()`
+
+```ruby
+update_a_role(opts): Object # Update a role
+```
+
+Update a role.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamRolesApi.new
+opts = {
+    role_id: 'role_id_example', # String | Alphanumeric string identifying the role.
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Update a role
+  result = api_instance.update_a_role(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling IamRolesApi->update_a_role: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **role_id** | **String** | Alphanumeric string identifying the role. |  |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+**Object**
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)

data/docs/IamServiceGroupsApi.md

@@ -10,12 +10,92 @@ api_instance = Fastly::IamServiceGroupsApi.new
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**add_service_group_services**](IamServiceGroupsApi.md#add_service_group_services) | **POST** /service-groups/{service_group_id}/services | Add services in a service group |
+| [**create_a_service_group**](IamServiceGroupsApi.md#create_a_service_group) | **POST** /service-groups | Create a service group |
 | [**delete_a_service_group**](IamServiceGroupsApi.md#delete_a_service_group) | **DELETE** /service-groups/{service_group_id} | Delete a service group |
 | [**get_a_service_group**](IamServiceGroupsApi.md#get_a_service_group) | **GET** /service-groups/{service_group_id} | Get a service group |
 | [**list_service_group_services**](IamServiceGroupsApi.md#list_service_group_services) | **GET** /service-groups/{service_group_id}/services | List services to a service group |
 | [**list_service_groups**](IamServiceGroupsApi.md#list_service_groups) | **GET** /service-groups | List service groups |
+| [**remove_service_group_services**](IamServiceGroupsApi.md#remove_service_group_services) | **DELETE** /service-groups/{service_group_id}/services | Remove services from a service group |
+| [**update_a_service_group**](IamServiceGroupsApi.md#update_a_service_group) | **PATCH** /service-groups/{service_group_id} | Update a service group |
 
 
+## `add_service_group_services()`
+
+```ruby
+add_service_group_services(opts): Object # Add services in a service group
+```
+
+Add services in a service group.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamServiceGroupsApi.new
+opts = {
+    service_group_id: 'service_group_id_example', # String | Alphanumeric string identifying the service group.
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Add services in a service group
+  result = api_instance.add_service_group_services(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling IamServiceGroupsApi->add_service_group_services: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **service_group_id** | **String** | Alphanumeric string identifying the service group. |  |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+**Object**
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+## `create_a_service_group()`
+
+```ruby
+create_a_service_group(opts): Object # Create a service group
+```
+
+Create a service group.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamServiceGroupsApi.new
+opts = {
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Create a service group
+  result = api_instance.create_a_service_group(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling IamServiceGroupsApi->create_a_service_group: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+**Object**
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
 ## `delete_a_service_group()`
 
 ```ruby
@@ -169,3 +249,80 @@ end
 
 [[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
 [[Back to README]](../../README.md)
+## `remove_service_group_services()`
+
+```ruby
+remove_service_group_services(opts) # Remove services from a service group
+```
+
+Remove services from a service group.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamServiceGroupsApi.new
+opts = {
+    service_group_id: 'service_group_id_example', # String | Alphanumeric string identifying the service group.
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Remove services from a service group
+  api_instance.remove_service_group_services(opts)
+rescue Fastly::ApiError => e
+  puts "Error when calling IamServiceGroupsApi->remove_service_group_services: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **service_group_id** | **String** | Alphanumeric string identifying the service group. |  |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+nil (empty response body)
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)
+## `update_a_service_group()`
+
+```ruby
+update_a_service_group(opts): Object # Update a service group
+```
+
+Update a service group.
+
+### Examples
+
+```ruby
+api_instance = Fastly::IamServiceGroupsApi.new
+opts = {
+    service_group_id: 'service_group_id_example', # String | Alphanumeric string identifying the service group.
+    request_body: { key: 3.56}, # Hash<String, Object> | 
+}
+
+begin
+  # Update a service group
+  result = api_instance.update_a_service_group(opts)
+  p result
+rescue Fastly::ApiError => e
+  puts "Error when calling IamServiceGroupsApi->update_a_service_group: #{e}"
+end
+```
+
+### Options
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **service_group_id** | **String** | Alphanumeric string identifying the service group. |  |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+
+### Return type
+
+**Object**
+
+[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
+[[Back to README]](../../README.md)