dataType
The data type for a String
parameter. Supported data types include plain text and Amazon Machine Image (AMI) IDs.
The following data type values are supported.
text
aws:ec2:image
aws:ssm:integration
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.