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

# AWS::SSMGuiConnect::Preferences ConnectionRecordingPreferences
<a name="aws-properties-ssmguiconnect-preferences-connectionrecordingpreferences"></a>

The set of preferences used for recording RDP connections in the requesting Amazon Web Services account and Amazon Web Services Region. This includes details such as which S3 bucket recordings are stored in.

## Syntax
<a name="aws-properties-ssmguiconnect-preferences-connectionrecordingpreferences-syntax"></a>

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

### JSON
<a name="aws-properties-ssmguiconnect-preferences-connectionrecordingpreferences-syntax.json"></a>

```
{
  "[KMSKeyArn](#cfn-ssmguiconnect-preferences-connectionrecordingpreferences-kmskeyarn)" : {{String}},
  "[RecordingDestinations](#cfn-ssmguiconnect-preferences-connectionrecordingpreferences-recordingdestinations)" : {{RecordingDestinations}}
}
```

### YAML
<a name="aws-properties-ssmguiconnect-preferences-connectionrecordingpreferences-syntax.yaml"></a>

```
  [KMSKeyArn](#cfn-ssmguiconnect-preferences-connectionrecordingpreferences-kmskeyarn): {{String}}
  [RecordingDestinations](#cfn-ssmguiconnect-preferences-connectionrecordingpreferences-recordingdestinations): {{
    RecordingDestinations}}
```

## Properties
<a name="aws-properties-ssmguiconnect-preferences-connectionrecordingpreferences-properties"></a>

`KMSKeyArn`  <a name="cfn-ssmguiconnect-preferences-connectionrecordingpreferences-kmskeyarn"></a>
The ARN of a Amazon KMS key that is used to encrypt data while it is being processed by the service. This key must exist in the same Amazon Web Services Region as the node you start an RDP connection to.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RecordingDestinations`  <a name="cfn-ssmguiconnect-preferences-connectionrecordingpreferences-recordingdestinations"></a>
Determines where recordings of RDP connections are stored.  
*Required*: Yes  
*Type*: [RecordingDestinations](aws-properties-ssmguiconnect-preferences-recordingdestinations.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)