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::FSx::FileSystem DataReadCacheConfiguration
<a name="aws-properties-fsx-filesystem-datareadcacheconfiguration"></a>

The configuration for the optional provisioned SSD read cache on Amazon FSx for Lustre file systems that use the Intelligent-Tiering storage class.

## Syntax
<a name="aws-properties-fsx-filesystem-datareadcacheconfiguration-syntax"></a>

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

### JSON
<a name="aws-properties-fsx-filesystem-datareadcacheconfiguration-syntax.json"></a>

```
{
  "[SizeGiB](#cfn-fsx-filesystem-datareadcacheconfiguration-sizegib)" : Integer,
  "[SizingMode](#cfn-fsx-filesystem-datareadcacheconfiguration-sizingmode)" : String
}
```

### YAML
<a name="aws-properties-fsx-filesystem-datareadcacheconfiguration-syntax.yaml"></a>

```
  [SizeGiB](#cfn-fsx-filesystem-datareadcacheconfiguration-sizegib): Integer
  [SizingMode](#cfn-fsx-filesystem-datareadcacheconfiguration-sizingmode): String
```

## Properties
<a name="aws-properties-fsx-filesystem-datareadcacheconfiguration-properties"></a>

`SizeGiB`  <a name="cfn-fsx-filesystem-datareadcacheconfiguration-sizegib"></a>
Required if `SizingMode` is set to `USER_PROVISIONED`. Specifies the size of the file system's SSD read cache, in gibibytes (GiB).  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SizingMode`  <a name="cfn-fsx-filesystem-datareadcacheconfiguration-sizingmode"></a>
Specifies how the provisioned SSD read cache is sized, as follows:   
+ Set to `NO_CACHE` if you do not want to use an SSD read cache with your Intelligent-Tiering file system.
+ Set to `USER_PROVISIONED` to specify the exact size of your SSD read cache.
+ Set to `PROPORTIONAL_TO_THROUGHPUT_CAPACITY` to have your SSD read cache automatically sized based on your throughput capacity.
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)