:doc:`BedrockAgentCore <../../bedrock-agentcore>` / Client / start_memory_extraction_job

***************************
start_memory_extraction_job
***************************



.. py:method:: BedrockAgentCore.Client.start_memory_extraction_job(**kwargs)

  

  Starts a memory extraction job that processes events that failed extraction previously in an AgentCore Memory resource and produces structured memory records. When earlier extraction attempts have left events unprocessed, this job will pick up and extract those as well.

   

  To use this operation, you must have the ``bedrock-agentcore:StartMemoryExtractionJob`` permission.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/StartMemoryExtractionJob>`_  


  **Request Syntax**
  ::

    response = client.start_memory_extraction_job(
        memoryId='string',
        extractionJob={
            'jobId': 'string'
        },
        clientToken='string'
    )
    
  :type memoryId: string
  :param memoryId: **[REQUIRED]** 

    The unique identifier of the memory for which to start extraction jobs.

    

  
  :type extractionJob: dict
  :param extractionJob: **[REQUIRED]** 

    Extraction job to start in this operation.

    

  
    - **jobId** *(string) --* **[REQUIRED]** 

      The unique identifier of the extraction job.

      

    
  
  :type clientToken: string
  :param clientToken: 

    A unique, case-sensitive identifier to ensure idempotent processing of the request.

    This field is autopopulated if not provided.

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

    
    ::

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

    

    - *(dict) --* 
      

      - **jobId** *(string) --* 

        Extraction Job ID that was attempted to start.

        
  
  **Exceptions**
  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ThrottledException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ServiceException`

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

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ValidationException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ResourceNotFoundException`

  