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

************************
create_assessment_target
************************



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

  

  Creates a new assessment target using the ARN of the resource group that is generated by  CreateResourceGroup. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target. If the `service-linked role <https://docs.aws.amazon.com/inspector/latest/userguide/inspector_slr.html>`__ isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector access to AWS Services needed to perform security assessments. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see `Amazon Inspector Assessment Targets <https://docs.aws.amazon.com/inspector/latest/userguide/inspector_applications.html>`__.

  

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


  **Request Syntax**
  ::

    response = client.create_assessment_target(
        assessmentTargetName='string',
        resourceGroupArn='string'
    )
    
  :type assessmentTargetName: string
  :param assessmentTargetName: **[REQUIRED]** 

    The user-defined name that identifies the assessment target that you want to create. The name must be unique within the AWS account.

    

  
  :type resourceGroupArn: string
  :param resourceGroupArn: 

    The ARN that specifies the resource group that is used to create the assessment target. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.

    

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

    
    ::

      {
          'assessmentTargetArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **assessmentTargetArn** *(string) --* 

        The ARN that specifies the assessment target that is created.

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

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

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

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

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

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

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

  

  **Examples**

  Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account.
  ::

    response = client.create_assessment_target(
        assessmentTargetName='ExampleAssessmentTarget',
        resourceGroupArn='arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'assessmentTargetArn': 'arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX',
        'ResponseMetadata': {
            '...': '...',
        },
    }

  