:doc:`WAFV2 <../../wafv2>` / Client / disassociate_web_acl

********************
disassociate_web_acl
********************



.. py:method:: WAFV2.Client.disassociate_web_acl(**kwargs)

  

  Disassociates the specified resource from its web ACL association, if it has one.

   

  Use this for all resource types except for Amazon CloudFront distributions. For Amazon CloudFront, call ``UpdateDistribution`` for the distribution and provide an empty web ACL ID. For information, see `UpdateDistribution <https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html>`__ in the *Amazon CloudFront API Reference*.

   

  **Required permissions for customer-managed IAM policies**

   

  This call requires permissions that are specific to the protected resource type. For details, see `Permissions for DisassociateWebACL <https://docs.aws.amazon.com/waf/latest/developerguide/security_iam_service-with-iam.html#security_iam_action-DisassociateWebACL>`__ in the *WAF Developer Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/DisassociateWebACL>`_  


  **Request Syntax**
  ::

    response = client.disassociate_web_acl(
        ResourceArn='string'
    )
    
  :type ResourceArn: string
  :param ResourceArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the resource to disassociate from 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``
     
    * For an Amplify application: ``arn:partition:amplify:region:account-id:apps/app-id``
    

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`WAFV2.Client.exceptions.WAFInternalErrorException`

  
  *   :py:class:`WAFV2.Client.exceptions.WAFInvalidParameterException`

  
  *   :py:class:`WAFV2.Client.exceptions.WAFNonexistentItemException`

  
  *   :py:class:`WAFV2.Client.exceptions.WAFInvalidOperationException`

  