Struct aws_sdk_wafv2::types::IpSet
source · #[non_exhaustive]pub struct IpSet {
pub name: Option<String>,
pub id: Option<String>,
pub arn: Option<String>,
pub description: Option<String>,
pub ip_address_version: Option<IpAddressVersion>,
pub addresses: Option<Vec<String>>,
}Expand description
Contains zero or more IP addresses or blocks of IP addresses specified in Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0. For information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
WAF assigns an ARN to each IPSet that you create. To use an IP set in a rule, you provide the ARN to the Rule statement IPSetReferenceStatement.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.name: Option<String>The name of the IP set. You cannot change the name of an IPSet after you create it.
id: Option<String>A unique identifier for the set. This ID is returned in the responses to create and list commands. You provide it to operations like update and delete.
arn: Option<String>The Amazon Resource Name (ARN) of the entity.
description: Option<String>A description of the IP set that helps with identification.
ip_address_version: Option<IpAddressVersion>The version of the IP addresses, either IPV4 or IPV6.
addresses: Option<Vec<String>>Contains an array of strings that specifies zero or more IP addresses or blocks of IP addresses. All addresses must be specified using Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
Example address strings:
-
To configure WAF to allow, block, or count requests that originated from the IP address 192.0.2.44, specify
192.0.2.44/32. -
To configure WAF to allow, block, or count requests that originated from IP addresses from 192.0.2.0 to 192.0.2.255, specify
192.0.2.0/24. -
To configure WAF to allow, block, or count requests that originated from the IP address 1111:0000:0000:0000:0000:0000:0000:0111, specify
1111:0000:0000:0000:0000:0000:0000:0111/128. -
To configure WAF to allow, block, or count requests that originated from IP addresses 1111:0000:0000:0000:0000:0000:0000:0000 to 1111:0000:0000:0000:ffff:ffff:ffff:ffff, specify
1111:0000:0000:0000:0000:0000:0000:0000/64.
For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
Example JSON Addresses specifications:
-
Empty array:
"Addresses": [] -
Array with one address:
"Addresses": ["192.0.2.44/32"] -
Array with three addresses:
"Addresses": ["192.0.2.44/32", "192.0.2.0/24", "192.0.0.0/16"] -
INVALID specification:
"Addresses": [""]INVALID
Implementations§
source§impl IpSet
impl IpSet
sourcepub fn name(&self) -> Option<&str>
pub fn name(&self) -> Option<&str>
The name of the IP set. You cannot change the name of an IPSet after you create it.
sourcepub fn id(&self) -> Option<&str>
pub fn id(&self) -> Option<&str>
A unique identifier for the set. This ID is returned in the responses to create and list commands. You provide it to operations like update and delete.
sourcepub fn description(&self) -> Option<&str>
pub fn description(&self) -> Option<&str>
A description of the IP set that helps with identification.
sourcepub fn ip_address_version(&self) -> Option<&IpAddressVersion>
pub fn ip_address_version(&self) -> Option<&IpAddressVersion>
The version of the IP addresses, either IPV4 or IPV6.
sourcepub fn addresses(&self) -> Option<&[String]>
pub fn addresses(&self) -> Option<&[String]>
Contains an array of strings that specifies zero or more IP addresses or blocks of IP addresses. All addresses must be specified using Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
Example address strings:
-
To configure WAF to allow, block, or count requests that originated from the IP address 192.0.2.44, specify
192.0.2.44/32. -
To configure WAF to allow, block, or count requests that originated from IP addresses from 192.0.2.0 to 192.0.2.255, specify
192.0.2.0/24. -
To configure WAF to allow, block, or count requests that originated from the IP address 1111:0000:0000:0000:0000:0000:0000:0111, specify
1111:0000:0000:0000:0000:0000:0000:0111/128. -
To configure WAF to allow, block, or count requests that originated from IP addresses 1111:0000:0000:0000:0000:0000:0000:0000 to 1111:0000:0000:0000:ffff:ffff:ffff:ffff, specify
1111:0000:0000:0000:0000:0000:0000:0000/64.
For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
Example JSON Addresses specifications:
-
Empty array:
"Addresses": [] -
Array with one address:
"Addresses": ["192.0.2.44/32"] -
Array with three addresses:
"Addresses": ["192.0.2.44/32", "192.0.2.0/24", "192.0.0.0/16"] -
INVALID specification:
"Addresses": [""]INVALID