:doc:`Billing <../../billing>` / Client / update_billing_view

*******************
update_billing_view
*******************



.. py:method:: Billing.Client.update_billing_view(**kwargs)

  

  An API to update the attributes of the billing view.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/UpdateBillingView>`_  


  **Request Syntax**
  ::

    response = client.update_billing_view(
        arn='string',
        name='string',
        description='string',
        dataFilterExpression={
            'dimensions': {
                'key': 'LINKED_ACCOUNT',
                'values': [
                    'string',
                ]
            },
            'tags': {
                'key': 'string',
                'values': [
                    'string',
                ]
            },
            'costCategories': {
                'key': 'string',
                'values': [
                    'string',
                ]
            },
            'timeRange': {
                'beginDateInclusive': datetime(2015, 1, 1),
                'endDateInclusive': datetime(2015, 1, 1)
            }
        }
    )
    
  :type arn: string
  :param arn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.

    

  
  :type name: string
  :param name: 

    The name of the billing view.

    

  
  :type description: string
  :param description: 

    The description of the billing view.

    

  
  :type dataFilterExpression: dict
  :param dataFilterExpression: 

    See `Expression <https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_billing_Expression.html>`__. Billing view only supports ``LINKED_ACCOUNT``, ``Tags``, and ``CostCategories``.

    

  
    - **dimensions** *(dict) --* 

      The specific ``Dimension`` to use for ``Expression``.

      

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

        The names of the metadata types that you can use to filter and group your results.

        

      
      - **values** *(list) --* **[REQUIRED]** 

        The metadata values that you can use to filter and group your results.

        

      
        - *(string) --* 

        
    
    
    - **tags** *(dict) --* 

      The specific ``Tag`` to use for ``Expression``.

      

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

        The key for the tag.

        

      
      - **values** *(list) --* **[REQUIRED]** 

        The specific value of the tag.

        

      
        - *(string) --* 

        
    
    
    - **costCategories** *(dict) --* 

      The filter that's based on ``CostCategory`` values.

      

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

        The unique name of the Cost Category.

        

      
      - **values** *(list) --* **[REQUIRED]** 

        The specific value of the Cost Category.

        

      
        - *(string) --* 

        
    
    
    - **timeRange** *(dict) --* 

      Specifies a time range filter for the billing view data.

      

    
      - **beginDateInclusive** *(datetime) --* 

        The inclusive start date of the time range.

        

      
      - **endDateInclusive** *(datetime) --* 

        The inclusive end date of the time range.

        

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

    
    ::

      {
          'arn': 'string',
          'updatedAt': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **arn** *(string) --* 

        The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.

        
      

      - **updatedAt** *(datetime) --* 

        The time when the billing view was last updated.

        
  
  **Exceptions**
  
  *   :py:class:`Billing.Client.exceptions.BillingViewHealthStatusException`

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

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

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

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

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

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

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

  