# StringParameterDeclaration
<a name="API_StringParameterDeclaration"></a>

A parameter declaration for the `String` data type.

## Contents
<a name="API_StringParameterDeclaration_Contents"></a>

**Note**  
In the following list, the required parameters are described first.

 ** Name **   <a name="QS-Type-StringParameterDeclaration-Name"></a>
The name of the parameter that is being declared.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Pattern: `^[a-zA-Z0-9]+$`   
Required: Yes

 ** ParameterValueType **   <a name="QS-Type-StringParameterDeclaration-ParameterValueType"></a>
The value type determines whether the parameter is a single-value or multi-value parameter.  
Type: String  
Valid Values: `MULTI_VALUED | SINGLE_VALUED`   
Required: Yes

 ** DefaultValues **   <a name="QS-Type-StringParameterDeclaration-DefaultValues"></a>
The default values of a parameter. If the parameter is a single-value parameter, a maximum of one default value can be provided.  
Type: [StringDefaultValues](API_StringDefaultValues.md) object  
Required: No

 ** MappedDataSetParameters **   <a name="QS-Type-StringParameterDeclaration-MappedDataSetParameters"></a>
A list of dataset parameters that are mapped to an analysis parameter.  
Type: Array of [MappedDataSetParameter](API_MappedDataSetParameter.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 150 items.  
Required: No

 ** ValueWhenUnset **   <a name="QS-Type-StringParameterDeclaration-ValueWhenUnset"></a>
The configuration that defines the default value of a `String` parameter when a value has not been set.  
Type: [StringValueWhenUnsetConfiguration](API_StringValueWhenUnsetConfiguration.md) object  
Required: No

## See Also
<a name="API_StringParameterDeclaration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/StringParameterDeclaration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/StringParameterDeclaration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/StringParameterDeclaration)