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::DataSync::LocationSMB
<a name="aws-resource-datasync-locationsmb"></a>

The `AWS::DataSync::LocationSMB` resource specifies a Server Message Block (SMB) location that AWS DataSync can use as a transfer source or destination.

## Syntax
<a name="aws-resource-datasync-locationsmb-syntax"></a>

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

### JSON
<a name="aws-resource-datasync-locationsmb-syntax.json"></a>

```
{
  "Type" : "AWS::DataSync::LocationSMB",
  "Properties" : {
      "[AgentArns](#cfn-datasync-locationsmb-agentarns)" : [ String, ... ],
      "[AuthenticationType](#cfn-datasync-locationsmb-authenticationtype)" : String,
      "[CmkSecretConfig](#cfn-datasync-locationsmb-cmksecretconfig)" : CmkSecretConfig,
      "[CustomSecretConfig](#cfn-datasync-locationsmb-customsecretconfig)" : CustomSecretConfig,
      "[DnsIpAddresses](#cfn-datasync-locationsmb-dnsipaddresses)" : [ String, ... ],
      "[Domain](#cfn-datasync-locationsmb-domain)" : String,
      "[KerberosKeytab](#cfn-datasync-locationsmb-kerberoskeytab)" : String,
      "[KerberosKrb5Conf](#cfn-datasync-locationsmb-kerberoskrb5conf)" : String,
      "[KerberosPrincipal](#cfn-datasync-locationsmb-kerberosprincipal)" : String,
      "[MountOptions](#cfn-datasync-locationsmb-mountoptions)" : MountOptions,
      "[Password](#cfn-datasync-locationsmb-password)" : String,
      "[ServerHostname](#cfn-datasync-locationsmb-serverhostname)" : String,
      "[Subdirectory](#cfn-datasync-locationsmb-subdirectory)" : String,
      "[Tags](#cfn-datasync-locationsmb-tags)" : [ Tag, ... ],
      "[User](#cfn-datasync-locationsmb-user)" : String
    }
}
```

### YAML
<a name="aws-resource-datasync-locationsmb-syntax.yaml"></a>

```
Type: AWS::DataSync::LocationSMB
Properties:
  [AgentArns](#cfn-datasync-locationsmb-agentarns): 
    - String
  [AuthenticationType](#cfn-datasync-locationsmb-authenticationtype): String
  [CmkSecretConfig](#cfn-datasync-locationsmb-cmksecretconfig): 
    CmkSecretConfig
  [CustomSecretConfig](#cfn-datasync-locationsmb-customsecretconfig): 
    CustomSecretConfig
  [DnsIpAddresses](#cfn-datasync-locationsmb-dnsipaddresses): 
    - String
  [Domain](#cfn-datasync-locationsmb-domain): String
  [KerberosKeytab](#cfn-datasync-locationsmb-kerberoskeytab): String
  [KerberosKrb5Conf](#cfn-datasync-locationsmb-kerberoskrb5conf): String
  [KerberosPrincipal](#cfn-datasync-locationsmb-kerberosprincipal): String
  [MountOptions](#cfn-datasync-locationsmb-mountoptions): 
    MountOptions
  [Password](#cfn-datasync-locationsmb-password): String
  [ServerHostname](#cfn-datasync-locationsmb-serverhostname): String
  [Subdirectory](#cfn-datasync-locationsmb-subdirectory): String
  [Tags](#cfn-datasync-locationsmb-tags): 
    - Tag
  [User](#cfn-datasync-locationsmb-user): String
```

## Properties
<a name="aws-resource-datasync-locationsmb-properties"></a>

