メニュー
Amazon ElastiCache
ユーザーガイド (API Version 2015-02-02)

パラメーターグループを作成する

デフォルト値から変更するパラメーターの値が 1 つ以上ある場合、新しいパラメータグループを作成する必要があります。パラメータグループは、ElastiCache コンソール、AWS CLI または ElastiCache API を使用して作成できます。

パラメータグループを作成する (コンソール)

次の手順では、ElastiCache コンソールを使用してパラメータグループを編集する方法を示します。

ElastiCache コンソールを使用してパラメータグループを作成するには

  1. AWS マネジメントコンソールにサインインし、ElastiCache コンソール(https://console.aws.amazon.com/elasticache/)を開きます。

  2. 左側のナビゲーションペインで、[Parameter Groups] を選択します。

    使用できるパラメータグループのリストは、[Parameter Groups] 画面に表示されます。

  3. パラメータグループを作成するには、[Create Parameter Group] を選択します。

    [Create Parameter Group] 画面が表示されます。

  4. [Family] のリストから、パラメータグループのテンプレートとなるパラメータグループファミリーを選択します。

    パラメータグループファミリーは、redis2.8 などの実際のパラメータグループの実際のパラメータおよびその初期値を定義します。パラメータグループファミリーは、クラスターのエンジンおよびバージョンと一致している必要があります。たとえば、redis2.8 ファミリーでパラメータグループを作成して Redis バージョン 2.6 を実行しているクラスターでそれを使用することはできません。

  5. [Name] ボックスで、このパラメータグループの一意の名前を入力します。

    クラスターを作成、またはクラスターのパラメータグループを変更するときは、パラメータグループを名前で選択します。したがって、わかりやすくパラメータグループのファミリーを特定するのに役立つ名前をお勧めします。たとえば、Redis2-8-24-Custom のような名前を付けます。

    パラメーターグループの命名に関する制約

    • ASCII 文字で始まる必要があります。

    • ASCII文字、数字、ハイフンのみを使用できます。

    • 1~255 文字の長さが必要です。

    • 連続する 2 つのハイフンを含めることはできません。

    • 末尾をハイフンすることはできません。

  6. [Description] ボックスに、パラメータグループの説明を入力します。

  7. パラメータグループを作成するには、[Create] を選択します。

    パラメータグループを作成しないでプロセスを終了するには、[Cancel] を選択します。

  8. パラメータグループが作成されると、ファミリーのデフォルト値が設定されます。デフォルト値を変更するには、パラメータグループを変更する必要があります。詳細については、「パラメーターグループを変更する」を参照してください。

パラメータグループを作成する (AWS CLI)

AWS CLI を使用してパラメータグループを作成するには、以下のパラメータを指定して create-cache-parameter-group コマンドを使用します。

  • --cache-parameter-group-name — パラメータグループの名前。

    パラメーターグループの命名に関する制約

    • ASCII 文字で始まる必要があります。

    • ASCII文字、数字、ハイフンのみを使用できます。

    • 1~255 文字の長さが必要です。

    • 連続する 2 つのハイフンを含めることはできません。

    • 末尾をハイフンすることはできません。

  • --cache-parameter-group-family — パラメータグループのエンジンとバージョンファミリー。たとえば、redis2.8 と指定します。

  • --description — パラメータグループについてユーザーが入力する説明。

次の例では、redis2.8 ファミリーをテンプレートとして使用して、myRedis28 という名前のパラメータグループを作成します。

Linux, macOS, or Unix 用:

Copy
aws elasticache create-cache-parameter-group \ --cache-parameter-group-name myRedis28 \ --cache-parameter-group-family redis2.8 \ --description "My first parameter group"

Windows の場合:

Copy
aws elasticache create-cache-parameter-group ^ --cache-parameter-group-name myRedis28 ^ --cache-parameter-group-family redis2.8 ^ --description "My first parameter group"

このコマンドの出力は次のようになります。

Copy
CACHEPARAMETERGROUP myRedis28 redis2.8 My first parameter group

パラメータグループが作成されると、ファミリーのデフォルト値が設定されます。デフォルト値を変更するには、パラメータグループを変更する必要があります。詳細については、「パラメーターグループを変更する」を参照してください。

詳細については、create-cache-parameter-groupを参照してください。

パラメータグループを作成する (ElastiCache API)

ElastiCache API を使用してパラメータグループを作成するには、以下のパラメータを指定して CreateCacheParameterGroup アクションを使用します。

  • ParameterGroupName — パラメータグループの名前。

    パラメーターグループの命名に関する制約

    • ASCII 文字で始まる必要があります。

    • ASCII文字、数字、ハイフンのみを使用できます。

    • 1~255 文字の長さが必要です。

    • 連続する 2 つのハイフンを含めることはできません。

    • 末尾をハイフンすることはできません。

  • CacheParameterGroupFamily — パラメータグループのエンジンとバージョンファミリー。たとえば、redis2.8 と指定します。

  • Description — パラメータグループについてユーザーが入力する説明。

次の例では、redis2.8 ファミリーをテンプレートとして使用して、myRedis28 という名前のパラメータグループを作成します。

Copy
https://elasticache.us-west-2.amazonaws.com/ ?Action=CreateCacheParameterGroup &CacheParameterGroupFamily=redis2.8 &CacheParameterGroupName=myRedis28 &Description=My%20first%20parameter%20group &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>

このアクションからの応答は、次のようになります。

Copy
<CreateCacheParameterGroupResponse xmlns="http://elasticache.amazonaws.com/doc/2013-06-15/"> <CreateCacheParameterGroupResult> <CacheParameterGroup> <CacheParameterGroupName>myRedis28</CacheParameterGroupName> <CacheParameterGroupFamily>redis2.8</CacheParameterGroupFamily> <Description>My first parameter group</Description> </CacheParameterGroup> </CreateCacheParameterGroupResult> <ResponseMetadata> <RequestId>d8465952-af48-11e0-8d36-859edca6f4b8</RequestId> </ResponseMetadata> </CreateCacheParameterGroupResponse>

パラメータグループが作成されると、ファミリーのデフォルト値が設定されます。デフォルト値を変更するには、パラメータグループを変更する必要があります。詳細については、「パラメーターグループを変更する」を参照してください。

詳細については、CreateCacheParameterGroupを参照してください。