:doc:`IoT <../../iot>` / Client / reject_certificate_transfer

***************************
reject_certificate_transfer
***************************



.. py:method:: IoT.Client.reject_certificate_transfer(**kwargs)

  

  Rejects a pending certificate transfer. After IoT rejects a certificate transfer, the certificate status changes from **PENDING_TRANSFER** to **INACTIVE**.

   

  To check for pending certificate transfers, call  ListCertificates to enumerate your certificates.

   

  This operation can only be called by the transfer destination. After it is called, the certificate will be returned to the source's account in the INACTIVE state.

   

  Requires permission to access the `RejectCertificateTransfer <https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions>`__ action.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iot-2015-05-28/RejectCertificateTransfer>`_  


  **Request Syntax**
  ::

    response = client.reject_certificate_transfer(
        certificateId='string',
        rejectReason='string'
    )
    
  :type certificateId: string
  :param certificateId: **[REQUIRED]** 

    The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

    

  
  :type rejectReason: string
  :param rejectReason: 

    The reason the certificate transfer was rejected.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`IoT.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`IoT.Client.exceptions.TransferAlreadyCompletedException`

  
  *   :py:class:`IoT.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`IoT.Client.exceptions.ThrottlingException`

  
  *   :py:class:`IoT.Client.exceptions.UnauthorizedException`

  
  *   :py:class:`IoT.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`IoT.Client.exceptions.InternalFailureException`

  