Parameter Store スループットの引き上げまたはリセット
Parameter Store のスループットを増やすと、AWS Systems Manager の一機能である Parameter Store が処理できる 1 秒あたりのトランザクション (TPS) の最大数が増加します。スループットが引き上げられると、複数のパラメータに同時アクセスが必要なアプリケーションとワークロードをサポートするため、高いボリュームで Parameter Store を運用できます。[Settings] (設定) タブでは、最大スループットまでクォータを引き上げることができます。
最大スループットのデフォルトと上限の詳細については、「AWS Systems Manager エンドポイントとクォータ」を参照してください。
スループットのクォータを引き上げると、AWS アカウント に追加料金が発生します。詳細については、AWS Systems Manager 料金
注記
Parameter Store のスループット設定は、現在の AWS アカウント と AWS リージョン におけるすべての (IAM) ユーザーによって作成されたすべてのトランザクションに適用されます。スループット設定は、スタンダードおよびアドバンストのパラメータに適用されます。
トピック
Parameter Store のスループットを変更するアクセス許可を設定する
次のいずれかを実行して、Parameter Store のスループットを変更する IAM のアクセス許可があることを確認します。
-
AdministratorAccess
ポリシーが、IAM エンティティ (ユーザー、グループ、またはロール) にアタッチされていることを確認します。 -
次の API オペレーションを使用して、スループットサービス設定を変更する権限があることを確認します。
IAM エンティティに次のアクセス許可を付与して、ユーザーが AWS アカウント の特定の AWS リージョン でパラメータのスループット設定を表示および変更できるようにします。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ssm:GetServiceSetting" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ssm:UpdateServiceSetting" ], "Resource": "arn:aws:ssm:
region
:account-id
:servicesetting/ssm/parameter-store/high-throughput-enabled" } ] }
管理者は、次のアクセス許可を割り当てることで、読み取り専用のアクセス許可を指定することができます。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ssm:GetServiceSetting" ], "Resource": "*" }, { "Effect": "Deny", "Action": [ "ssm:ResetServiceSetting", "ssm:UpdateServiceSetting" ], "Resource": "*" } ] }
アクセス権限を付与するには、ユーザー、グループ、またはロールにアクセス許可を追加します。
-
AWS IAM Identity Center のユーザーとグループ:
アクセス許可セットを作成します。「AWS IAM Identity Center ユーザーガイド」の「権限設定を作成する」の手順に従ってください。
-
IAM 内で、ID プロバイダーによって管理されているユーザー:
ID フェデレーションのロールを作成します。詳細については、「IAM ユーザーガイド」の「サードパーティー ID プロバイダー (フェデレーション) 用のロールの作成」を参照してください。
-
IAM ユーザー:
-
ユーザーが担当できるロールを作成します。手順については、「IAM ユーザーガイド」の「IAM ユーザー用ロールの作成」を参照してください。
-
(お奨めできない方法) ポリシーをユーザーに直接アタッチするか、ユーザーをユーザーグループに追加する。詳細については、「IAM ユーザーガイド」の「ユーザー (コンソール) へのアクセス権限の追加」を参照してください。
-
コンソールを使用したスループットの引き上げまたはリセット
次の手順では、Systems Manager コンソールを使用して Parameter Store が現在の AWS アカウント と AWS リージョン に対して処理できる 1 秒あたりのトランザクション数を引き上げる方法を示します。スループットの向上が不要になった場合や追加の料金を回避したい場合に標準の設定に戻す方法も示します。
ヒント
パラメータをまだ作成していない場合は、AWS Command Line Interface (AWS CLI) または AWS Tools for Windows PowerShell を使用してスループットを増加することができます。詳細については、「AWS CLI を使用したスループットの引き上げまたはリセット」および「スループットの引き上げまたはリセット (PowerShell)」を参照してください。
Parameter Store のスループットの引き上げまたはリセットをするには
AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/
) を開きます。 ナビゲーションペインで、[Parameter Store] を選択します。
-
[Settings] (設定) タブを選択します。
-
スループットを上げるには、[上限をセットする] を選択します。
-または-
デフォルトの上限に戻すには、[上限をリセットする] を選択します。
-
上限を上げる場合は、次の手順を実行します。
-
[この設定を変更すると AWS アカウント に料金が発生することを承諾します] のチェックボックスを選択します。
-
[Set limit (制限の設定)] を選択します。
-または-
上限をデフォルトにリセットする場合は、次の手順を実行します。
-
[デフォルトのスループット上限にリセットすると、Parameter Store で 1 秒あたりに処理されるトランザクションが少なくなることを承諾します] のチェックボックスを選択します。
-
[上限をリセットする] を選択します。
-
AWS CLI を使用したスループットの引き上げまたはリセット
次の手順では、AWS CLI を使用して、Parameter Store が現在の AWS アカウント と AWS リージョン に対して処理できる 1 秒あたりのトランザクションの数を増やす方法を示します。デフォルトの上限に戻すこともできます。
AWS CLI を使用して Parameter Store のスループットを向上させるには
-
AWS CLI を開き、次のコマンドを実行して、現在の AWS アカウント と AWS リージョン で Parameter Store が処理できる 1 秒あたりのトランザクション数を増やします。
aws ssm update-service-setting --setting-id arn:aws:ssm:
region
:account-id
:servicesetting/ssm/parameter-store/high-throughput-enabled --setting-value trueコマンドが成功した場合、出力はありません。
-
次のコマンドを実行して、現在の AWS アカウント と AWS リージョン の Parameter Store で現在のスループットサービス設定を表示します。
aws ssm get-service-setting --setting-id arn:aws:ssm:
region
:account-id
:servicesetting/ssm/parameter-store/high-throughput-enabledシステムは以下のような情報を返します。
{ "ServiceSetting": { "SettingId": "/ssm/parameter-store/high-throughput-enabled", "SettingValue": "true", "LastModifiedDate": 1556551683.923, "LastModifiedUser": "arn:aws:sts::123456789012:assumed-role/Administrator/Jasper", "ARN": "arn:aws:ssm:us-east-2:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled", "Status": "Customized" } }
スループットの向上が不要になった場合や追加の料金を節約したい場合は、標準の設定に戻すことができます。設定を元に戻すには、次のコマンドを実行します。
aws ssm reset-service-setting --setting-id arn:aws:ssm:
region
:account-id
:servicesetting/ssm/parameter-store/high-throughput-enabled
{ "ServiceSetting": { "SettingId": "/ssm/parameter-store/high-throughput-enabled", "SettingValue": "false", "LastModifiedDate": 1555532818.578, "LastModifiedUser": "System", "ARN": "arn:aws:ssm:us-east-2:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled", "Status": "Default" } }
スループットの引き上げまたはリセット (PowerShell)
次の手順は、Tools for Windows PowerShell を使用して、現在の AWS アカウント と AWS リージョン に対して Parameter Store が処理できる 1 秒あたりのトランザクション数を引き上げる増やす方法を示しています。デフォルトの上限に戻すこともできます。
PowerShell を使用して Parameter Store のスループットを向上させるには
-
AWS Tools for PowerShell (Tools for PowerShell) を使用して、現在の AWS アカウント と AWS リージョン の Parameter Store のスループットを引き上げます。
Update-SSMServiceSetting -SettingId "arn:aws:ssm:
region
:account-id
:servicesetting/ssm/parameter-store/high-throughput-enabled" -SettingValue "true" -Regionregion
コマンドが成功した場合、出力はありません。
-
次のコマンドを実行して、現在の AWS アカウント と AWS リージョン の Parameter Store で現在のスループットサービス設定を表示します。
Get-SSMServiceSetting -SettingId "arn:aws:ssm:
region
:account-id
:servicesetting/ssm/parameter-store/high-throughput-enabled" -Regionregion
システムは以下のような情報を返します。
ARN : arn:aws:ssm:us-east-2:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled LastModifiedDate : 4/29/2019 3:35:44 PM LastModifiedUser : arn:aws:sts::123456789012:assumed-role/Administrator/Jasper SettingId : /ssm/parameter-store/high-throughput-enabled SettingValue : true Status : Customized
スループットの向上が不要になった場合や追加の料金を節約したい場合は、標準の設定に戻すことができます。設定を元に戻すには、次のコマンドを実行します。
Reset-SSMServiceSetting -SettingId "arn:aws:ssm:
region
:account-id
:servicesetting/ssm/parameter-store/high-throughput-enabled" -Regionregion
システムは以下のような情報を返します。
ARN : arn:aws:ssm:us-east-2:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled LastModifiedDate : 4/17/2019 8:26:58 PM LastModifiedUser : System SettingId : /ssm/parameter-store/high-throughput-enabled SettingValue : false Status : Default