Skip to content

Commit e793ced

Browse files
author
github-actions
committed
Generated v7.00
1 parent 88c6218 commit e793ced

File tree

113 files changed

+11648
-348
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

113 files changed

+11648
-348
lines changed

Changes

+27
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,32 @@
11
Revision history for https://metacpan.org/dist/WebService-Fastly
22

3+
7.00 2024-12-05
4+
5+
[Breaking Changes]
6+
- fix(udm-domains): Use v1 versioned HTTP endpoints for UDM domains
7+
- fix(historical): Remove references to VCL on Compute metrics
8+
- fix(realtime): Remove references to VCL on Compute metrics
9+
- feat(billing-usage-metrics): Updated to v3 of the API
10+
11+
[Bug fixes]
12+
- fix(acls-in-compute): Corrected shape of `compute-acl-update` model.
13+
14+
[Enhancements]
15+
- feat(object-storage-access-keys): Added Object Storage Access Keys API
16+
- feat(logging-grafanacloudlogs): Added Grafana Cloud Logs Loggin API
17+
- feat(log-explorer): Added Log Explorer API
18+
- feat(insights): Added Insights API
19+
- feat(kv-store-item): Added `consistency` parameter to `get-keys` operation.
20+
- feat(enabled-products): Added `mode` property to `set-configuration`.
21+
22+
[Documentation]
23+
- doc(observability-custom-dashboards): Fix bad link in custom dashboard documentation
24+
- doc(observability-custom-dashboards): Reformat some enums to fix docs rendering
25+
- doc(acls-in-compute): Corrections to descriptions of `compute-acl-lookup`, `compute-acl-list-entries`,
26+
`compute-acl-update-entry`, and `compute-acl-update` structures
27+
- doc(enabled-products): Added support for product ID `log_explorer_insights`.
28+
- doc(enabled-products): Added support for product ID `ddos_protection`.
29+
330
6.11 2024-10-23
431

532
[Documentation]

README.md

