:doc:`Macie2 <../../macie2>` / Client / get_sensitive_data_occurrences

******************************
get_sensitive_data_occurrences
******************************



.. py:method:: Macie2.Client.get_sensitive_data_occurrences(**kwargs)

  

  Retrieves occurrences of sensitive data reported by a finding.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/GetSensitiveDataOccurrences>`_  


  **Request Syntax**
  ::

    response = client.get_sensitive_data_occurrences(
        findingId='string'
    )
    
  :type findingId: string
  :param findingId: **[REQUIRED]** 

    The unique identifier for the finding.

    

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

    
    ::

      {
          'error': 'string',
          'sensitiveDataOccurrences': {
              'string': [
                  {
                      'value': 'string'
                  },
              ]
          },
          'status': 'SUCCESS'|'PROCESSING'|'ERROR'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      The request succeeded.

      
      

      - **error** *(string) --* 

        If an error occurred when Amazon Macie attempted to retrieve occurrences of sensitive data reported by the finding, a description of the error that occurred. This value is null if the status (status) of the request is PROCESSING or SUCCESS.

        
      

      - **sensitiveDataOccurrences** *(dict) --* 

        A map that specifies 1-100 types of sensitive data reported by the finding and, for each type, 1-10 occurrences of sensitive data.

        
        

        - *(string) --* 
          

          - *(list) --* 
            

            - *(dict) --* 

              Specifies 1-10 occurrences of a specific type of sensitive data reported by a finding.

              
              

              - **value** *(string) --* 

                An occurrence of the specified type of sensitive data. Each occurrence contains 1-128 characters.

                
          
        
    
  
      

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

        The status of the request to retrieve occurrences of sensitive data reported by the finding. Possible values are:

         

        
        * ERROR - An error occurred when Amazon Macie attempted to locate, retrieve, or encrypt the sensitive data. The error value indicates the nature of the error that occurred.
         
        * PROCESSING - Macie is processing the request.
         
        * SUCCESS - Macie successfully located, retrieved, and encrypted the sensitive data.
        

        
  
  **Exceptions**
  
  *   :py:class:`Macie2.Client.exceptions.UnprocessableEntityException`

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

  
  *   :py:class:`Macie2.Client.exceptions.ServiceQuotaExceededException`

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

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

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

  