Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. wafv2
  5. WebAclAssociation

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi
pulumi/pulumi-aws-native

aws-native.wafv2.WebAclAssociation

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi
pulumi/pulumi-aws-native

Associates WebACL to Application Load Balancer, CloudFront or API Gateway.

Create WebAclAssociation Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new WebAclAssociation(name: string, args: WebAclAssociationArgs, opts?: CustomResourceOptions);
@overload
def WebAclAssociation(resource_name: str,
                      args: WebAclAssociationArgs,
                      opts: Optional[ResourceOptions] = None)

@overload
def WebAclAssociation(resource_name: str,
                      opts: Optional[ResourceOptions] = None,
                      resource_arn: Optional[str] = None,
                      web_acl_arn: Optional[str] = None)
func NewWebAclAssociation(ctx *Context, name string, args WebAclAssociationArgs, opts ...ResourceOption) (*WebAclAssociation, error)
public WebAclAssociation(string name, WebAclAssociationArgs args, CustomResourceOptions? opts = null)
public WebAclAssociation(String name, WebAclAssociationArgs args)
public WebAclAssociation(String name, WebAclAssociationArgs args, CustomResourceOptions options)

type: aws-native:wafv2:WebAclAssociation
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. WebAclAssociationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. WebAclAssociationArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. WebAclAssociationArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. WebAclAssociationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. WebAclAssociationArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

WebAclAssociation Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The WebAclAssociation resource accepts the following input properties:

ResourceArn This property is required. 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 AWS 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 AWS App Runner service: arn: *partition* :apprunner: *region* : *account-id* :service/ *apprunner-service-name* / *apprunner-service-id*
  • For an AWS Verified Access instance: arn: *partition* :ec2: *region* : *account-id* :verified-access-instance/ *instance-id*
WebAclArn This property is required. string
The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.
ResourceArn This property is required. 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 AWS 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 AWS App Runner service: arn: *partition* :apprunner: *region* : *account-id* :service/ *apprunner-service-name* / *apprunner-service-id*
  • For an AWS Verified Access instance: arn: *partition* :ec2: *region* : *account-id* :verified-access-instance/ *instance-id*
WebAclArn This property is required. string
The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.
resourceArn This property is required. 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 AWS 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 AWS App Runner service: arn: *partition* :apprunner: *region* : *account-id* :service/ *apprunner-service-name* / *apprunner-service-id*
  • For an AWS Verified Access instance: arn: *partition* :ec2: *region* : *account-id* :verified-access-instance/ *instance-id*
webAclArn This property is required. String
The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.
resourceArn This property is required. 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 AWS 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 AWS App Runner service: arn: *partition* :apprunner: *region* : *account-id* :service/ *apprunner-service-name* / *apprunner-service-id*
  • For an AWS Verified Access instance: arn: *partition* :ec2: *region* : *account-id* :verified-access-instance/ *instance-id*
webAclArn This property is required. string
The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.
resource_arn This property is required. str

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 AWS 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 AWS App Runner service: arn: *partition* :apprunner: *region* : *account-id* :service/ *apprunner-service-name* / *apprunner-service-id*
  • For an AWS Verified Access instance: arn: *partition* :ec2: *region* : *account-id* :verified-access-instance/ *instance-id*
web_acl_arn This property is required. str
The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.
resourceArn This property is required. 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 AWS 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 AWS App Runner service: arn: *partition* :apprunner: *region* : *account-id* :service/ *apprunner-service-name* / *apprunner-service-id*
  • For an AWS Verified Access instance: arn: *partition* :ec2: *region* : *account-id* :verified-access-instance/ *instance-id*
webAclArn This property is required. String
The Amazon Resource Name (ARN) of the web ACL that you want to associate with the resource.

Outputs

All input properties are implicitly available as output properties. Additionally, the WebAclAssociation resource produces the following output properties:

Id string
The provider-assigned unique ID for this managed resource.
Id string
The provider-assigned unique ID for this managed resource.
id String
The provider-assigned unique ID for this managed resource.
id string
The provider-assigned unique ID for this managed resource.
id str
The provider-assigned unique ID for this managed resource.
id String
The provider-assigned unique ID for this managed resource.

Package Details

Repository
AWS Native pulumi/pulumi-aws-native
License
Apache-2.0

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi
pulumi/pulumi-aws-native