+15-4
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ WebService::Fastly - an interface to most facets of the Fastly API (https://www.
44

55
# VERSION
66

7-
6.11
7+
7.00
88

99

1010
# SYNOPSIS
@@ -102,7 +102,7 @@ Class | Method | Description
102102
*BillingInvoicesApi* | [**get_month_to_date_invoice**](docs/BillingInvoicesApi.md#get_month_to_date_invoice) | Get month-to-date invoice.
103103
*BillingInvoicesApi* | [**list_invoices**](docs/BillingInvoicesApi.md#list_invoices) | List of invoices.
104104
*BillingUsageMetricsApi* | [**get_service_level_usage**](docs/BillingUsageMetricsApi.md#get_service_level_usage) | Retrieve service-level usage metrics for a product.
105-
*BillingUsageMetricsApi* | [**get_service_level_usage_types**](docs/BillingUsageMetricsApi.md#get_service_level_usage_types) | Retrieve product usage types for a customer.
105+
*BillingUsageMetricsApi* | [**get_usage_metrics**](docs/BillingUsageMetricsApi.md#get_usage_metrics) | Get monthly usage metrics
106106
*CacheSettingsApi* | [**create_cache_settings**](docs/CacheSettingsApi.md#create_cache_settings) | Create a cache settings object
107107
*CacheSettingsApi* | [**delete_cache_settings**](docs/CacheSettingsApi.md#delete_cache_settings) | Delete a cache settings object
108108
*CacheSettingsApi* | [**get_cache_settings**](docs/CacheSettingsApi.md#get_cache_settings) | Get a cache settings object
@@ -240,6 +240,7 @@ Class | Method | Description
240240
*IamUserGroupsApi* | [**update_a_user_group**](docs/IamUserGroupsApi.md#update_a_user_group) | Update a user group
241241
*ImageOptimizerDefaultSettingsApi* | [**get_default_settings**](docs/ImageOptimizerDefaultSettingsApi.md#get_default_settings) | Get current Image Optimizer Default Settings
242242
*ImageOptimizerDefaultSettingsApi* | [**update_default_settings**](docs/ImageOptimizerDefaultSettingsApi.md#update_default_settings) | Update Image Optimizer Default Settings
243+
*InsightsApi* | [**get_log_insights**](docs/InsightsApi.md#get_log_insights) | Retrieve log insights
243244
*InvitationsApi* | [**create_invitation**](docs/InvitationsApi.md#create_invitation) | Create an invitation
244245
*InvitationsApi* | [**delete_invitation**](docs/InvitationsApi.md#delete_invitation) | Delete an invitation
245246
*InvitationsApi* | [**list_invitations**](docs/InvitationsApi.md#list_invitations) | List invitations
@@ -279,6 +280,7 @@ Class | Method | Description
279280
*LegacyWafTagApi* | [**list_legacy_waf_tags**](docs/LegacyWafTagApi.md#list_legacy_waf_tags) | List WAF tags
280281
*LegacyWafUpdateStatusApi* | [**get_waf_update_status**](docs/LegacyWafUpdateStatusApi.md#get_waf_update_status) | Get the status of a WAF update
281282
*LegacyWafUpdateStatusApi* | [**list_waf_update_statuses**](docs/LegacyWafUpdateStatusApi.md#list_waf_update_statuses) | List update statuses
283+
*LogExplorerApi* | [**get_log_records**](docs/LogExplorerApi.md#get_log_records) | Retrieve log records
282284
*LoggingAzureblobApi* | [**create_log_azure**](docs/LoggingAzureblobApi.md#create_log_azure) | Create an Azure Blob Storage log endpoint
283285
*LoggingAzureblobApi* | [**delete_log_azure**](docs/LoggingAzureblobApi.md#delete_log_azure) | Delete the Azure Blob Storage log endpoint
284286
*LoggingAzureblobApi* | [**get_log_azure**](docs/LoggingAzureblobApi.md#get_log_azure) | Get an Azure Blob Storage log endpoint
@@ -319,6 +321,11 @@ Class | Method | Description
319321
*LoggingGcsApi* | [**get_log_gcs**](docs/LoggingGcsApi.md#get_log_gcs) | Get a GCS log endpoint
320322
*LoggingGcsApi* | [**list_log_gcs**](docs/LoggingGcsApi.md#list_log_gcs) | List GCS log endpoints
321323
*LoggingGcsApi* | [**update_log_gcs**](docs/LoggingGcsApi.md#update_log_gcs) | Update a GCS log endpoint
324+
*LoggingGrafanacloudlogsApi* | [**create_log_grafanacloudlogs**](docs/LoggingGrafanacloudlogsApi.md#create_log_grafanacloudlogs) | Create a Grafana Cloud Logs log endpoint
325+
*LoggingGrafanacloudlogsApi* | [**delete_log_grafanacloudlogs**](docs/LoggingGrafanacloudlogsApi.md#delete_log_grafanacloudlogs) | Delete the Grafana Cloud Logs log endpoint
326+
*LoggingGrafanacloudlogsApi* | [**get_log_grafanacloudlogs**](docs/LoggingGrafanacloudlogsApi.md#get_log_grafanacloudlogs) | Get a Grafana Cloud Logs log endpoint
327+
*LoggingGrafanacloudlogsApi* | [**list_log_grafanacloudlogs**](docs/LoggingGrafanacloudlogsApi.md#list_log_grafanacloudlogs) | List Grafana Cloud Logs log endpoints
328+
*LoggingGrafanacloudlogsApi* | [**update_log_grafanacloudlogs**](docs/LoggingGrafanacloudlogsApi.md#update_log_grafanacloudlogs) | Update a Grafana Cloud Logs log endpoint
322329
*LoggingHerokuApi* | [**create_log_heroku**](docs/LoggingHerokuApi.md#create_log_heroku) | Create a Heroku log endpoint
323330
*LoggingHerokuApi* | [**delete_log_heroku**](docs/LoggingHerokuApi.md#delete_log_heroku) | Delete the Heroku log endpoint
324331
*LoggingHerokuApi* | [**get_log_heroku**](docs/LoggingHerokuApi.md#get_log_heroku) | Get a Heroku log endpoint
@@ -419,6 +426,10 @@ Class | Method | Description
419426
*MutualAuthenticationApi* | [**get_mutual_authentication**](docs/MutualAuthenticationApi.md#get_mutual_authentication) | Get a Mutual Authentication
420427
*MutualAuthenticationApi* | [**list_mutual_authentications**](docs/MutualAuthenticationApi.md#list_mutual_authentications) | List Mutual Authentications
421428
*MutualAuthenticationApi* | [**patch_mutual_authentication**](docs/MutualAuthenticationApi.md#patch_mutual_authentication) | Update a Mutual Authentication
429+
*ObjectStorageAccessKeysApi* | [**create_access_key**](docs/ObjectStorageAccessKeysApi.md#create_access_key) | Create an access key
430+
*ObjectStorageAccessKeysApi* | [**delete_access_key**](docs/ObjectStorageAccessKeysApi.md#delete_access_key) | Delete an access key
431+
*ObjectStorageAccessKeysApi* | [**get_access_key**](docs/ObjectStorageAccessKeysApi.md#get_access_key) | Get an access key
432+
*ObjectStorageAccessKeysApi* | [**list_access_keys**](docs/ObjectStorageAccessKeysApi.md#list_access_keys) | List access keys
422433
*ObservabilityCustomDashboardsApi* | [**create_dashboard**](docs/ObservabilityCustomDashboardsApi.md#create_dashboard) | Create a new dashboard
423434
*ObservabilityCustomDashboardsApi* | [**delete_dashboard**](docs/ObservabilityCustomDashboardsApi.md#delete_dashboard) | Delete an existing dashboard
424435
*ObservabilityCustomDashboardsApi* | [**get_dashboard**](docs/ObservabilityCustomDashboardsApi.md#get_dashboard) | Retrieve a dashboard by ID
@@ -627,8 +638,8 @@ The fastly-perl API client currently does not support the following endpoints:
627638
- [`/alerts/history`](https://www.fastly.com/documentation/reference/api/observability/alerts/history) (GET)
628639
- [`/dns/configurations/{dns_configuration_id}`](https://www.fastly.com/documentation/reference/api/) (DELETE, GET, PATCH)
629640
- [`/dns/configurations`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
630-
- [`/domains/{domain_id}`](https://www.fastly.com/documentation/reference/api/) (DELETE, GET, PATCH)
631-
- [`/domains`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
641+
- [`/domains/v1/{domain_id}`](https://www.fastly.com/documentation/reference/api/) (DELETE, GET, PATCH)
642+
- [`/domains/v1`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
632643
- [`/notifications/integration-types`](https://developer.fastly.com/reference/api/observability/notification) (GET)
633644
- [`/notifications/integrations/{integration_id}/rotateSigningKey`](https://developer.fastly.com/reference/api/observability/notification) (POST)
634645
- [`/notifications/integrations/{integration_id}/signingKey`](https://developer.fastly.com/reference/api/observability/notification) (GET)

docs/AccessKey.md

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# WebService::Fastly::Object::AccessKey
2+
3+
## Load the model package
4+
```perl
5+
use WebService::Fastly::Object::AccessKey;
6+
```
7+
8+
## Properties
9+
Name | Type | Description | Notes
10+
------------ | ------------- | ------------- | -------------
11+
**description** | **string** | A description of the access key. |
12+
**permission** | **string** | The permissions granted to an access key. |
13+
**buckets** | **ARRAY[string]** | | [optional]
14+
15+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
16+
17+

docs/AccessKeyResponse.md

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# WebService::Fastly::Object::AccessKeyResponse
2+
3+
## Load the model package
4+
```perl
5+
use WebService::Fastly::Object::AccessKeyResponse;
6+
```
7+
8+
## Properties
9+
Name | Type | Description | Notes
10+
------------ | ------------- | ------------- | -------------
11+
**access_key** | **string** | Generated access key. | [optional]
12+
**secret_key** | **string** | Generated secret key. | [optional]
13+
**description** | **string** | Description for the access key. | [optional]
14+
**permission** | **string** | Permissions granted to an access key. | [optional]
15+
**buckets** | **ARRAY[string]** | | [optional]
16+
**created_at** | **DateTime** | Date and time in ISO 8601 format. | [optional] [readonly]
17+
18+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
19+
20+

docs/AclsInComputeApi.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -327,7 +327,7 @@ Name | Type | Description | Notes
327327
[[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)
328328

329329
# **compute_acl_update_acls**
330-
> compute_acl_update_acls(acl_id => $acl_id, compute_acl_update_entry => $compute_acl_update_entry)
330+
> compute_acl_update_acls(acl_id => $acl_id, compute_acl_update => $compute_acl_update)
331331
332332
Update an ACL
333333

@@ -346,10 +346,10 @@ my $api_instance = WebService::Fastly::AclsInComputeApi->new(
346346
);
347347

348348
my $acl_id = "acl_id_example"; # string |
349-
my $compute_acl_update_entry = [WebService::Fastly::Object::ARRAY[ComputeAclUpdateEntry]->new()]; # ARRAY[ComputeAclUpdateEntry] |
349+
my $compute_acl_update = WebService::Fastly::Object::ComputeAclUpdate->new(); # ComputeAclUpdate |
350350

351351
eval {
352-
$api_instance->compute_acl_update_acls(acl_id => $acl_id, compute_acl_update_entry => $compute_acl_update_entry);
352+
$api_instance->compute_acl_update_acls(acl_id => $acl_id, compute_acl_update => $compute_acl_update);
353353
};
354354
if ($@) {
355355
warn "Exception when calling AclsInComputeApi->compute_acl_update_acls: $@\n";
@@ -361,7 +361,7 @@ if ($@) {
361361
Name | Type | Description | Notes
362362
------------- | ------------- | ------------- | -------------
363363
**acl_id** | **string**| |
364-
**compute_acl_update_entry** | [**ARRAY[ComputeAclUpdateEntry]**](ComputeAclUpdateEntry.md)| | [optional]
364+
**compute_acl_update** | [**ComputeAclUpdate**](ComputeAclUpdate.md)| | [optional]
365365

366366
### Return type
367367

docs/BillingUsageMetricsApi.md

+15-21
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,12 @@ use WebService::Fastly::Object::BillingUsageMetricsApi;
1010
1111
Method | HTTP request | Description
1212
------ | ------------ | -----------
13-
[**get_service_level_usage**](BillingUsageMetricsApi.md#get_service_level_usage) | **GET** /billing/v2/account_customers/{customer_id}/service-usage-metrics | Retrieve service-level usage metrics for a product.
14-
[**get_service_level_usage_types**](BillingUsageMetricsApi.md#get_service_level_usage_types) | **GET** /billing/v2/account_customers/{customer_id}/service-usage-types | Retrieve product usage types for a customer.
13+
[**get_service_level_usage**](BillingUsageMetricsApi.md#get_service_level_usage) | **GET** /billing/v3/service-usage-metrics | Retrieve service-level usage metrics for a product.
14+
[**get_usage_metrics**](BillingUsageMetricsApi.md#get_usage_metrics) | **GET** /billing/v3/usage-metrics | Get monthly usage metrics
1515

1616

1717
# **get_service_level_usage**
18-
> Serviceusagemetrics get_service_level_usage(customer_id => $customer_id, product_id => $product_id, usage_type_name => $usage_type_name, time_granularity => $time_granularity, start_date => $start_date, end_date => $end_date, start_month => $start_month, end_month => $end_month, limit => $limit, cursor => $cursor)
18+
> Serviceusagemetrics get_service_level_usage(product_id => $product_id, usage_type_name => $usage_type_name, start_month => $start_month, end_month => $end_month, limit => $limit, cursor => $cursor)
1919
2020
Retrieve service-level usage metrics for a product.
2121

@@ -33,19 +33,15 @@ my $api_instance = WebService::Fastly::BillingUsageMetricsApi->new(
3333
#api_key_prefix => {'Fastly-Key' => 'Bearer'},
3434
);
3535

36-
my $customer_id = "customer_id_example"; # string | Alphanumeric string identifying the customer.
3736
my $product_id = "product_id_example"; # string | The product identifier for the metrics returned (e.g., `cdn_usage`). This field is not required for CSV requests.
3837
my $usage_type_name = "usage_type_name_example"; # string | The usage type name for the metrics returned (e.g., `North America Requests`). This field is not required for CSV requests.
39-
my $time_granularity = "time_granularity_example"; # string |
40-
my $start_date = 2023-01-01; # string |
41-
my $end_date = 2023-01-31; # string |
4238
my $start_month = 2023-01; # string |
4339
my $end_month = 2023-03; # string |
4440
my $limit = '5'; # string | Number of results per page. The maximum is 100.
4541
my $cursor = "cursor_example"; # string | Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
4642

4743
eval {
48-
my $result = $api_instance->get_service_level_usage(customer_id => $customer_id, product_id => $product_id, usage_type_name => $usage_type_name, time_granularity => $time_granularity, start_date => $start_date, end_date => $end_date, start_month => $start_month, end_month => $end_month, limit => $limit, cursor => $cursor);
44+
my $result = $api_instance->get_service_level_usage(product_id => $product_id, usage_type_name => $usage_type_name, start_month => $start_month, end_month => $end_month, limit => $limit, cursor => $cursor);
4945
print Dumper($result);
5046
};
5147
if ($@) {
@@ -57,12 +53,8 @@ if ($@) {
5753

5854
Name | Type | Description | Notes
5955
------------- | ------------- | ------------- | -------------
60-
**customer_id** | **string**| Alphanumeric string identifying the customer. |
6156
**product_id** | **string**| The product identifier for the metrics returned (e.g., `cdn_usage`). This field is not required for CSV requests. |
6257
**usage_type_name** | **string**| The usage type name for the metrics returned (e.g., `North America Requests`). This field is not required for CSV requests. |
63-
**time_granularity** | **string**| |
64-
**start_date** | **string**| | [optional]
65-
**end_date** | **string**| | [optional]
6658
**start_month** | **string**| | [optional]
6759
**end_month** | **string**| | [optional]
6860
**limit** | **string**| Number of results per page. The maximum is 100. | [optional] [default to '5']
@@ -83,12 +75,12 @@ Name | Type | Description | Notes
8375

8476
[[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)
8577

86-
# **get_service_level_usage_types**
87-
> Serviceusagetypes get_service_level_usage_types(customer_id => $customer_id)
78+
# **get_usage_metrics**
79+
> Usagemetric get_usage_metrics(start_month => $start_month, end_month => $end_month)
8880
89-
Retrieve product usage types for a customer.
81+
Get monthly usage metrics
9082

91-
Returns product usage types reported by the customer's services.
83+
Returns monthly usage metrics for customer by product.
9284

9385
### Example
9486
```perl
@@ -102,26 +94,28 @@ my $api_instance = WebService::Fastly::BillingUsageMetricsApi->new(
10294
#api_key_prefix => {'Fastly-Key' => 'Bearer'},
10395
);
10496

105-
my $customer_id = "customer_id_example"; # string | Alphanumeric string identifying the customer.
97+
my $start_month = 2023-01; # string |
98+
my $end_month = 2023-03; # string |
10699

107100
eval {
108-
my $result = $api_instance->get_service_level_usage_types(customer_id => $customer_id);
101+
my $result = $api_instance->get_usage_metrics(start_month => $start_month, end_month => $end_month);
109102
print Dumper($result);
110103
};
111104
if ($@) {
112-
warn "Exception when calling BillingUsageMetricsApi->get_service_level_usage_types: $@\n";
105+
warn "Exception when calling BillingUsageMetricsApi->get_usage_metrics: $@\n";
113106
}
114107
```
115108

116109
### Parameters
117110

118111
Name | Type | Description | Notes
119112
------------- | ------------- | ------------- | -------------
120-
**customer_id** | **string**| Alphanumeric string identifying the customer. |
113+
**start_month** | **string**| | [optional]
114+
**end_month** | **string**| | [optional]
121115

122116
### Return type
123117

124-
[**Serviceusagetypes**](Serviceusagetypes.md)
118+
[**Usagemetric**](Usagemetric.md)
125119

126120
### Authorization
127121

docs/ComputeAclUpdate.md

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# WebService::Fastly::Object::ComputeAclUpdate
2+
3+
## Load the model package
4+
```perl
5+
use WebService::Fastly::Object::ComputeAclUpdate;
6+
```
7+
8+
## Properties
9+
Name | Type | Description | Notes
10+
------------ | ------------- | ------------- | -------------
11+
**entries** | [**ARRAY[ComputeAclUpdateEntry]**](ComputeAclUpdateEntry.md) | | [optional]
12+
13+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
14+
15+
+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# WebService::Fastly::Object::DimensionAttributesCountryStats
2+
3+
## Load the model package
4+
```perl
5+
use WebService::Fastly::Object::DimensionAttributesCountryStats;
6+
```
7+
8+
## Properties
9+
Name | Type | Description | Notes
10+
------------ | ------------- | ------------- | -------------
11+
**country_chr** | **double** | The cache hit ratio for the country. | [optional]
12+
**country_error_rate** | **double** | The error rate for the country. | [optional]
13+
**country_request_rate** | **double** | This country's percentage of the total requests. | [optional]
14+
15+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
16+
17+

docs/DimensionAttributesRate.md

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# WebService::Fastly::Object::DimensionAttributesRate
2+
3+
## Load the model package
4+
```perl
5+
use WebService::Fastly::Object::DimensionAttributesRate;
6+
```
7+
8+
## Properties
9+
Name | Type | Description | Notes
10+
------------ | ------------- | ------------- | -------------
11+
**rate** | **double** | The rate at which the value in the current dimension occurs. | [optional]
12+
13+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
14+
15+

docs/DimensionBrowser.md

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# WebService::Fastly::Object::DimensionBrowser
2+
3+
## Load the model package
4+
```perl
5+
use WebService::Fastly::Object::DimensionBrowser;
6+
```
7+
8+
## Properties
9+
Name | Type | Description | Notes
10+
------------ | ------------- | ------------- | -------------
11+
**browser** | **string** | The client's browser for this dimension. | [optional]
12+
13+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
14+
15+

0 commit comments

Comments
 (0)