The data type of the parameter value. Parameter Store validates the value against the data type when you create or update the parameter. The default is
text, which performs no validation.
The following data type values are supported.- text
- aws:ec2:image
- aws:ssm:integration
- aws:region
- aws:account:id
- boolean
- integer
- float
- binary
- hostname
- email
- ipv4-address
- ipv6-address
- url
- json
- jsonc
For more information about the supported data types, see
Working with parameter data types in Parameter Store.Regardless of a parameter's data type, the Parameter Store API operations that retrieve parameters, such as
GetParameter,
GetParameters, and
GetParametersByPath, return the parameter value as a string. For example, if a parameter has the data type
integer and the value
443,
GetParameter returns the value as the string
"443". Convert the value to the type your application needs after you retrieve it.When you create a
String parameter and specify
aws:ec2:image, Amazon Web Services Systems Manager validates the parameter value is in the required format, such as
ami-12345abcdeEXAMPLE, and that the specified AMI is available in your Amazon Web Services account.If the action is successful, the service sends back an HTTP 200 response which indicates a successful
PutParameter call for all cases except for data type
aws:ec2:image. If you call
PutParameter with
aws:ec2:image data type, a successful HTTP 200 response does not guarantee that your parameter was successfully created or updated. The
aws:ec2:image value is validated asynchronously, and the
PutParameter call returns before the validation is complete. If you submit an invalid AMI value, the PutParameter operation will return success, but the asynchronous validation will fail and the parameter will not be created or updated. To monitor whether your
aws:ec2:image parameters are created successfully, see
Setting up notifications or trigger actions based on Parameter Store events. For more information about AMI format validation , see
Native parameter support for Amazon Machine Image IDs.