:doc:`MediaLive <../../medialive>` / Client / transfer_input_device

*********************
transfer_input_device
*********************



.. py:method:: MediaLive.Client.transfer_input_device(**kwargs)

  Start an input device transfer to another AWS account. After you make the request, the other account must accept or reject the transfer.

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/medialive-2017-10-14/TransferInputDevice>`_  


  **Request Syntax**
  ::

    response = client.transfer_input_device(
        InputDeviceId='string',
        TargetCustomerId='string',
        TargetRegion='string',
        TransferMessage='string'
    )
    
  :type InputDeviceId: string
  :param InputDeviceId: **[REQUIRED]** The unique ID of this input device. For example, hd-123456789abcdef.

  
  :type TargetCustomerId: string
  :param TargetCustomerId: The AWS account ID (12 digits) for the recipient of the device transfer.

  
  :type TargetRegion: string
  :param TargetRegion: The target AWS region to transfer the device.

  
  :type TransferMessage: string
  :param TransferMessage: An optional message for the recipient. Maximum 280 characters.

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* The device transfer request has started.
  
  **Exceptions**
  
  *   :py:class:`MediaLive.Client.exceptions.BadRequestException`

  
  *   :py:class:`MediaLive.Client.exceptions.UnprocessableEntityException`

  
  *   :py:class:`MediaLive.Client.exceptions.InternalServerErrorException`

  
  *   :py:class:`MediaLive.Client.exceptions.ForbiddenException`

  
  *   :py:class:`MediaLive.Client.exceptions.BadGatewayException`

  
  *   :py:class:`MediaLive.Client.exceptions.NotFoundException`

  
  *   :py:class:`MediaLive.Client.exceptions.GatewayTimeoutException`

  
  *   :py:class:`MediaLive.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`MediaLive.Client.exceptions.ConflictException`

  