Add given IPs to an IP set if they don’t already exist.
Inputs
フィールド
種類
説明
region [required]
enum
default: Global (Cloudfront)
ipSetId [required]
string
The IPSetId of the IPSet that you want to update. IPSetId is returned by CreateIPSet and by ListIPSets.
ipType [required]
enum
The type of IPs: IPV4 or IPV6.
Allowed enum values: IPV4,IPV6
default: IPV4
ipAddresses [required]
[string]
A list of one or more IP addresses or blocks of IP addresses. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
scope
enum
DEPRECATED: Specify whether this is for an Amazon CloudFront distribution or for a regional application. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, or an AWS AppSync GraphQL API.
Allowed enum values: GLOBAL,REGIONAL
Outputs
Expand All
フィールド
種類
説明
ipSet
object
IPSetId [required]
string
The IPSetId for an IPSet. You use IPSetId to get information about an IPSet (see GetIPSet), update an IPSet (see UpdateIPSet), insert an IPSet into a Rule or delete one from a Rule (see UpdateRule), and delete an IPSet from AWS WAF (see DeleteIPSet). IPSetId is returned by CreateIPSet and by ListIPSets.
Name
string
A friendly name or description of the IPSet. You can't change the name of an IPSet after you create it.
IPSetDescriptors [required]
[object]
The IP address type (IPV4 or IPV6) and the IP address range (in CIDR notation) that web requests originate from. If the WebACL is associated with a CloudFront distribution and the viewer did not use an HTTP proxy or a load balancer to send the request, this is the value of the c-ip field in the CloudFront access logs.
Type [required]
string
Specify IPV4 or IPV6.
Value [required]
string
Specify an IPv4 address by using CIDR notation. For example: To configure AWS 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 AWS 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. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing. Specify an IPv6 address by using CIDR notation. For example: To configure AWS 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 AWS 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.
