Parameter Store のスループットを変更するアクセス許可を設定するスループットの引き上げまたはリセット (コンソール)スループットの引き上げまたはリセット (AWS CLI)スループットの引き上げまたはリセット (PowerShell)

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" -Region region
```
コマンドが成功した場合、出力はありません。

次のコマンドを実行して、現在の AWS アカウントと AWS リージョンの Parameter Store で現在のスループットサービス設定を表示します。


Get-SSMServiceSetting -SettingId "arn:aws:ssm:region:account-id:servicesetting/ssm/parameter-store/high-throughput-enabled" -Region region

システムは以下のような情報を返します。

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" -Region region

システムは以下のような情報を返します。

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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

パラメータ層の管理

Parameter Store イベントに基づいた通知の設定またはアクションのトリガー