:doc:`CloudWatchRUM <../../rum>` / Client / batch_delete_rum_metric_definitions

***********************************
batch_delete_rum_metric_definitions
***********************************



.. py:method:: CloudWatchRUM.Client.batch_delete_rum_metric_definitions(**kwargs)

  

  Removes the specified metrics from being sent to an extended metrics destination.

   

  If some metric definition IDs specified in a ``BatchDeleteRumMetricDefinitions`` operations are not valid, those metric definitions fail and return errors, but all valid metric definition IDs in the same operation are still deleted.

   

  The maximum number of metric definitions that you can specify in one ``BatchDeleteRumMetricDefinitions`` operation is 200.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/rum-2018-05-10/BatchDeleteRumMetricDefinitions>`_  


  **Request Syntax**
  ::

    response = client.batch_delete_rum_metric_definitions(
        AppMonitorName='string',
        Destination='CloudWatch'|'Evidently',
        DestinationArn='string',
        MetricDefinitionIds=[
            'string',
        ]
    )
    
  :type AppMonitorName: string
  :param AppMonitorName: **[REQUIRED]** 

    The name of the CloudWatch RUM app monitor that is sending these metrics.

    

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

    Defines the destination where you want to stop sending the specified metrics. Valid values are ``CloudWatch`` and ``Evidently``. If you specify ``Evidently``, you must also specify the ARN of the CloudWatchEvidently experiment that is to be the destination and an IAM role that has permission to write to the experiment.

    

  
  :type DestinationArn: string
  :param DestinationArn: 

    This parameter is required if ``Destination`` is ``Evidently``. If ``Destination`` is ``CloudWatch``, do not use this parameter.

     

    This parameter specifies the ARN of the Evidently experiment that was receiving the metrics that are being deleted.

    

  
  :type MetricDefinitionIds: list
  :param MetricDefinitionIds: **[REQUIRED]** 

    An array of structures which define the metrics that you want to stop sending.

    

  
    - *(string) --* 

    

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

    
    ::

      {
          'Errors': [
              {
                  'MetricDefinitionId': 'string',
                  'ErrorCode': 'string',
                  'ErrorMessage': 'string'
              },
          ],
          'MetricDefinitionIds': [
              'string',
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Errors** *(list) --* 

        An array of error objects, if the operation caused any errors.

        
        

        - *(dict) --* 

          A structure that defines one error caused by a `BatchCreateRumMetricsDefinitions <https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchDeleteRumMetricsDefinitions.html>`__ operation.

          
          

          - **MetricDefinitionId** *(string) --* 

            The ID of the metric definition that caused this error.

            
          

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

            The error code.

            
          

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

            The error message for this metric definition.

            
      
    
      

      - **MetricDefinitionIds** *(list) --* 

        The IDs of the metric definitions that were deleted.

        
        

        - *(string) --* 
    
  
  **Exceptions**
  
  *   :py:class:`CloudWatchRUM.Client.exceptions.ConflictException`

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

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

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

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

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

  