[アップデート] AWS Systems Manager Parameter Storeにintegerやjsonなど13種類のデータ型が追加されました

こんにちは。サービス開発部の武田です。

2026年11月5日に、AWS Systems Manager Parameter Storeのパラメーターに付けられるデータ型が13種類増えました。型を付けておくと、PutParameterの時点で型に合わない値が弾かれます。

https://aws.amazon.com/about-aws/whats-new/2026/11/aws-ssm-parameter-store-allows-organization-validation-with-new-data-types/

これまでのDataTypeは、検証しないデフォルトのtextと、AMI ID用のaws:ec2:image、AutomationのWebhook用のaws:ssm:integrationだけでした。ポート番号やIPアドレスの形式チェックは、アプリケーション側で書くか、正規表現のAllowedPatternで済ませるしかありませんでした。今回はAWS CLIから13種類すべてを試してみました。

追加されたデータ型

ユーザーガイドに載っている13種類は次のとおりです。

追加された13種類は、すべてSecureStringにも対応しています。

https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-data-types.html

検証環境

• AWS CLI 2.36.30
• 東京リージョン（ap-northeast-1）
• 検証日は2026年11月9日

型に合わない値はPutParameterで弾かれる

--data-typeを付けてput-parameterを呼ぶだけです。

aws ssm put-parameter --name /myapp/port --type String --data-type integer --value 443

型に合わない値を渡すとValidationExceptionになります。

An error occurred (ValidationException) when calling the PutParameter operation: The parameter value is not a valid integer. A value must be an optional minus sign followed by digits, with no leading zeros, no plus sign, no decimal point and no whitespace.

標準階層で使える10種類について、通る値と弾かれる値を試しました。結果は次のとおりです。

結果はすべてドキュメントの記載どおりでした。エラーメッセージは理由まで書いてくれます。integerの範囲外は「outside the supported integer range」と返ってきました。hostnameのアンダースコアは「It contains an underscore」です。日本語ドメインには「Give an internationalized name in punycode (xn--).」と、punycodeで書くよう案内が出ます。

emailのMary <mary@example.com>のような表示名付きの形式は、空白を含むという理由で弾かれました。

The parameter value is not a valid email address. It contains whitespace or a control character.

型名を間違えたときは、型名がすべて小文字であることを教えてくれます。

The following data type is not supported: int. (Data type names are all lowercase.)

url、json、jsoncはアドバンスド階層が必要

アドバンスド階層で試した結果は次のとおりです。

パスワード入りのURLには、Secrets Managerを使うよう促すメッセージが返ってきます。

標準階層でjsonを指定すると、次のようなエラーになります。--tierを省略した場合も同じでした。

The json data type is only supported for advanced parameters.

--tier Intelligent-Tieringを付けると、アドバンスド階層で作られました。アドバンスド階層のパラメーターは保管料金がかかるので、json型を使いたいだけの場合も料金を確認しておきましょう。

StringListとSecureString

StringListでは要素ごとに検証され、何番目の要素が不正かがメッセージに出ます。

aws ssm put-parameter --name /myapp/notify-to --type StringList --data-type email \
  --value 'a@example.com,bad'

Element 2 of the StringList: The parameter value is not a valid email address. It has no @.

StringListに対応していない型を指定すると、作成自体が失敗します。

The integer data type is not supported for the following input type: StringList

SecureStringでも検証は同じように動きます。S3cretValueをinteger型で入れたときのメッセージは、Stringのときと同じでした。メッセージに値は含まれていません。

上書きで型を省略すると、既存の型が引き継がれる

既存のパラメーターの型は後から変えられます。1つのパラメーターに対して、上から順に操作した結果は次のとおりです。

注意したいのは手順4です。--data-typeを省略して上書きすると、型はデフォルトのtextに戻らず、既存のintegerが引き継がれて検証が続きます。

値の変更で型が外れないのは安全側の動きです。検証を外したいときは--data-type textを明示します。

jsonなどアドバンスド専用の型に変えるときは、--tier Advancedも一緒に指定しないと失敗します。

取得すると値は文字列で返る

integer型のパラメーターを取得しても、値は文字列です。

aws ssm get-parameter --name /myapp/port \
  --query 'Parameter.{Value:Value,Type:Type,DataType:DataType}'

{
    "Value": "443",
    "Type": "String",
    "DataType": "integer"
}

アプリケーション側で数値に変換する処理は、これまでどおり必要です。型が保証するのは、数値に変換できる値が入っていることだけです。

describe-parametersでは型で絞り込めます。

aws ssm describe-parameters --parameter-filters Key=DataType,Values=json,jsonc

存在しない型名を渡すとInvalidFilterValueになりました。

まとめ

13種類とも、ドキュメントに書かれた境界値のとおりに検証されました。既存のput-parameterに--data-typeを足すだけで使え、上書きで型を省略しても検証は外れません。

これまでAllowedPatternの正規表現で書いていたポート番号やIPアドレスのチェックは、標準階層のまま型に置き換えられそうです。

どなたかの参考になりましたら幸いです。

参考リンク

• Parameter data types in Parameter Store
• AWS Systems Manager Parameter Store now allows organization and validation with built-in data types