:doc:`CleanRoomsService <../../cleanrooms>` / Client / list_protected_jobs

*******************
list_protected_jobs
*******************



.. py:method:: CleanRoomsService.Client.list_protected_jobs(**kwargs)

  

  Lists protected jobs, sorted by most recent job.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cleanrooms-2022-02-17/ListProtectedJobs>`_  


  **Request Syntax**
  ::

    response = client.list_protected_jobs(
        membershipIdentifier='string',
        status='SUBMITTED'|'STARTED'|'CANCELLED'|'CANCELLING'|'FAILED'|'SUCCESS',
        nextToken='string',
        maxResults=123
    )
    
  :type membershipIdentifier: string
  :param membershipIdentifier: **[REQUIRED]** 

    The identifier for the membership in the collaboration.

    

  
  :type status: string
  :param status: 

    A filter on the status of the protected job.

    

  
  :type nextToken: string
  :param nextToken: 

    The pagination token that's used to fetch the next set of results.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results that are returned for an API request call. The service chooses a default number if you don't set one. The service might return a `nextToken` even if the `maxResults` value has not been met.

    

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

    
    ::

      {
          'nextToken': 'string',
          'protectedJobs': [
              {
                  'id': 'string',
                  'membershipId': 'string',
                  'membershipArn': 'string',
                  'createTime': datetime(2015, 1, 1),
                  'status': 'SUBMITTED'|'STARTED'|'CANCELLED'|'CANCELLING'|'FAILED'|'SUCCESS',
                  'receiverConfigurations': [
                      {
                          'analysisType': 'DIRECT_ANALYSIS',
                          'configurationDetails': {
                              'directAnalysisConfigurationDetails': {
                                  'receiverAccountIds': [
                                      'string',
                                  ]
                              }
                          }
                      },
                  ]
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **nextToken** *(string) --* 

        The pagination token that's used to fetch the next set of results.

        
      

      - **protectedJobs** *(list) --* 

        A list of protected job summaries.

        
        

        - *(dict) --* 

          The protected job summary for the objects listed by the request.

          
          

          - **id** *(string) --* 

            The ID of the protected job.

            
          

          - **membershipId** *(string) --* 

            The unique ID for the membership that initiated the protected job.

            
          

          - **membershipArn** *(string) --* 

            The unique ARN for the membership that initiated the protected job.

            
          

          - **createTime** *(datetime) --* 

            The time the protected job was created.

            
          

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

            The status of the protected job.

            
          

          - **receiverConfigurations** *(list) --* 

            The receiver configurations for the protected job.

            
            

            - *(dict) --* 

              The protected job receiver configuration.

              
              

              - **analysisType** *(string) --* 

                The analysis type for the protected job receiver configuration.

                
              

              - **configurationDetails** *(dict) --* 

                The configuration details for the protected job receiver.

                .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: ``directAnalysisConfigurationDetails``.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows::

                                'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}


              
                

                - **directAnalysisConfigurationDetails** *(dict) --* 

                  The details needed to configure the direct analysis.

                  
                  

                  - **receiverAccountIds** *(list) --* 

                    The receiver account IDs.

                    
                    

                    - *(string) --* 
                
              
            
          
        
      
    
  
  **Exceptions**
  
  *   :py:class:`CleanRoomsService.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`CleanRoomsService.Client.exceptions.InternalServerException`

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

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

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

  