:doc:`SecurityHub <../../securityhub>` / Client / batch_update_findings_v2

************************
batch_update_findings_v2
************************



.. py:method:: SecurityHub.Client.batch_update_findings_v2(**kwargs)

  

  Used by customers to update information about their investigation into a finding. Requested by delegated administrator accounts or member accounts. Delegated administrator accounts can update findings for their account and their member accounts. Member accounts can update findings for their account. ``BatchUpdateFindings`` and ``BatchUpdateFindingV2`` both use ``securityhub:BatchUpdateFindings`` in the ``Action`` element of an IAM policy statement. You must have permission to perform the ``securityhub:BatchUpdateFindings`` action. Updates from ``BatchUpdateFindingsV2`` don't affect the value of f ``inding_info.modified_time``, ``finding_info.modified_time_dt``, ``time``, ``time_dt for a finding``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/BatchUpdateFindingsV2>`_  


  **Request Syntax**
  ::

    response = client.batch_update_findings_v2(
        MetadataUids=[
            'string',
        ],
        FindingIdentifiers=[
            {
                'CloudAccountUid': 'string',
                'FindingInfoUid': 'string',
                'MetadataProductUid': 'string'
            },
        ],
        Comment='string',
        SeverityId=123,
        StatusId=123
    )
    
  :type MetadataUids: list
  :param MetadataUids: 

    The list of finding ``metadata.uid`` to indicate findings to update. Finding ``metadata.uid`` is a globally unique identifier associated with the finding. Customers cannot use ``MetadataUids`` together with ``FindingIdentifiers``.

    

  
    - *(string) --* 

    

  :type FindingIdentifiers: list
  :param FindingIdentifiers: 

    Provides information to identify a specific V2 finding.

    

  
    - *(dict) --* 

      Provides a standard to identify security findings using OCSF.

      

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

        Finding cloud.account.uid, which is a unique identifier in the Amazon Web Services account..

        

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

        Finding finding_info.uid, which is a unique identifier for the finding from the finding provider.

        

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

        Finding metadata.product.uid, which is a unique identifier for the product.

        

      
    

  :type Comment: string
  :param Comment: 

    The updated value for a user provided comment about the finding. Minimum character length 1. Maximum character length 512.

    

  
  :type SeverityId: integer
  :param SeverityId: 

    The updated value for the normalized severity identifier. The severity ID is an integer with the allowed enum values [0, 1, 2, 3, 4, 5, 99]. When customer provides the updated severity ID, the string sibling severity will automatically be updated in the finding.

    

  
  :type StatusId: integer
  :param StatusId: 

    The updated value for the normalized status identifier. The status ID is an integer with the allowed enum values [0, 1, 2, 3, 4, 5, 6, 99]. When customer provides the updated status ID, the string sibling status will automatically be updated in the finding.

    

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

    
    ::

      {
          'ProcessedFindings': [
              {
                  'FindingIdentifier': {
                      'CloudAccountUid': 'string',
                      'FindingInfoUid': 'string',
                      'MetadataProductUid': 'string'
                  },
                  'MetadataUid': 'string'
              },
          ],
          'UnprocessedFindings': [
              {
                  'FindingIdentifier': {
                      'CloudAccountUid': 'string',
                      'FindingInfoUid': 'string',
                      'MetadataProductUid': 'string'
                  },
                  'MetadataUid': 'string',
                  'ErrorCode': 'ResourceNotFoundException'|'ValidationException'|'InternalServerException'|'ConflictException',
                  'ErrorMessage': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ProcessedFindings** *(list) --* 

        The list of findings that were updated successfully.

        
        

        - *(dict) --* 

          The list of findings that were updated.

          
          

          - **FindingIdentifier** *(dict) --* 

            The finding identifier of a processed finding.

            
            

            - **CloudAccountUid** *(string) --* 

              Finding cloud.account.uid, which is a unique identifier in the Amazon Web Services account..

              
            

            - **FindingInfoUid** *(string) --* 

              Finding finding_info.uid, which is a unique identifier for the finding from the finding provider.

              
            

            - **MetadataProductUid** *(string) --* 

              Finding metadata.product.uid, which is a unique identifier for the product.

              
        
          

          - **MetadataUid** *(string) --* 

            The metadata.uid of a processed finding.

            
      
    
      

      - **UnprocessedFindings** *(list) --* 

        The list of V2 findings that were not updated.

        
        

        - *(dict) --* 

          The list of findings that were not updated.

          
          

          - **FindingIdentifier** *(dict) --* 

            The finding identifier of an unprocessed finding.

            
            

            - **CloudAccountUid** *(string) --* 

              Finding cloud.account.uid, which is a unique identifier in the Amazon Web Services account..

              
            

            - **FindingInfoUid** *(string) --* 

              Finding finding_info.uid, which is a unique identifier for the finding from the finding provider.

              
            

            - **MetadataProductUid** *(string) --* 

              Finding metadata.product.uid, which is a unique identifier for the product.

              
        
          

          - **MetadataUid** *(string) --* 

            The metadata.uid of an unprocessed finding.

            
          

          - **ErrorCode** *(string) --* 

            Indicates the specific type of error preventing successful processing of a finding during a batch update operation.

            
          

          - **ErrorMessage** *(string) --* 

            A detailed description of why a finding could not be processed during a batch update operation.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`SecurityHub.Client.exceptions.InternalServerException`

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

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

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

  
  *   :py:class:`SecurityHub.Client.exceptions.ConflictException`

  