This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::Invoicing::InvoiceUnit
<a name="aws-resource-invoicing-invoiceunit"></a>

An invoice unit is a set of mutually exclusive account that correspond to your business entity. Invoice units allow you separate AWS account costs and configures your invoice for each business entity going forward. 

## Syntax
<a name="aws-resource-invoicing-invoiceunit-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-invoicing-invoiceunit-syntax.json"></a>

```
{
  "Type" : "AWS::Invoicing::InvoiceUnit",
  "Properties" : {
      "[Description](#cfn-invoicing-invoiceunit-description)" : String,
      "[InvoiceReceiver](#cfn-invoicing-invoiceunit-invoicereceiver)" : String,
      "[Name](#cfn-invoicing-invoiceunit-name)" : String,
      "[ResourceTags](#cfn-invoicing-invoiceunit-resourcetags)" : [ ResourceTag, ... ],
      "[Rule](#cfn-invoicing-invoiceunit-rule)" : Rule,
      "[TaxInheritanceDisabled](#cfn-invoicing-invoiceunit-taxinheritancedisabled)" : Boolean
    }
}
```

### YAML
<a name="aws-resource-invoicing-invoiceunit-syntax.yaml"></a>

```
Type: AWS::Invoicing::InvoiceUnit
Properties:
  [Description](#cfn-invoicing-invoiceunit-description): String
  [InvoiceReceiver](#cfn-invoicing-invoiceunit-invoicereceiver): String
  [Name](#cfn-invoicing-invoiceunit-name): String
  [ResourceTags](#cfn-invoicing-invoiceunit-resourcetags): 
    - ResourceTag
  [Rule](#cfn-invoicing-invoiceunit-rule): 
    Rule
  [TaxInheritanceDisabled](#cfn-invoicing-invoiceunit-taxinheritancedisabled): Boolean
```

## Properties
<a name="aws-resource-invoicing-invoiceunit-properties"></a>

`Description`  <a name="cfn-invoicing-invoiceunit-description"></a>
The assigned description for an invoice unit. This information can't be modified or deleted.   
*Required*: No  
*Type*: String  
*Pattern*: `^[\S\s]*$`  
*Minimum*: `0`  
*Maximum*: `500`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`InvoiceReceiver`  <a name="cfn-invoicing-invoiceunit-invoicereceiver"></a>
The account that receives invoices related to the invoice unit.   
*Required*: Yes  
*Type*: String  
*Pattern*: `^\d{12}$`  
*Minimum*: `12`  
*Maximum*: `12`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Name`  <a name="cfn-invoicing-invoiceunit-name"></a>
 A unique name that is distinctive within your AWS.   
*Required*: Yes  
*Type*: String  
*Pattern*: `^(?! )[\p{L}\p{N}\p{Z}-_]*(?<! )$`  
*Minimum*: `1`  
*Maximum*: `50`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`ResourceTags`  <a name="cfn-invoicing-invoiceunit-resourcetags"></a>
The tag structure that contains a tag key and value.  
*Required*: No  
*Type*: Array of [ResourceTag](aws-properties-invoicing-invoiceunit-resourcetag.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Rule`  <a name="cfn-invoicing-invoiceunit-rule"></a>
An `InvoiceUnitRule` object used the categorize invoice units.  
*Required*: Yes  
*Type*: [Rule](aws-properties-invoicing-invoiceunit-rule.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TaxInheritanceDisabled`  <a name="cfn-invoicing-invoiceunit-taxinheritancedisabled"></a>
Whether the invoice unit based tax inheritance is/ should be enabled or disabled.   
*Required*: No  
*Type*: Boolean  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-invoicing-invoiceunit-return-values"></a>

### Ref
<a name="aws-resource-invoicing-invoiceunit-return-values-ref"></a>

For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-invoicing-invoiceunit-return-values-fn--getatt"></a>

#### 
<a name="aws-resource-invoicing-invoiceunit-return-values-fn--getatt-fn--getatt"></a>

`InvoiceUnitArn`  <a name="InvoiceUnitArn-fn::getatt"></a>
The ARN to identify an invoice unit. This information can't be modified or deleted.

`LastModified`  <a name="LastModified-fn::getatt"></a>
 The last time the invoice unit was updated. This is important to determine the version of invoice unit configuration used to create the invoices. Any invoice created after this modified time will use this invoice unit configuration. 

# AWS::Invoicing::InvoiceUnit ResourceTag
<a name="aws-properties-invoicing-invoiceunit-resourcetag"></a>

 The tag structure that contains a tag key and value. 

## Syntax
<a name="aws-properties-invoicing-invoiceunit-resourcetag-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-invoicing-invoiceunit-resourcetag-syntax.json"></a>

```
{
  "[Key](#cfn-invoicing-invoiceunit-resourcetag-key)" : String,
  "[Value](#cfn-invoicing-invoiceunit-resourcetag-value)" : String
}
```

### YAML
<a name="aws-properties-invoicing-invoiceunit-resourcetag-syntax.yaml"></a>

```
  [Key](#cfn-invoicing-invoiceunit-resourcetag-key): String
  [Value](#cfn-invoicing-invoiceunit-resourcetag-value): String
```

## Properties
<a name="aws-properties-invoicing-invoiceunit-resourcetag-properties"></a>

`Key`  <a name="cfn-invoicing-invoiceunit-resourcetag-key"></a>
The object key of your of your resource tag.   
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `256`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-invoicing-invoiceunit-resourcetag-value"></a>
 The specific value of the resource tag.   
*Required*: Yes  
*Type*: String  
*Minimum*: `0`  
*Maximum*: `200`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::Invoicing::InvoiceUnit Rule
<a name="aws-properties-invoicing-invoiceunit-rule"></a>

The `InvoiceUnitRule` object used to update invoice units. 

## Syntax
<a name="aws-properties-invoicing-invoiceunit-rule-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-invoicing-invoiceunit-rule-syntax.json"></a>

```
{
  "[LinkedAccounts](#cfn-invoicing-invoiceunit-rule-linkedaccounts)" : [ String, ... ]
}
```

### YAML
<a name="aws-properties-invoicing-invoiceunit-rule-syntax.yaml"></a>

```
  [LinkedAccounts](#cfn-invoicing-invoiceunit-rule-linkedaccounts): 
    - String
```

## Properties
<a name="aws-properties-invoicing-invoiceunit-rule-properties"></a>

`LinkedAccounts`  <a name="cfn-invoicing-invoiceunit-rule-linkedaccounts"></a>
The list of `LINKED_ACCOUNT` IDs where charges are included within the invoice unit.   
*Required*: Yes  
*Type*: Array of String  
*Minimum*: `12`  
*Maximum*: `12`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)