:doc:`Invoicing <../../invoicing>` / Client / get_invoice_unit

****************
get_invoice_unit
****************



.. py:method:: Invoicing.Client.get_invoice_unit(**kwargs)

  

  This retrieves the invoice unit definition.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/invoicing-2024-12-01/GetInvoiceUnit>`_  


  **Request Syntax**
  ::

    response = client.get_invoice_unit(
        InvoiceUnitArn='string',
        AsOf=datetime(2015, 1, 1)
    )
    
  :type InvoiceUnitArn: string
  :param InvoiceUnitArn: **[REQUIRED]** 

    The ARN to identify an invoice unit. This information can't be modified or deleted.

    

  
  :type AsOf: datetime
  :param AsOf: 

    The state of an invoice unit at a specified time. You can see legacy invoice units that are currently deleted if the ``AsOf`` time is set to before it was deleted. If an ``AsOf`` is not provided, the default value is the current time.

    

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

    
    ::

      {
          'InvoiceUnitArn': 'string',
          'InvoiceReceiver': 'string',
          'Name': 'string',
          'Description': 'string',
          'TaxInheritanceDisabled': True|False,
          'Rule': {
              'LinkedAccounts': [
                  'string',
              ],
              'BillSourceAccounts': [
                  'string',
              ]
          },
          'LastModified': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **InvoiceUnitArn** *(string) --* 

        The ARN to identify an invoice unit. This information can't be modified or deleted.

        
      

      - **InvoiceReceiver** *(string) --* 

        The Amazon Web Services account ID chosen to be the receiver of an invoice unit. All invoices generated for that invoice unit will be sent to this account ID.

        
      

      - **Name** *(string) --* 

        The unique name of the invoice unit that is shown on the generated invoice.

        
      

      - **Description** *(string) --* 

        The assigned description for an invoice unit.

        
      

      - **TaxInheritanceDisabled** *(boolean) --* 

        Whether the invoice unit based tax inheritance is/ should be enabled or disabled.

        
      

      - **Rule** *(dict) --* 

        This is used to categorize the invoice unit. Values are Amazon Web Services account IDs. Currently, the only supported rule is ``LINKED_ACCOUNT``.

        
        

        - **LinkedAccounts** *(list) --* 

          The list of ``LINKED_ACCOUNT`` IDs where charges are included within the invoice unit.

          
          

          - *(string) --* 
      
        

        - **BillSourceAccounts** *(list) --* 

          A list of Amazon Web Services account account IDs that have delegated their billing responsibility to the receiver account through transfer billing. Unlike linked accounts, these bill source accounts can be payer accounts from other organizations that have authorized billing transfer to this account.

          
          

          - *(string) --* 
      
    
      

      - **LastModified** *(datetime) --* 

        The most recent date the invoice unit response was updated.

        
  
  **Exceptions**
  
  *   :py:class:`Invoicing.Client.exceptions.ResourceNotFoundException`

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

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

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

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

  