Struct SecurityGroupRuleRequest

#[non_exhaustive]
pub struct SecurityGroupRuleRequest {
    pub ip_protocol: Option<String>,
    pub from_port: Option<i32>,
    pub to_port: Option<i32>,
    pub cidr_ipv4: Option<String>,
    pub cidr_ipv6: Option<String>,
    pub prefix_list_id: Option<String>,
    pub referenced_group_id: Option<String>,
    pub description: Option<String>,
}

Describes a security group rule.

You must specify exactly one of the following parameters, based on the rule type:

• CidrIpv4

• CidrIpv6

• PrefixListId

• ReferencedGroupId

Amazon Web Services canonicalizes IPv4 and IPv6 CIDRs. For example, if you specify 100.68.0.18/18 for the CIDR block, Amazon Web Services canonicalizes the CIDR block to 100.68.0.0/18. Any subsequent DescribeSecurityGroups and DescribeSecurityGroupRules calls will return the canonicalized form of the CIDR block. Additionally, if you attempt to add another rule with the non-canonical form of the CIDR (such as 100.68.0.18/18) and there is already a rule for the canonicalized form of the CIDR block (such as 100.68.0.0/18), the API throws an duplicate rule error.

When you modify a rule, you cannot change the rule type. For example, if the rule uses an IPv4 address range, you must use CidrIpv4 to specify a new IPv4 address range.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

ip_protocol: Option<String>

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

Use -1 to specify all protocols.

from_port: Option<i32>

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).

to_port: Option<i32>

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).

cidr_ipv4: Option<String>

The IPv4 CIDR range. To specify a single IPv4 address, use the /32 prefix length.

cidr_ipv6: Option<String>

The IPv6 CIDR range. To specify a single IPv6 address, use the /128 prefix length.

prefix_list_id: Option<String>

The ID of the prefix list.

referenced_group_id: Option<String>

The ID of the security group that is referenced in the security group rule.

description: Option<String>

The description of the security group rule.

Implementations

impl SecurityGroupRuleRequest

pub fn ip_protocol(&self) -> Option<&str>

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

Use -1 to specify all protocols.

pub fn from_port(&self) -> Option<i32>

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).

pub fn to_port(&self) -> Option<i32>

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).

pub fn cidr_ipv4(&self) -> Option<&str>

The IPv4 CIDR range. To specify a single IPv4 address, use the /32 prefix length.

pub fn cidr_ipv6(&self) -> Option<&str>

The IPv6 CIDR range. To specify a single IPv6 address, use the /128 prefix length.

pub fn prefix_list_id(&self) -> Option<&str>

The ID of the prefix list.

pub fn referenced_group_id(&self) -> Option<&str>

The ID of the security group that is referenced in the security group rule.

pub fn description(&self) -> Option<&str>

The description of the security group rule.

impl SecurityGroupRuleRequest

pub fn builder() -> SecurityGroupRuleRequestBuilder

Creates a new builder-style object to manufacture SecurityGroupRuleRequest.

Trait Implementations

impl Clone for SecurityGroupRuleRequest

fn clone(&self) -> SecurityGroupRuleRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SecurityGroupRuleRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for SecurityGroupRuleRequest

fn eq(&self, other: &SecurityGroupRuleRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SecurityGroupRuleRequest