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
<a name="aws-resource-ssmguiconnect-preferences"></a>

Specify new or changed connection recording preferences for your Amazon Systems Manager GUI Connect connections. 

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

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

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

```
{
  "Type" : "AWS::SSMGuiConnect::Preferences",
  "Properties" : {
      "[ConnectionRecordingPreferences](#cfn-ssmguiconnect-preferences-connectionrecordingpreferences)" : {{ConnectionRecordingPreferences}}
    }
}
```

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

```
Type: AWS::SSMGuiConnect::Preferences
Properties:
  [ConnectionRecordingPreferences](#cfn-ssmguiconnect-preferences-connectionrecordingpreferences): {{
    ConnectionRecordingPreferences}}
```

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

`ConnectionRecordingPreferences`  <a name="cfn-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.  
*Required*: No  
*Type*: [ConnectionRecordingPreferences](aws-properties-ssmguiconnect-preferences-connectionrecordingpreferences.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-ssmguiconnect-preferences-return-values"></a>

### Ref
<a name="aws-resource-ssmguiconnect-preferences-return-values-ref"></a>

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

The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-ssmguiconnect-preferences-return-values-fn--getatt-fn--getatt"></a>

`AccountId`  <a name="AccountId-fn::getatt"></a>
The primary identifier for the Amazon CloudFormation resource.