`AgentArns`  <a name="cfn-datasync-locationsmb-agentarns"></a>
Specifies the DataSync agent (or agents) that can connect to your SMB file server. You specify an agent by using its Amazon Resource Name (ARN).  
*Required*: Yes  
*Type*: Array of String  
*Minimum*: `1`  
*Maximum*: `128 | 8`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AuthenticationType`  <a name="cfn-datasync-locationsmb-authenticationtype"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Allowed values*: `NTLM | KERBEROS`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`CmkSecretConfig`  <a name="cfn-datasync-locationsmb-cmksecretconfig"></a>
Specifies configuration information for a DataSync-managed secret, such as an authentication token, secret key, password, or Kerberos keytab that DataSync uses to access a specific storage location, with a customer-managed AWS KMS key.  
You can use either `CmkSecretConfig` or `CustomSecretConfig` to provide credentials for a `CreateLocation` request. Do not provide both parameters for the same request.
*Required*: No  
*Type*: [CmkSecretConfig](aws-properties-datasync-locationsmb-cmksecretconfig.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`CustomSecretConfig`  <a name="cfn-datasync-locationsmb-customsecretconfig"></a>
Specifies configuration information for a customer-managed Secrets Manager secret where a storage location credentials is stored in Secrets Manager as plain text (for authentication token, secret key, or password) or as binary (for Kerberos keytab). This configuration includes the secret ARN, and the ARN for an IAM role that provides access to the secret.  
You can use either `CmkSecretConfig` or `CustomSecretConfig` to provide credentials for a `CreateLocation` request. Do not provide both parameters for the same request.
*Required*: No  
*Type*: [CustomSecretConfig](aws-properties-datasync-locationsmb-customsecretconfig.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`DnsIpAddresses`  <a name="cfn-datasync-locationsmb-dnsipaddresses"></a>
Property description not available.  
*Required*: No  
*Type*: Array of String  
*Minimum*: `7`  
*Maximum*: `15 | 2`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Domain`  <a name="cfn-datasync-locationsmb-domain"></a>
Specifies the Windows domain name that your SMB file server belongs to. This parameter applies only if `AuthenticationType` is set to `NTLM`.  
If you have multiple domains in your environment, configuring this parameter makes sure that DataSync connects to the right file server.  
*Required*: No  
*Type*: String  
*Pattern*: `^([A-Za-z0-9]+[A-Za-z0-9-.]*)*[A-Za-z0-9-]*[A-Za-z0-9]$`  
*Maximum*: `253`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`KerberosKeytab`  <a name="cfn-datasync-locationsmb-kerberoskeytab"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Maximum*: `87384`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`KerberosKrb5Conf`  <a name="cfn-datasync-locationsmb-kerberoskrb5conf"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Maximum*: `174764`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`KerberosPrincipal`  <a name="cfn-datasync-locationsmb-kerberosprincipal"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Pattern*: `^.+$`  
*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)

