建立參數群組

若您希望修改不同於預設值的一或多個參數值，便需要建立新的參數群組。您可以使用 ElastiCache 主控台、AWS CLI 或 ElastiCache API 來建立參數群組。

建立參數群組 (主控台)

下列程序說明如何使用 ElastiCache 主控台建立參數群組。

使用 ElastiCache 主控台建立參數群組

1. 登入 AWS Management Console 並前往 https://console.aws.amazon.com/elasticache/ 開啟 ElastiCache 主控台。

2. 若要查看所有可用參數群組的清單，請從左側的導覽窗格中，選擇 Parameter Groups (參數群組)。

3. 若要建立新的參數群組，請選擇 Create Parameter Group (建立參數群組)。

   Create Parameter Group (建立參數群組) 畫面隨即出現。

4. 從 Family (系列) 清單，選擇做為您參數群組範本的參數群組系列。

   參數群組系列 (例如 redis3.2) 會在參數群組中定義實際的參數以及其初始值。參數群組系列必須與叢集的引擎和版本一致。

5. 在 Name (名稱) 方塊中，輸入此參數群組的唯一名稱。

   建立叢集或修改叢集的參數群組時，您便會根據其名稱選擇參數群組。因此，我們建議選擇附帶資訊且能以某種方式識別參數群組系列的名稱。

   參數群組命名限制條件如下：

   • 必須以 ASCII 字母開頭。

   • 它只能包含 ASCII 字母、數字和連字符號。

   • 長度必須介於 1 至 255 個字元之間。

   • 不能連續包含兩個連字號。

   • 結尾不能是連字號。

6. 在 Description (描述) 方塊中，輸入參數群組的描述。

7. 若要建立參數群組，請選擇 Create (建立)。

   若要終止程序而不建立參數群組，請選擇 Cancel (取消)。

8. 建立參數群組時，它會擁有系列的預設值。若要變更預設值，您必須修改參數群組。如需更多詳細資訊，請參閱 修改參數群組。

建立參數群組 (AWS CLI)

若要使用 AWS CLI 建立參數群組，請搭配這些參數，使用 create-cache-parameter-group 命令。

• --cache-parameter-group-name - 參數群組的名稱。

  參數群組命名限制條件如下：

  • 必須以 ASCII 字母開頭。

  • 它只能包含 ASCII 字母、數字和連字符號。

  • 長度必須介於 1 至 255 個字元之間。

  • 不能連續包含兩個連字號。

  • 結尾不能是連字號。

• --cache-parameter-group-family - 參數群組的引擎和版本系列。

• --description - 使用者提供的參數群組說明。

以下範例會建立名為 myRed28 的參數群組，並使用 redis2.8 系列做為範本。

若為 Linux、macOS 或 Unix：

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

針對 Windows：

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

此命令的輸出看起來會與以下內容相似。

{
    "CacheParameterGroup": {
        "CacheParameterGroupName": "myRed28", 
        "CacheParameterGroupFamily": "redis2.8", 
        "Description": "My first parameter group"
    }
}

建立參數群組時，它會擁有系列的預設值。若要變更預設值，您必須修改參數群組。如需更多詳細資訊，請參閱 修改參數群組。

如需更多詳細資訊，請參閱 create-cache-parameter-group。

建立參數群組 (ElastiCache API)

若要使用 ElastiCache API 建立參數群組，請搭配這些參數使用 CreateCacheParameterGroup 動作。

• ParameterGroupName - 參數群組的名稱。

  參數群組命名限制條件如下：

  • 必須以 ASCII 字母開頭。

  • 它只能包含 ASCII 字母、數字和連字符號。

  • 長度必須介於 1 至 255 個字元之間。

  • 不能連續包含兩個連字號。

  • 結尾不能是連字號。

• CacheParameterGroupFamily - 參數群組的引擎和版本系列。例如 redis2.8。

• Description - 使用者提供的參數群組說明。

以下範例會建立名為 myRed28 的參數群組，並使用 redis2.8 系列做為範本。

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

此動作的回應看起來會與以下內容相似。

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

建立參數群組時，它會擁有系列的預設值。若要變更預設值，您必須修改參數群組。如需更多詳細資訊，請參閱 修改參數群組。

如需更多詳細資訊，請參閱 CreateCacheParameterGroup。