:doc:`Inspector <../../inspector>` / Client / stop_assessment_run

*******************
stop_assessment_run
*******************



.. py:method:: Inspector.Client.stop_assessment_run(**kwargs)

  

  Stops the assessment run that is specified by the ARN of the assessment run.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/StopAssessmentRun>`_  


  **Request Syntax**
  ::

    response = client.stop_assessment_run(
        assessmentRunArn='string',
        stopAction='START_EVALUATION'|'SKIP_EVALUATION'
    )
    
  :type assessmentRunArn: string
  :param assessmentRunArn: **[REQUIRED]** 

    The ARN of the assessment run that you want to stop.

    

  
  :type stopAction: string
  :param stopAction: 

    An input option that can be set to either START_EVALUATION or SKIP_EVALUATION. START_EVALUATION (the default value), stops the AWS agent from collecting data and begins the results evaluation and the findings generation process. SKIP_EVALUATION cancels the assessment run immediately, after which no findings are generated.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`Inspector.Client.exceptions.InternalException`

  
  *   :py:class:`Inspector.Client.exceptions.InvalidInputException`

  
  *   :py:class:`Inspector.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Inspector.Client.exceptions.NoSuchEntityException`

  
  *   :py:class:`Inspector.Client.exceptions.ServiceTemporarilyUnavailableException`

  

  **Examples**

  Stops the assessment run that is specified by the ARN of the assessment run.
  ::

    response = client.stop_assessment_run(
        assessmentRunArn='arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe',
    )
    
    print(response)

  
  Expected Output:
  ::

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

  