:doc:`CodePipeline <../../codepipeline>` / Client / acknowledge_job

***************
acknowledge_job
***************



.. py:method:: CodePipeline.Client.acknowledge_job(**kwargs)

  

  Returns information about a specified job and whether that job has been received by the job worker. Used for custom actions only.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/codepipeline-2015-07-09/AcknowledgeJob>`_  


  **Request Syntax**
  ::

    response = client.acknowledge_job(
        jobId='string',
        nonce='string'
    )
    
  :type jobId: string
  :param jobId: **[REQUIRED]** 

    The unique system-generated ID of the job for which you want to confirm receipt.

    

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

    A system-generated random number that CodePipeline uses to ensure that the job is being worked on by only one job worker. Get this number from the response of the  PollForJobs request that returned this job.

    

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

    
    ::

      {
          'status': 'Created'|'Queued'|'Dispatched'|'InProgress'|'TimedOut'|'Succeeded'|'Failed'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Represents the output of an AcknowledgeJob action.

      
      

      - **status** *(string) --* 

        Whether the job worker has received the specified job.

        
  
  **Exceptions**
  
  *   :py:class:`CodePipeline.Client.exceptions.ValidationException`

  
  *   :py:class:`CodePipeline.Client.exceptions.InvalidNonceException`

  
  *   :py:class:`CodePipeline.Client.exceptions.JobNotFoundException`

  