:doc:`ElasticLoadBalancing <../../elb>` / Client / disable_availability_zones_for_load_balancer

********************************************
disable_availability_zones_for_load_balancer
********************************************



.. py:method:: ElasticLoadBalancing.Client.disable_availability_zones_for_load_balancer(**kwargs)

  

  Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer in EC2-Classic or a default VPC.

   

  For load balancers in a non-default VPC, use  DetachLoadBalancerFromSubnets.

   

  There must be at least one Availability Zone registered with a load balancer at all times. After an Availability Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go into the ``OutOfService`` state. Then, the load balancer attempts to equally balance the traffic among its remaining Availability Zones.

   

  For more information, see `Add or Remove Availability Zones <https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html>`__ in the *Classic Load Balancers Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/DisableAvailabilityZonesForLoadBalancer>`_  


  **Request Syntax**
  ::

    response = client.disable_availability_zones_for_load_balancer(
        LoadBalancerName='string',
        AvailabilityZones=[
            'string',
        ]
    )
    
  :type LoadBalancerName: string
  :param LoadBalancerName: **[REQUIRED]** 

    The name of the load balancer.

    

  
  :type AvailabilityZones: list
  :param AvailabilityZones: **[REQUIRED]** 

    The Availability Zones.

    

  
    - *(string) --* 

    

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

    
    ::

      {
          'AvailabilityZones': [
              'string',
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Contains the output for DisableAvailabilityZonesForLoadBalancer.

      
      

      - **AvailabilityZones** *(list) --* 

        The remaining Availability Zones for the load balancer.

        
        

        - *(string) --* 
    
  
  **Exceptions**
  
  *   :py:class:`ElasticLoadBalancing.Client.exceptions.AccessPointNotFoundException`

  
  *   :py:class:`ElasticLoadBalancing.Client.exceptions.InvalidConfigurationRequestException`

  

  **Examples**

  This example removes the specified Availability Zone from the set of Availability Zones for the specified load balancer.
  ::

    response = client.disable_availability_zones_for_load_balancer(
        AvailabilityZones=[
            'us-west-2a',
        ],
        LoadBalancerName='my-load-balancer',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'AvailabilityZones': [
            'us-west-2b',
        ],
        'ResponseMetadata': {
            '...': '...',
        },
    }

  