Skip to content

EC2  >  Structures  >  IpPermission

IpPermission

Structure Class

IpPermission dataclass

Bases: _SerdeShape

Describes the permissions for a security group rule.

Attributes

from_port class-attribute instance-attribute
from_port: int | None = ...

If the protocol is TCP or UDP, this is the start of the port range. If the protocol is ICMP or ICMPv6, this is the ICMP type or -1 (all ICMP types).

ip_protocol class-attribute instance-attribute
ip_protocol: str | None = ...

The IP protocol name (tcp, udp, icmp, icmpv6) or number (see Protocol Numbers).

Use -1 to specify all protocols. When authorizing security group rules, specifying -1 or a protocol number other than tcp, udp, icmp, or icmpv6 allows traffic on all ports, regardless of any port range you specify. For tcp, udp, and icmp, you must specify a port range. For icmpv6, the port range is optional; if you omit the port range, traffic for all types and codes is allowed.

ip_ranges class-attribute instance-attribute
ip_ranges: list[IpRange] | None = ...

The IPv4 address ranges.

ipv6_ranges class-attribute instance-attribute
ipv6_ranges: list[Ipv6Range] | None = ...

The IPv6 address ranges.

prefix_list_ids class-attribute instance-attribute
prefix_list_ids: list[PrefixListId] | None = ...

The prefix list IDs.

to_port class-attribute instance-attribute
to_port: int | None = ...

If the protocol is TCP or UDP, this is the end of the port range. If the protocol is ICMP or ICMPv6, this is the ICMP code or -1 (all ICMP codes). If the start port is -1 (all ICMP types), then the end port must be -1 (all ICMP codes).

user_id_group_pairs class-attribute instance-attribute
user_id_group_pairs: list[UserIdGroupPair] | None = ...

The security group and Amazon Web Services account ID pairs.