The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

WebService::Fastly::WafFirewallsApi

Load the API package

[!NOTE] All URIs are relative to https://api.fastly.com

Method | HTTP request | Description ------ | ------------ | ----------- create_waf_firewall | POST /waf/firewalls | Create a firewall delete_waf_firewall | DELETE /waf/firewalls/{firewall_id} | Delete a firewall get_waf_firewall | GET /waf/firewalls/{firewall_id} | Get a firewall list_waf_firewalls | GET /waf/firewalls | List firewalls update_waf_firewall | PATCH /waf/firewalls/{firewall_id} | Update a firewall

create_waf_firewall

WafFirewallResponse create_waf_firewall(waf_firewall => $waf_firewall)

Create a firewall

Create a firewall object for a particular service and service version using a defined prefetch_condition and response. If the prefetch_condition or the response is missing from the request body, Fastly will generate a default object on your service.

Example

my $api_instance = WebService::Fastly::WafFirewallsApi->new(
# Configure API key authorization: token
api_key => {'Fastly-Key' => 'YOUR_API_KEY'},
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#api_key_prefix => {'Fastly-Key' => 'Bearer'},
);
my $waf_firewall = WebService::Fastly::Object::WafFirewall->new(); # WafFirewall |
eval {
my $result = $api_instance->create_waf_firewall(waf_firewall => $waf_firewall);
print Dumper($result);
};
if ($@) {
warn "Exception when calling WafFirewallsApi->create_waf_firewall: $@\n";
}

Parameters

Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- waf_firewall | WafFirewall| | [optional]

Return type

WafFirewallResponse

Authorization

token

HTTP request headers

[Back to top] [Back to API list] [Back to Model list] [Back to README]

delete_waf_firewall

delete_waf_firewall(firewall_id => $firewall_id, waf_firewall => $waf_firewall)

Delete a firewall

Delete the firewall object for a particular service and service version.

Example

my $api_instance = WebService::Fastly::WafFirewallsApi->new(
# Configure API key authorization: token
api_key => {'Fastly-Key' => 'YOUR_API_KEY'},
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#api_key_prefix => {'Fastly-Key' => 'Bearer'},
);
my $firewall_id = "firewall_id_example"; # string | Alphanumeric string identifying a WAF Firewall.
my $waf_firewall = WebService::Fastly::Object::WafFirewall->new(); # WafFirewall |
eval {
$api_instance->delete_waf_firewall(firewall_id => $firewall_id, waf_firewall => $waf_firewall);
};
if ($@) {
warn "Exception when calling WafFirewallsApi->delete_waf_firewall: $@\n";
}

Parameters

Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- firewall_id | string| Alphanumeric string identifying a WAF Firewall. | waf_firewall | WafFirewall| | [optional]

Return type

void (empty response body)

Authorization

token

HTTP request headers

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_waf_firewall

WafFirewallResponse get_waf_firewall(firewall_id => $firewall_id, filter[service_version_number] => $filter[service_version_number], include => $include)

Get a firewall

Get a specific firewall object.

Example

my $api_instance = WebService::Fastly::WafFirewallsApi->new(
# Configure API key authorization: token
api_key => {'Fastly-Key' => 'YOUR_API_KEY'},
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#api_key_prefix => {'Fastly-Key' => 'Bearer'},
);
my $firewall_id = "firewall_id_example"; # string | Alphanumeric string identifying a WAF Firewall.
my $filter[service_version_number] = "filter[service_version_number]_example"; # string | Limit the results returned to a specific service version.
my $include = 'waf_firewall_versions'; # string | Include related objects. Optional.
eval {
my $result = $api_instance->get_waf_firewall(firewall_id => $firewall_id, filter[service_version_number] => $filter[service_version_number], include => $include);
print Dumper($result);
};
if ($@) {
warn "Exception when calling WafFirewallsApi->get_waf_firewall: $@\n";
}

Parameters

Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- firewall_id | string| Alphanumeric string identifying a WAF Firewall. | filter[service_version_number] | string| Limit the results returned to a specific service version. | [optional] include | string| Include related objects. Optional. | [optional] [default to 'waf_firewall_versions']

Return type

WafFirewallResponse

Authorization

token

HTTP request headers

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_waf_firewalls

WafFirewallsResponse list_waf_firewalls(page[number] => $page[number], page[size] => $page[size], filter[service_id] => $filter[service_id], filter[service_version_number] => $filter[service_version_number], include => $include)

List firewalls

List all firewall objects.

Example

my $api_instance = WebService::Fastly::WafFirewallsApi->new(
# Configure API key authorization: token
api_key => {'Fastly-Key' => 'YOUR_API_KEY'},
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#api_key_prefix => {'Fastly-Key' => 'Bearer'},
);
my $page[number] = 1; # int | Current page.
my $page[size] = 20; # int | Number of records per page.
my $filter[service_id] = "filter[service_id]_example"; # string | Limit the results returned to a specific service.
my $filter[service_version_number] = "filter[service_version_number]_example"; # string | Limit the results returned to a specific service version.
my $include = 'waf_firewall_versions'; # string | Include related objects. Optional.
eval {
my $result = $api_instance->list_waf_firewalls(page[number] => $page[number], page[size] => $page[size], filter[service_id] => $filter[service_id], filter[service_version_number] => $filter[service_version_number], include => $include);
print Dumper($result);
};
if ($@) {
warn "Exception when calling WafFirewallsApi->list_waf_firewalls: $@\n";
}

Parameters

Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- page[number] | int| Current page. | [optional] page[size] | int| Number of records per page. | [optional] [default to 20] filter[service_id] | string| Limit the results returned to a specific service. | [optional] filter[service_version_number] | string| Limit the results returned to a specific service version. | [optional] include | string| Include related objects. Optional. | [optional] [default to 'waf_firewall_versions']

Return type

WafFirewallsResponse

Authorization

token

HTTP request headers

[Back to top] [Back to API list] [Back to Model list] [Back to README]

update_waf_firewall

WafFirewallResponse update_waf_firewall(firewall_id => $firewall_id, waf_firewall => $waf_firewall)

Update a firewall

Update a firewall object for a particular service and service version. Specifying a service_version_number is required.

Example

my $api_instance = WebService::Fastly::WafFirewallsApi->new(
# Configure API key authorization: token
api_key => {'Fastly-Key' => 'YOUR_API_KEY'},
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#api_key_prefix => {'Fastly-Key' => 'Bearer'},
);
my $firewall_id = "firewall_id_example"; # string | Alphanumeric string identifying a WAF Firewall.
my $waf_firewall = WebService::Fastly::Object::WafFirewall->new(); # WafFirewall |
eval {
my $result = $api_instance->update_waf_firewall(firewall_id => $firewall_id, waf_firewall => $waf_firewall);
print Dumper($result);
};
if ($@) {
warn "Exception when calling WafFirewallsApi->update_waf_firewall: $@\n";
}

Parameters

Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- firewall_id | string| Alphanumeric string identifying a WAF Firewall. | waf_firewall | WafFirewall| | [optional]

Return type

WafFirewallResponse

Authorization

token

HTTP request headers

[Back to top] [Back to API list] [Back to Model list] [Back to README]