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

***************************************
deregister_instances_from_load_balancer
***************************************



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

  

  Deregisters the specified instances from the specified load balancer. After the instance is deregistered, it no longer receives traffic from the load balancer.

   

  You can use  DescribeLoadBalancers to verify that the instance is deregistered from the load balancer.

   

  For more information, see `Register or De-Register EC2 Instances <https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-deregister-register-instances.html>`__ in the *Classic Load Balancers Guide*.

  

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


  **Request Syntax**
  ::

    response = client.deregister_instances_from_load_balancer(
        LoadBalancerName='string',
        Instances=[
            {
                'InstanceId': 'string'
            },
        ]
    )
    
  :type LoadBalancerName: string
  :param LoadBalancerName: **[REQUIRED]** 

    The name of the load balancer.

    

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

    The IDs of the instances.

    

  
    - *(dict) --* 

      The ID of an EC2 instance.

      

    
      - **InstanceId** *(string) --* 

        The instance ID.

        

      
    

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

    
    ::

      {
          'Instances': [
              {
                  'InstanceId': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Contains the output of DeregisterInstancesFromLoadBalancer.

      
      

      - **Instances** *(list) --* 

        The remaining instances registered with the load balancer.

        
        

        - *(dict) --* 

          The ID of an EC2 instance.

          
          

          - **InstanceId** *(string) --* 

            The instance ID.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`ElasticLoadBalancing.Client.exceptions.AccessPointNotFoundException`

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

  

  **Examples**

  This example deregisters the specified instance from the specified load balancer.
  ::

    response = client.deregister_instances_from_load_balancer(
        Instances=[
            {
                'InstanceId': 'i-d6f6fae3',
            },
        ],
        LoadBalancerName='my-load-balancer',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'Instances': [
            {
                'InstanceId': 'i-207d9717',
            },
            {
                'InstanceId': 'i-afefb49b',
            },
        ],
        'ResponseMetadata': {
            '...': '...',
        },
    }

  