ec2_replace_network_acl_entry {aws.ecx}

Replace Network Acl Entry

Description

Replaces an entry (rule) in a network ACL. For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

Usage

ec2_replace_network_acl_entry(
  Egress,
  NetworkAclId,
  Protocol,
  RuleAction,
  RuleNumber,
  CidrBlock = NULL,
  DryRun = NULL,
  Icmp = NULL,
  Ipv6CidrBlock = NULL,
  PortRange = NULL,
  simplify = TRUE,
  others = list(),
  print_on_error = aws_get_print_on_error(),
  retry_time = aws_get_retry_time(),
  network_timeout = aws_get_network_timeout(),
  region = aws_get_region()
)

Arguments

Egress

Logical. Indicates whether to replace the egress rule.

NetworkAclId

Character. The ID of the ACL.

Protocol

Character. The protocol number.

RuleAction

Character. Indicates whether to allow or deny the traffic that matches the rule.

RuleNumber

Integer. The rule number of the entry to replace.

CidrBlock

Character. The IPv4 network range to allow or deny, in CIDR notation (for example ⁠172.16.0.0/24⁠).[optional]

DryRun

Logical. Checks whether you have the required permissions for the action, without actually making the request,...[optional]

Icmp

Object. ICMP protocol: The ICMP or ICMPv6 type and code.[optional]

Ipv6CidrBlock

Character. The IPv6 network range to allow or deny, in CIDR notation (for example ⁠2001:bd8:1234:1a00::/64⁠).[optional]

PortRange

Object. TCP or UDP protocols: The range of ports the rule applies to.[optional]

simplify

Logical. Whether to simplify the result and handle nextToken in the response[optional]

others

Named list. The parameters that are not included in the function parameters and need to be added into the request[optional]

print_on_error

Logical. Whether to show an error message when a network error occurs.

retry_time

Integer. Number of retries for a REST request when encounter the network issue. If the request has been sent retry_time times but still not be able to get the response, an error will be thrown.

network_timeout

Numeric. Number of seconds to wait for a REST response until giving up. Can not be less than 1 ms.

region

Character. The region of the AWS service.

Value

A list object or a character vector

Egress

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

NetworkAclId

The ID of the ACL.

Protocol

The protocol number. A value of \'-1\' means all protocols. If you specify \'-1\' or a protocol number other than \'6\' (TCP), \'17\' (UDP), or \'1\' (ICMP), traffic on all ports is allowed, regardless of any ports or ICMP types or codes that you specify. If you specify protocol \'58\' (ICMPv6) and specify an IPv4 CIDR block, traffic for all ICMP types and codes allowed, regardless of any that you specify. If you specify protocol \'58\' (ICMPv6) and specify an IPv6 CIDR block, you must specify an ICMP type and code.

RuleAction

Indicates whether to allow or deny the traffic that matches the rule.

RuleNumber

The rule number of the entry to replace.

CidrBlock

The IPv4 network range to allow or deny, in CIDR notation (for example ⁠172.16.0.0/24⁠).

DryRun

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Icmp

ICMP protocol: The ICMP or ICMPv6 type and code. Required if specifying protocol 1 (ICMP) or protocol 58 (ICMPv6) with an IPv6 CIDR block.

Ipv6CidrBlock

The IPv6 network range to allow or deny, in CIDR notation (for example ⁠2001:bd8:1234:1a00::/64⁠).

PortRange

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying protocol 6 (TCP) or 17 (UDP).