`MountOptions`  <a name="cfn-datasync-locationsmb-mountoptions"></a>
Specifies the version of the SMB protocol that DataSync uses to access your SMB file server.  
*Required*: No  
*Type*: [MountOptions](aws-properties-datasync-locationsmb-mountoptions.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Password`  <a name="cfn-datasync-locationsmb-password"></a>
Specifies the password of the user who can mount your SMB file server and has permission to access the files and folders involved in your transfer. This parameter applies only if `AuthenticationType` is set to `NTLM`.  
*Required*: No  
*Type*: String  
*Pattern*: `^.{0,104}$`  
*Maximum*: `104`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ServerHostname`  <a name="cfn-datasync-locationsmb-serverhostname"></a>
Specifies the domain name or IP address (IPv4 or IPv6) of the SMB file server that your DataSync agent connects to.  
If you're using Kerberos authentication, you must specify a domain name.
*Required*: No  
*Type*: String  
*Pattern*: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$`  
*Maximum*: `255`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Subdirectory`  <a name="cfn-datasync-locationsmb-subdirectory"></a>
Specifies the name of the share exported by your SMB file server where DataSync will read or write data. You can include a subdirectory in the share path (for example, `/path/to/subdirectory`). Make sure that other SMB clients in your network can also mount this path.  
To copy all data in the subdirectory, DataSync must be able to mount the SMB share and access all of its data. For more information, see [Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
*Required*: No  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`  
*Maximum*: `4096`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Tags`  <a name="cfn-datasync-locationsmb-tags"></a>
Specifies labels that help you categorize, filter, and search for your AWS resources. We recommend creating at least a name tag for your location.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-datasync-locationsmb-tag.md)  
*Maximum*: `50`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`User`  <a name="cfn-datasync-locationsmb-user"></a>
Specifies the user that can mount and access the files, folders, and file metadata in your SMB file server. This parameter applies only if `AuthenticationType` is set to `NTLM`.  
For information about choosing a user with the right level of access for your transfer, see [Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
*Required*: No  
*Type*: String  
*Pattern*: `^[^\x5B\x5D\\/:;|=,+*?]{1,104}$`  
*Maximum*: `104`  
*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-datasync-locationsmb-return-values"></a>

### Ref
<a name="aws-resource-datasync-locationsmb-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the location resource Amazon Resource Name (ARN). For example:

 `arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3` 

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

### Fn::GetAtt
<a name="aws-resource-datasync-locationsmb-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 [Fn::GetAtt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-datasync-locationsmb-return-values-fn--getatt-fn--getatt"></a>

`CmkSecretConfig.SecretArn`  <a name="CmkSecretConfig.SecretArn-fn::getatt"></a>
Property description not available.

`LocationArn`  <a name="LocationArn-fn::getatt"></a>
The Amazon Resource Name (ARN) of the specified SMB location.

`LocationUri`  <a name="LocationUri-fn::getatt"></a>
The URI of the specified SMB location.

## Examples
<a name="aws-resource-datasync-locationsmb--examples"></a>



### Creating an SMB location
<a name="aws-resource-datasync-locationsmb--examples--Creating_an_SMB_location"></a>

The following example specifies an SMB location for DataSync. In this example, the SMB location uses the domain `EXAMPLE` with SMB version 3. The server hostname is `MyServer@example.com`, and the SMB location is in the `/share` subdirectory. This example also specifies the user ID `user-1` for NTLM authentication.

#### JSON
<a name="aws-resource-datasync-locationsmb--examples--Creating_an_SMB_location--json"></a>

```
{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "Creates an SMB location for DataSync",
    "Resources": {
        "LocationSMB": {
            "Type": "AWS::DataSync::LocationSMB",
            "Properties": {
                "AgentArns": [
                    "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs,",
                    "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3"
                ],
                "Domain": "EXAMPLE",
                "AuthenticationType": "NTLM",
                "MountOptions": {
                    "Version": "SMB3"
                },
                "Password": "Password",
                "ServerHostname": "MyServer.example.com",
                "Subdirectory": "/share",
                "User": "user-1"
            }
        }
    }
}
```

#### YAML
<a name="aws-resource-datasync-locationsmb--examples--Creating_an_SMB_location--yaml"></a>

```
AWSTemplateFormatVersion: 2010-09-09
Description: Creates an SMB location for DataSync
Resources:
  LocationSMB:
    Type: AWS::DataSync::LocationSMB
    Properties: 
      AgentArns: 
        - arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs,
        - arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3
      Domain: EXAMPLE
      AuthenticationType: NTLM
      MountOptions: 
        Version: SMB3
      Password: Password
      ServerHostname: MyServer.example.com
      Subdirectory: /share
      User: user-1
```

# AWS::DataSync::LocationSMB CmkSecretConfig
<a name="aws-properties-datasync-locationsmb-cmksecretconfig"></a>

Specifies configuration information for a DataSync-managed secret, such as an authentication token, secret key, password, or Kerberos keytab that DataSync uses to access a specific storage location, with a customer-managed AWS KMS key.

**Note**  
You can use either `CmkSecretConfig` or `CustomSecretConfig` to provide credentials for a `CreateLocation` request. Do not provide both parameters for the same request.

## Syntax
<a name="aws-properties-datasync-locationsmb-cmksecretconfig-syntax"></a>

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

### JSON
<a name="aws-properties-datasync-locationsmb-cmksecretconfig-syntax.json"></a>

```
{
  "[KmsKeyArn](#cfn-datasync-locationsmb-cmksecretconfig-kmskeyarn)" : String,
  "[SecretArn](#cfn-datasync-locationsmb-cmksecretconfig-secretarn)" : String
}
```

### YAML
<a name="aws-properties-datasync-locationsmb-cmksecretconfig-syntax.yaml"></a>

```
  [KmsKeyArn](#cfn-datasync-locationsmb-cmksecretconfig-kmskeyarn): String
  [SecretArn](#cfn-datasync-locationsmb-cmksecretconfig-secretarn): String
```

## Properties
<a name="aws-properties-datasync-locationsmb-cmksecretconfig-properties"></a>

`KmsKeyArn`  <a name="cfn-datasync-locationsmb-cmksecretconfig-kmskeyarn"></a>
Specifies the ARN for the customer-managed AWS KMS key that DataSync uses to encrypt the DataSync-managed secret stored for `SecretArn`. DataSync provides this key to AWS Secrets Manager.  
*Required*: No  
*Type*: String  
*Pattern*: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z-0-9]+:[0-9]{12}:key/.*|)$`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SecretArn`  <a name="cfn-datasync-locationsmb-cmksecretconfig-secretarn"></a>
Specifies the ARN for the DataSync-managed AWS Secrets Manager secret that that is used to access a specific storage location. This property is generated by DataSync and is read-only. DataSync encrypts this secret with the KMS key that you specify for `KmsKeyArn`.  
*Required*: No  
*Type*: String  
*Pattern*: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z-0-9]+:[0-9]{12}:secret:.*|)$`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::DataSync::LocationSMB CustomSecretConfig
<a name="aws-properties-datasync-locationsmb-customsecretconfig"></a>

Specifies configuration information for a customer-managed Secrets Manager secret where a storage location credentials is stored in Secrets Manager as plain text (for authentication token, secret key, or password) or as binary (for Kerberos keytab). This configuration includes the secret ARN, and the ARN for an IAM role that provides access to the secret.

**Note**  
You can use either `CmkSecretConfig` or `CustomSecretConfig` to provide credentials for a `CreateLocation` request. Do not provide both parameters for the same request.

## Syntax
<a name="aws-properties-datasync-locationsmb-customsecretconfig-syntax"></a>

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

### JSON
<a name="aws-properties-datasync-locationsmb-customsecretconfig-syntax.json"></a>

```
{
  "[SecretAccessRoleArn](#cfn-datasync-locationsmb-customsecretconfig-secretaccessrolearn)" : String,
  "[SecretArn](#cfn-datasync-locationsmb-customsecretconfig-secretarn)" : String
}
```

### YAML
<a name="aws-properties-datasync-locationsmb-customsecretconfig-syntax.yaml"></a>

```
  [SecretAccessRoleArn](#cfn-datasync-locationsmb-customsecretconfig-secretaccessrolearn): String
  [SecretArn](#cfn-datasync-locationsmb-customsecretconfig-secretarn): String
```

## Properties
<a name="aws-properties-datasync-locationsmb-customsecretconfig-properties"></a>

`SecretAccessRoleArn`  <a name="cfn-datasync-locationsmb-customsecretconfig-secretaccessrolearn"></a>
Specifies the ARN for the AWS Identity and Access Management role that DataSync uses to access the secret specified for `SecretArn`.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*|)$`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SecretArn`  <a name="cfn-datasync-locationsmb-customsecretconfig-secretarn"></a>
Specifies the ARN for an AWS Secrets Manager secret.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z-0-9]+:[0-9]{12}:secret:.*|)$`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::DataSync::LocationSMB ManagedSecretConfig
<a name="aws-properties-datasync-locationsmb-managedsecretconfig"></a>

Specifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location. DataSync uses the default AWS-managed KMS key to encrypt this secret in AWS Secrets Manager.

## Syntax
<a name="aws-properties-datasync-locationsmb-managedsecretconfig-syntax"></a>

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

### JSON
<a name="aws-properties-datasync-locationsmb-managedsecretconfig-syntax.json"></a>

```
{
  "[SecretArn](#cfn-datasync-locationsmb-managedsecretconfig-secretarn)" : String
}
```

### YAML
<a name="aws-properties-datasync-locationsmb-managedsecretconfig-syntax.yaml"></a>

```
  [SecretArn](#cfn-datasync-locationsmb-managedsecretconfig-secretarn): String
```

## Properties
<a name="aws-properties-datasync-locationsmb-managedsecretconfig-properties"></a>

`SecretArn`  <a name="cfn-datasync-locationsmb-managedsecretconfig-secretarn"></a>
Specifies the ARN for an AWS Secrets Manager secret.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z-0-9]+:[0-9]{12}:secret:.*|)$`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::DataSync::LocationSMB MountOptions
<a name="aws-properties-datasync-locationsmb-mountoptions"></a>

Specifies the version of the SMB protocol that DataSync uses to access your SMB file server.

## Syntax
<a name="aws-properties-datasync-locationsmb-mountoptions-syntax"></a>

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

### JSON
<a name="aws-properties-datasync-locationsmb-mountoptions-syntax.json"></a>

```
{
  "[Version](#cfn-datasync-locationsmb-mountoptions-version)" : String
}
```

### YAML
<a name="aws-properties-datasync-locationsmb-mountoptions-syntax.yaml"></a>

```
  [Version](#cfn-datasync-locationsmb-mountoptions-version): String
```

## Properties
<a name="aws-properties-datasync-locationsmb-mountoptions-properties"></a>

`Version`  <a name="cfn-datasync-locationsmb-mountoptions-version"></a>
By default, DataSync automatically chooses an SMB protocol version based on negotiation with your SMB file server. You also can configure DataSync to use a specific SMB version, but we recommend doing this only if DataSync has trouble negotiating with the SMB file server automatically.  
These are the following options for configuring the SMB version:  
+ `AUTOMATIC` (default): DataSync and the SMB file server negotiate the highest version of SMB that they mutually support between 2.1 and 3.1.1.

  This is the recommended option. If you instead choose a specific version that your file server doesn't support, you may get an `Operation Not Supported` error.
+ `SMB3`: Restricts the protocol negotiation to only SMB version 3.0.2.
+ `SMB2`: Restricts the protocol negotiation to only SMB version 2.1.
+ `SMB2_0`: Restricts the protocol negotiation to only SMB version 2.0.
+ `SMB1`: Restricts the protocol negotiation to only SMB version 1.0.
**Note**  
The `SMB1` option isn't available when [creating an Amazon FSx for NetApp ONTAP location](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html).
*Required*: No  
*Type*: String  
*Allowed values*: `AUTOMATIC | SMB1 | SMB2_0 | SMB2 | SMB3`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::DataSync::LocationSMB Tag
<a name="aws-properties-datasync-locationsmb-tag"></a>

<a name="aws-properties-datasync-locationsmb-tag-description"></a>The `Tag` property type specifies Property description not available. for an [AWS::DataSync::LocationSMB](aws-resource-datasync-locationsmb.md).

## Syntax
<a name="aws-properties-datasync-locationsmb-tag-syntax"></a>

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

### JSON
<a name="aws-properties-datasync-locationsmb-tag-syntax.json"></a>

```
{
  "[Key](#cfn-datasync-locationsmb-tag-key)" : String,
  "[Value](#cfn-datasync-locationsmb-tag-value)" : String
}
```

### YAML
<a name="aws-properties-datasync-locationsmb-tag-syntax.yaml"></a>

```
  [Key](#cfn-datasync-locationsmb-tag-key): String
  [Value](#cfn-datasync-locationsmb-tag-value): String
```

## Properties
<a name="aws-properties-datasync-locationsmb-tag-properties"></a>

`Key`  <a name="cfn-datasync-locationsmb-tag-key"></a>
Property description not available.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9\s+=._:/-]+$`  
*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-datasync-locationsmb-tag-value"></a>
Property description not available.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9\s+=._:@/-]+$`  
*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)