:doc:`SecurityHub <../../securityhub>` / Client / create_action_target

********************
create_action_target
********************



.. py:method:: SecurityHub.Client.create_action_target(**kwargs)

  

  Creates a custom action target in Security Hub.

   

  You can use custom actions on findings and insights in Security Hub to trigger target actions in Amazon CloudWatch Events.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/CreateActionTarget>`_  


  **Request Syntax**
  ::

    response = client.create_action_target(
        Name='string',
        Description='string',
        Id='string'
    )
    
  :type Name: string
  :param Name: **[REQUIRED]** 

    The name of the custom action target. Can contain up to 20 characters.

    

  
  :type Description: string
  :param Description: **[REQUIRED]** 

    The description for the custom action target.

    

  
  :type Id: string
  :param Id: **[REQUIRED]** 

    The ID for the custom action target. Can contain up to 20 alphanumeric characters.

    

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

    
    ::

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

    

    - *(dict) --* 
      

      - **ActionTargetArn** *(string) --* 

        The Amazon Resource Name (ARN) for the custom action target.

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

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

  
  *   :py:class:`SecurityHub.Client.exceptions.InvalidAccessException`

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

  
  *   :py:class:`SecurityHub.Client.exceptions.ResourceConflictException`

  