Struct aws_sdk_wafv2::operation::associate_web_acl::builders::AssociateWebACLFluentBuilder

pub struct AssociateWebACLFluentBuilder { /* private fields */ }

Fluent builder constructing a request to AssociateWebACL.

Associates a web ACL with a regional application resource, to protect the resource. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access instance.

For Amazon CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To associate a web ACL, in the CloudFront call UpdateDistribution, set the web ACL ID to the Amazon Resource Name (ARN) of the web ACL. For information, see UpdateDistribution in the Amazon CloudFront Developer Guide.

When you make changes to web ACLs or web ACL components, like rules and rule groups, WAF propagates the changes everywhere that the web ACL and its components are stored and used. Your changes are applied within seconds, but there might be a brief period of inconsistency when the changes have arrived in some places and not in others. So, for example, if you change a rule action setting, the action might be the old action in one area and the new action in another area. Or if you add an IP address to an IP set used in a blocking rule, the new address might briefly be blocked in one area while still allowed in another. This temporary inconsistency can occur when you first associate a web ACL with an Amazon Web Services resource and when you change a web ACL that is already associated with a resource. Generally, any inconsistencies of this type last only a few seconds.

Implementations

impl AssociateWebACLFluentBuilder

pub fn as_input(&self) -> &AssociateWebAclInputBuilder

Access the AssociateWebACL as a reference.

pub async fn send( self ) -> Result<AssociateWebAclOutput, SdkError<AssociateWebACLError, HttpResponse>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub async fn customize( self ) -> Result<CustomizableOperation<AssociateWebAclOutput, AssociateWebACLError>, SdkError<AssociateWebACLError>>

Consumes this builder, creating a customizable operation that can be modified before being sent.

pub fn web_acl_arn(self, input: impl Into<String>) -> Self

The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.

pub fn set_web_acl_arn(self, input: Option<String>) -> Self

The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.

pub fn get_web_acl_arn(&self) -> &Option<String>

The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.

pub fn resource_arn(self, input: impl Into<String>) -> Self

The Amazon Resource Name (ARN) of the resource to associate with the web ACL.

The ARN must be in one of the following formats:

• For an Application Load Balancer: arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id

• For an Amazon API Gateway REST API: arn:partition:apigateway:region::/restapis/api-id/stages/stage-name

• For an AppSync GraphQL API: arn:partition:appsync:region:account-id:apis/GraphQLApiId

• For an Amazon Cognito user pool: arn:partition:cognito-idp:region:account-id:userpool/user-pool-id

• For an App Runner service: arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id

• For an Amazon Web Services Verified Access instance: arn:partition:ec2:region:account-id:verified-access-instance/instance-id

pub fn set_resource_arn(self, input: Option<String>) -> Self

The Amazon Resource Name (ARN) of the resource to associate with the web ACL.

The ARN must be in one of the following formats:

• For an Application Load Balancer: arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id

• For an Amazon API Gateway REST API: arn:partition:apigateway:region::/restapis/api-id/stages/stage-name

• For an AppSync GraphQL API: arn:partition:appsync:region:account-id:apis/GraphQLApiId

• For an Amazon Cognito user pool: arn:partition:cognito-idp:region:account-id:userpool/user-pool-id

• For an App Runner service: arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id

• For an Amazon Web Services Verified Access instance: arn:partition:ec2:region:account-id:verified-access-instance/instance-id

pub fn get_resource_arn(&self) -> &Option<String>

The Amazon Resource Name (ARN) of the resource to associate with the web ACL.

The ARN must be in one of the following formats:

• For an Application Load Balancer: arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id

• For an Amazon API Gateway REST API: arn:partition:apigateway:region::/restapis/api-id/stages/stage-name

• For an AppSync GraphQL API: arn:partition:appsync:region:account-id:apis/GraphQLApiId

• For an Amazon Cognito user pool: arn:partition:cognito-idp:region:account-id:userpool/user-pool-id

• For an App Runner service: arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id

• For an Amazon Web Services Verified Access instance: arn:partition:ec2:region:account-id:verified-access-instance/instance-id

Trait Implementations

impl Clone for AssociateWebACLFluentBuilder

fn clone(&self) -> AssociateWebACLFluentBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AssociateWebACLFluentBuilder

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

Formats the value using the given formatter.