:doc:`AutoScaling <../../autoscaling>` / Client / suspend_processes

*****************
suspend_processes
*****************



.. py:method:: AutoScaling.Client.suspend_processes(**kwargs)

  

  Suspends the specified auto scaling processes, or all processes, for the specified Auto Scaling group.

   

  If you suspend either the ``Launch`` or ``Terminate`` process types, it can prevent other process types from functioning properly. For more information, see `Suspend and resume Amazon EC2 Auto Scaling processes <https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-suspend-resume-processes.html>`__ in the *Amazon EC2 Auto Scaling User Guide*.

   

  To resume processes that have been suspended, call the `ResumeProcesses <https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_ResumeProcesses.html>`__ API.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SuspendProcesses>`_  


  **Request Syntax**
  ::

    response = client.suspend_processes(
        AutoScalingGroupName='string',
        ScalingProcesses=[
            'string',
        ]
    )
    
  :type AutoScalingGroupName: string
  :param AutoScalingGroupName: **[REQUIRED]** 

    The name of the Auto Scaling group.

    

  
  :type ScalingProcesses: list
  :param ScalingProcesses: 

    One or more of the following processes:

     

    
    * ``Launch``
     
    * ``Terminate``
     
    * ``AddToLoadBalancer``
     
    * ``AlarmNotification``
     
    * ``AZRebalance``
     
    * ``HealthCheck``
     
    * ``InstanceRefresh``
     
    * ``ReplaceUnhealthy``
     
    * ``ScheduledActions``
    

     

    If you omit this property, all processes are specified.

    

  
    - *(string) --* 

    

  
  :returns: None
  **Exceptions**
  
  *   :py:class:`AutoScaling.Client.exceptions.ResourceInUseFault`

  
  *   :py:class:`AutoScaling.Client.exceptions.ResourceContentionFault`

  

  **Examples**

  This example suspends the specified scaling process for the specified Auto Scaling group.
  ::

    response = client.suspend_processes(
        AutoScalingGroupName='my-auto-scaling-group',
        ScalingProcesses=[
            'AlarmNotification',
        ],
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'ResponseMetadata': {
            '...': '...',
        },
    }

  