openstack.firewall.Firewall
Explore with Pulumi AI
Manages a v1 firewall resource within OpenStack.
Example Usage
using System.Collections.Generic;
using Pulumi;
using OpenStack = Pulumi.OpenStack;
return await Deployment.RunAsync(() =>
{
var rule1 = new OpenStack.Firewall.Rule("rule1", new()
{
Action = "deny",
Description = "drop TELNET traffic",
DestinationPort = "23",
Enabled = true,
Protocol = "tcp",
});
var rule2 = new OpenStack.Firewall.Rule("rule2", new()
{
Action = "deny",
Description = "drop NTP traffic",
DestinationPort = "123",
Enabled = false,
Protocol = "udp",
});
var policy1 = new OpenStack.Firewall.Policy("policy1", new()
{
Rules = new[]
{
rule1.Id,
rule2.Id,
},
});
var firewall1 = new OpenStack.Firewall.Firewall("firewall1", new()
{
PolicyId = policy1.Id,
});
});
package main
import (
"github.com/pulumi/pulumi-openstack/sdk/v3/go/openstack/firewall"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
rule1, err := firewall.NewRule(ctx, "rule1", &firewall.RuleArgs{
Action: pulumi.String("deny"),
Description: pulumi.String("drop TELNET traffic"),
DestinationPort: pulumi.String("23"),
Enabled: pulumi.Bool(true),
Protocol: pulumi.String("tcp"),
})
if err != nil {
return err
}
rule2, err := firewall.NewRule(ctx, "rule2", &firewall.RuleArgs{
Action: pulumi.String("deny"),
Description: pulumi.String("drop NTP traffic"),
DestinationPort: pulumi.String("123"),
Enabled: pulumi.Bool(false),
Protocol: pulumi.String("udp"),
})
if err != nil {
return err
}
policy1, err := firewall.NewPolicy(ctx, "policy1", &firewall.PolicyArgs{
Rules: pulumi.StringArray{
rule1.ID(),
rule2.ID(),
},
})
if err != nil {
return err
}
_, err = firewall.NewFirewall(ctx, "firewall1", &firewall.FirewallArgs{
PolicyId: policy1.ID(),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.openstack.firewall.Rule;
import com.pulumi.openstack.firewall.RuleArgs;
import com.pulumi.openstack.firewall.Policy;
import com.pulumi.openstack.firewall.PolicyArgs;
import com.pulumi.openstack.firewall.Firewall;
import com.pulumi.openstack.firewall.FirewallArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var rule1 = new Rule("rule1", RuleArgs.builder()
.action("deny")
.description("drop TELNET traffic")
.destinationPort("23")
.enabled("true")
.protocol("tcp")
.build());
var rule2 = new Rule("rule2", RuleArgs.builder()
.action("deny")
.description("drop NTP traffic")
.destinationPort("123")
.enabled("false")
.protocol("udp")
.build());
var policy1 = new Policy("policy1", PolicyArgs.builder()
.rules(
rule1.id(),
rule2.id())
.build());
var firewall1 = new Firewall("firewall1", FirewallArgs.builder()
.policyId(policy1.id())
.build());
}
}
import pulumi
import pulumi_openstack as openstack
rule1 = openstack.firewall.Rule("rule1",
action="deny",
description="drop TELNET traffic",
destination_port="23",
enabled=True,
protocol="tcp")
rule2 = openstack.firewall.Rule("rule2",
action="deny",
description="drop NTP traffic",
destination_port="123",
enabled=False,
protocol="udp")
policy1 = openstack.firewall.Policy("policy1", rules=[
rule1.id,
rule2.id,
])
firewall1 = openstack.firewall.Firewall("firewall1", policy_id=policy1.id)
import * as pulumi from "@pulumi/pulumi";
import * as openstack from "@pulumi/openstack";
const rule1 = new openstack.firewall.Rule("rule1", {
action: "deny",
description: "drop TELNET traffic",
destinationPort: "23",
enabled: true,
protocol: "tcp",
});
const rule2 = new openstack.firewall.Rule("rule2", {
action: "deny",
description: "drop NTP traffic",
destinationPort: "123",
enabled: false,
protocol: "udp",
});
const policy1 = new openstack.firewall.Policy("policy1", {rules: [
rule1.id,
rule2.id,
]});
const firewall1 = new openstack.firewall.Firewall("firewall1", {policyId: policy1.id});
resources:
rule1:
type: openstack:firewall:Rule
properties:
action: deny
description: drop TELNET traffic
destinationPort: '23'
enabled: 'true'
protocol: tcp
rule2:
type: openstack:firewall:Rule
properties:
action: deny
description: drop NTP traffic
destinationPort: '123'
enabled: 'false'
protocol: udp
policy1:
type: openstack:firewall:Policy
properties:
rules:
- ${rule1.id}
- ${rule2.id}
firewall1:
type: openstack:firewall:Firewall
properties:
policyId: ${policy1.id}
Create Firewall Resource
new Firewall(name: string, args: FirewallArgs, opts?: CustomResourceOptions);
@overload
def Firewall(resource_name: str,
opts: Optional[ResourceOptions] = None,
admin_state_up: Optional[bool] = None,
associated_routers: Optional[Sequence[str]] = None,
description: Optional[str] = None,
name: Optional[str] = None,
no_routers: Optional[bool] = None,
policy_id: Optional[str] = None,
region: Optional[str] = None,
tenant_id: Optional[str] = None,
value_specs: Optional[Mapping[str, Any]] = None)
@overload
def Firewall(resource_name: str,
args: FirewallArgs,
opts: Optional[ResourceOptions] = None)
func NewFirewall(ctx *Context, name string, args FirewallArgs, opts ...ResourceOption) (*Firewall, error)
public Firewall(string name, FirewallArgs args, CustomResourceOptions? opts = null)
public Firewall(String name, FirewallArgs args)
public Firewall(String name, FirewallArgs args, CustomResourceOptions options)
type: openstack:firewall:Firewall
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args FirewallArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args FirewallArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args FirewallArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args FirewallArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args FirewallArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Firewall Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Firewall resource accepts the following input properties:
- Policy
Id string The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- Admin
State boolUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- Associated
Routers List<string> Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- Description string
A description for the firewall. Changing this updates the
description
of an existing firewall.- Name string
A name for the firewall. Changing this updates the
name
of an existing firewall.- No
Routers bool Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- Region string
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- Tenant
Id string The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- Value
Specs Dictionary<string, object> Map of additional options.
- Policy
Id string The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- Admin
State boolUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- Associated
Routers []string Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- Description string
A description for the firewall. Changing this updates the
description
of an existing firewall.- Name string
A name for the firewall. Changing this updates the
name
of an existing firewall.- No
Routers bool Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- Region string
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- Tenant
Id string The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- Value
Specs map[string]interface{} Map of additional options.
- policy
Id String The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- admin
State BooleanUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated
Routers List<String> Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description String
A description for the firewall. Changing this updates the
description
of an existing firewall.- name String
A name for the firewall. Changing this updates the
name
of an existing firewall.- no
Routers Boolean Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- region String
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant
Id String The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value
Specs Map<String,Object> Map of additional options.
- policy
Id string The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- admin
State booleanUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated
Routers string[] Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description string
A description for the firewall. Changing this updates the
description
of an existing firewall.- name string
A name for the firewall. Changing this updates the
name
of an existing firewall.- no
Routers boolean Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- region string
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant
Id string The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value
Specs {[key: string]: any} Map of additional options.
- policy_
id str The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- admin_
state_ boolup Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated_
routers Sequence[str] Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description str
A description for the firewall. Changing this updates the
description
of an existing firewall.- name str
A name for the firewall. Changing this updates the
name
of an existing firewall.- no_
routers bool Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- region str
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant_
id str The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value_
specs Mapping[str, Any] Map of additional options.
- policy
Id String The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- admin
State BooleanUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated
Routers List<String> Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description String
A description for the firewall. Changing this updates the
description
of an existing firewall.- name String
A name for the firewall. Changing this updates the
name
of an existing firewall.- no
Routers Boolean Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- region String
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant
Id String The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value
Specs Map<Any> Map of additional options.
Outputs
All input properties are implicitly available as output properties. Additionally, the Firewall resource produces the following output properties:
- Id string
The provider-assigned unique ID for this managed resource.
- Id string
The provider-assigned unique ID for this managed resource.
- id String
The provider-assigned unique ID for this managed resource.
- id string
The provider-assigned unique ID for this managed resource.
- id str
The provider-assigned unique ID for this managed resource.
- id String
The provider-assigned unique ID for this managed resource.
Look up Existing Firewall Resource
Get an existing Firewall resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: FirewallState, opts?: CustomResourceOptions): Firewall
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
admin_state_up: Optional[bool] = None,
associated_routers: Optional[Sequence[str]] = None,
description: Optional[str] = None,
name: Optional[str] = None,
no_routers: Optional[bool] = None,
policy_id: Optional[str] = None,
region: Optional[str] = None,
tenant_id: Optional[str] = None,
value_specs: Optional[Mapping[str, Any]] = None) -> Firewall
func GetFirewall(ctx *Context, name string, id IDInput, state *FirewallState, opts ...ResourceOption) (*Firewall, error)
public static Firewall Get(string name, Input<string> id, FirewallState? state, CustomResourceOptions? opts = null)
public static Firewall get(String name, Output<String> id, FirewallState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Admin
State boolUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- Associated
Routers List<string> Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- Description string
A description for the firewall. Changing this updates the
description
of an existing firewall.- Name string
A name for the firewall. Changing this updates the
name
of an existing firewall.- No
Routers bool Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- Policy
Id string The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- Region string
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- Tenant
Id string The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- Value
Specs Dictionary<string, object> Map of additional options.
- Admin
State boolUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- Associated
Routers []string Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- Description string
A description for the firewall. Changing this updates the
description
of an existing firewall.- Name string
A name for the firewall. Changing this updates the
name
of an existing firewall.- No
Routers bool Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- Policy
Id string The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- Region string
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- Tenant
Id string The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- Value
Specs map[string]interface{} Map of additional options.
- admin
State BooleanUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated
Routers List<String> Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description String
A description for the firewall. Changing this updates the
description
of an existing firewall.- name String
A name for the firewall. Changing this updates the
name
of an existing firewall.- no
Routers Boolean Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- policy
Id String The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- region String
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant
Id String The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value
Specs Map<String,Object> Map of additional options.
- admin
State booleanUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated
Routers string[] Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description string
A description for the firewall. Changing this updates the
description
of an existing firewall.- name string
A name for the firewall. Changing this updates the
name
of an existing firewall.- no
Routers boolean Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- policy
Id string The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- region string
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant
Id string The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value
Specs {[key: string]: any} Map of additional options.
- admin_
state_ boolup Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated_
routers Sequence[str] Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description str
A description for the firewall. Changing this updates the
description
of an existing firewall.- name str
A name for the firewall. Changing this updates the
name
of an existing firewall.- no_
routers bool Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- policy_
id str The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- region str
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant_
id str The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value_
specs Mapping[str, Any] Map of additional options.
- admin
State BooleanUp Administrative up/down status for the firewall (must be "true" or "false" if provided - defaults to "true"). Changing this updates the
admin_state_up
of an existing firewall.- associated
Routers List<String> Router(s) to associate this firewall instance with. Must be a list of strings. Changing this updates the associated routers of an existing firewall. Conflicts with
no_routers
.- description String
A description for the firewall. Changing this updates the
description
of an existing firewall.- name String
A name for the firewall. Changing this updates the
name
of an existing firewall.- no
Routers Boolean Should this firewall not be associated with any routers (must be "true" or "false" if provide - defaults to "false"). Conflicts with
associated_routers
.- policy
Id String The policy resource id for the firewall. Changing this updates the
policy_id
of an existing firewall.- region String
The region in which to obtain the v1 networking client. A networking client is needed to create a firewall. If omitted, the
region
argument of the provider is used. Changing this creates a new firewall.- tenant
Id String The owner of the floating IP. Required if admin wants to create a firewall for another tenant. Changing this creates a new firewall.
- value
Specs Map<Any> Map of additional options.
Import
Firewalls can be imported using the id
, e.g.
$ pulumi import openstack:firewall/firewall:Firewall firewall_1 c9e39fb2-ce20-46c8-a964-25f3898c7a97
Package Details
- Repository
- OpenStack pulumi/pulumi-openstack
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
openstack
Terraform Provider.