Parameter Store でのパラメータ階層の選択

パラメータストレージ属性を制御するために、Parameter Store には標準パラメータとアドバンストパラメータが含まれています。アカウントとリージョンごとに各パラメータを個別に設定します。パラメータ階層によって、パラメータ値の最大サイズ、特定の階層内の作成可能なパラメータ数、パラメータポリシーの使用の有無、課金の有無が決まります。

パラメータ階層はパラメータスループットとは異なります。階層はパラメータストレージ属性を制御し、スループットはリクエストレートを制御します。

スタンダードパラメータ階層およびアドバンストパラメータ階層

以下の表では、階層の違いについて説明しています。

以下の表では、パラメータ階層の違いについて説明しています。

Parameter Store クォータと制限の完全なリストについては、「AWS 一般的なリファレンス」の「AWS Systems Manager エンドポイントとクォータ」を参照してください。

デフォルトの階層と個々のパラメータ階層の設定

Parameter Store では、以下の関連設定がサポートされています。

デフォルトのパラメータ階層は、個々のパラメータの階層とは別です。デフォルトのパラメータ階層の変更は、階層を指定せずに新たに作成したパラメータにのみ反映されます。既存のパラメータには反映されません。

パラメータ階層設定の表示

AWS アカウント とリージョンに対するデフォルトの階層設定と、パラメータごとの階層設定を表示できます。

デフォルトのパラメータ階層を表示する

AWS アカウント とリージョン別にデフォルトのパラメータ階層を表示するには、 アクションを使用します。次の例では、デフォルトのパラメータ階層を取得しています。

aws ssm get-service-setting \
    --region us-east-1 \
    --setting-id arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/default-parameter-tier

次の例はサンプル出力を示しています。

{
    "ServiceSetting": {
        "SettingId": "/ssm/parameter-store/default-parameter-tier",
        "SettingValue": "Standard",
        "Status": "Default"
    }
}

特定のパラメータの階層を表示する

特定のパラメータの階層を表示するには、 アクションを使用します。次の例では、パラメータ /myapp/dev/log-level の階層を返しています。

aws ssm describe-parameters \
    --region us-east-1 \
    --parameter-filters "Key=Name,Option=Equals,Values=/myapp/dev/log-level" \
    --query "Parameters[0].Tier" \
    --output text

このコマンドは Standard や Advanced などのパラメータ階層を返します。

個々のパラメータの階層の変更に関する制限

アドバンストパラメータを標準パラメータに変更することはできません。以下の理由により、アドバンストパラメータを標準パラメータに変更することはできません。

アドバンストパラメータが不要になった場合、またはアドバンストパラメータの料金を抑えたい場合は、アドバンストパラメータを削除して新しい標準パラメータとして再作成します。

デフォルトのパラメータ階層は別の設定です。AWS アカウント とリージョンに対するデフォルトのパラメータ階層を Standard から Advanced に変更し、それを Standard に戻すことができます。デフォルトの階層設定の変更は、階層を指定せずに新たに作成したパラメータにのみ反映されます。既存のパラメータには反映されません。

たとえば、デフォルトの階層が Standard のときにパラメータを作成し、次にデフォルトのパラメータ階層を Advanced に設定することができます。階層を指定せずに新たに作成したパラメータには Advanced 階層が使用されます。デフォルトの階層は、後で既存のパラメータの階層を変更することなく Standard に戻すことができます。

アドバンストパラメータには料金が発生します。詳細については、「Parameter Store 向けの AWS Systems Manager 料金」を参照してください。