features_firewalls
Creates, updates, deletes, gets or lists a features_firewalls resource.
Overview​
| Name | features_firewalls |
| Type | Resource |
| Id | ovh.dedicated_server.features_firewalls |
Fields​
The following fields are returned by SELECT queries:
- get
successful operation
| Name | Datatype | Description |
|---|---|---|
enabled | boolean | |
firewall | string | |
ip | string (ipv4) | Firewall management IP (example: 192.0.2.0) |
mode | string | transparent mode : device is invisible on the network; routed mode : the security appliance is considered to be a router hop in the network (routed, transparent) |
model | string | Firewall model (asa5505, asa5510, asa5520) |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | service_name | Get the firewall. Returns the firewall attached to the server: its management IP, model, mode and whether it is enabled. In transparent mode the firewall is invisible on the network; in routed mode it is a router hop. | |
update | update | service_name | Update the firewall. Updates the firewall attached to the server. Only the enabled field can be changed; the other fields are read-only. |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
api_host | string | The OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}}) |
service_name | string | The internal name of your dedicated server (wire: serviceName) |
SELECT examples​
- get
Get the firewall. Returns the firewall attached to the server: its management IP, model, mode and whether it is enabled. In transparent mode the firewall is invisible on the network; in routed mode it is a router hop.
SELECT
enabled,
firewall,
ip,
mode,
model
FROM ovh.dedicated_server.features_firewalls
WHERE service_name = '{{ service_name }}' -- required
;
UPDATE examples​
- update
Update the firewall. Updates the firewall attached to the server. Only the enabled field can be changed; the other fields are read-only.
UPDATE ovh.dedicated_server.features_firewalls
SET
enabled = {{ enabled }}
WHERE
service_name = '{{ service_name }}' --required;