Provided by: libvm-ec2-perl_1.28-1_all 
NAME VM::EC2::REST::network_acl - Create and manipulate VPC Network Access Control Lists
SYNOPSIS
use VM::EC2 ':vpc'
METHODS
These methods allow you to create and manipulate VPC Network Access Control Lists.
Implemented:
CreateNetworkAcl
CreateNetworkAclEntry
DeleteNetworkAcl
DeleteNetworkAclEntry
DescribeNetworkAcls
ReplaceNetworkAclAssociation
ReplaceNetworkAclEntry
Unimplemented:
(none)
@acls = $ec2->describe_network_acls(-network_acl_id=>\@ids, -filter=>\%filters)
@acls = $ec2->describe_network_acls(\@network_acl_ids)
@acls = $ec2->describe_network_acls(%filters)
Provides information about network ACLs.
Returns a series of VM::EC2::VPC::NetworkAcl objects.
Optional parameters are:
-network_acl_id -- ID of the network ACL(s) to return information on.
This can be a string scalar, or an arrayref.
-filter -- Tags and other filters to apply.
The filter argument is a hashreference in which the keys are the filter names, and the
values are the match strings. Some filters accept wildcards.
There are a number of filters, which are listed in full at
http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeNetworkAcls.html
Here is a alpha-sorted list of filter names: association.association-id,
association.network-acl-id, association.subnet-id, default, entry.cidr, entry.egress,
entry.icmp.code, entry.icmp.type, entry.port-range.from, entry.port-range.to,
entry.protocol, entry.rule-action, entry.rule-number, network-acl-id, tag-key, tag-value,
tag:key, vpc-id
$acl = $ec2->create_network_acl(-vpc_id=>$vpc_id)
$acl = $ec2->create_network_acl($vpc_id)
Creates a new network ACL in a VPC. Network ACLs provide an optional layer of security (on
top of security groups) for the instances in a VPC.
Arguments:
-vpc_id -- The VPC ID to create the ACL in
Retuns a VM::EC2::VPC::NetworkAcl object on success.
$boolean = $ec2->delete_network_acl(-network_acl_id=>$id)
$boolean = $ec2->delete_network_acl($id)
Deletes a network ACL from a VPC. The ACL must not have any subnets associated with it.
The default network ACL cannot be deleted.
Arguments:
-network_acl_id -- The ID of the network ACL to delete
Returns true on successful deletion.
$boolean = $ec2->create_network_acl_entry(%args)
Creates an entry (i.e., rule) in a network ACL with the rule number you specified. Each
network ACL has a set of numbered ingress rules and a separate set of numbered egress
rules. When determining whether a packet should be allowed in or out of a subnet
associated with the ACL, Amazon VPC processes the entries in the ACL according to the rule
numbers, in ascending order.
Arguments:
-network_acl_id -- ID of the ACL where the entry will be created
(Required)
-rule_number -- Rule number to assign to the entry (e.g., 100).
ACL entries are processed in ascending order by
rule number. Positive integer from 1 to 32766.
(Required)
-protocol -- The IP protocol the rule applies to. You can use
-1 to mean all protocols. See
http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml
for a list of protocol numbers. (Required)
-rule_action -- Indicates whether to allow or deny traffic that
matches the rule. allow | deny (Required)
-egress -- Indicates whether this rule applies to egress
traffic from the subnet (true) or ingress traffic
to the subnet (false). Default is false.
-cidr_block -- The CIDR range to allow or deny, in CIDR notation
(e.g., 172.16.0.0/24). (Required)
-icmp_code -- For the ICMP protocol, the ICMP code. You can use
-1 to specify all ICMP codes for the given ICMP
type. Required if specifying 1 (ICMP) for protocol.
-icmp_type -- For the ICMP protocol, the ICMP type. You can use
-1 to specify all ICMP types. Required if
specifying 1 (ICMP) for the protocol
-port_range_from -- The first port in the range. Required if specifying
6 (TCP) or 17 (UDP) for the protocol.
-port_range_to -- The last port in the range. Required if specifying
6 (TCP) or 17 (UDP) for the protocol.
-port_from -- Alias for -port_range_from
-port_to -- Alias for -port_range_to
Returns true on successful creation.
$success = $ec2->delete_network_acl_entry(-network_acl_id=>$id, -rule_number =>$int, -egress
=>$bool)
Deletes an ingress or egress entry (i.e., rule) from a network ACL.
Arguments:
-network_acl_id -- ID of the ACL where the entry will be created
-rule_number -- Rule number of the entry (e.g., 100).
Optional arguments:
-egress -- Whether the rule to delete is an egress rule (true) or ingress
rule (false). Default is false.
Returns true on successful deletion.
$assoc_id = $ec2->replace_network_acl_association(-association_id=>$assoc_id,
-network_acl_id=>$id)
Changes which network ACL a subnet is associated with. By default when you create a
subnet, it's automatically associated with the default network ACL.
Arguments:
-association_id -- The ID of the association to replace
-network_acl_id -- The ID of the network ACL to associated the subnet with
Returns the new association ID.
$success = $ec2->replace_network_acl_entry(%args)
Replaces an entry (i.e., rule) in a network ACL.
Arguments:
-network_acl_id -- ID of the ACL where the entry will be created
(Required)
-rule_number -- Rule number of the entry to replace. (Required)
-protocol -- The IP protocol the rule applies to. You can use
-1 to mean all protocols. See
http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml
for a list of protocol numbers. (Required)
-rule_action -- Indicates whether to allow or deny traffic that
matches the rule. allow | deny (Required)
-egress -- Indicates whether this rule applies to egress
traffic from the subnet (true) or ingress traffic
to the subnet (false). Default is false.
-cidr_block -- The CIDR range to allow or deny, in CIDR notation
(e.g., 172.16.0.0/24). (Required)
-icmp_code -- For the ICMP protocol, the ICMP code. You can use
-1 to specify all ICMP codes for the given ICMP
type. Required if specifying 1 (ICMP) for protocol.
-icmp_type -- For the ICMP protocol, the ICMP type. You can use
-1 to specify all ICMP types. Required if
specifying 1 (ICMP) for the protocol
-port_range_from -- The first port in the range. Required if specifying
6 (TCP) or 17 (UDP) for the protocol.
-port_range_to -- The last port in the range. Only required if
specifying 6 (TCP) or 17 (UDP) for the protocol and
is a different port than -port_range_from.
-port_from -- Alias for -port_range_from
-port_to -- Alias for -port_range_from
Returns true on successful replacement.
SEE ALSO
VM::EC2
AUTHOR
Lance Kinley <lkinley@loyaltymethods.com>. Lincoln Stein <lincoln.stein@gmail.com>.
Copyright (c) 2012 Loyalty Methods, Inc. Copyright (c) 2012 Ontario Institute for Cancer
Research
This package and its accompanying libraries is free software; you can redistribute it
and/or modify it under the terms of the GPL (either version 1, or at your option, any
later version) or the Artistic License 2.0. Refer to LICENSE for the full license text.
In addition, please see DISCLAIMER.txt for disclaimers of warranty.