本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立參數群組
<a name="parametergroups.creating"></a>

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

## 建立參數群組 (主控台)
<a name="parametergroups.creatingclusters.viewdetails"></a>

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

**使用 MemoryDB 主控台建立參數群組**

1. 登入 AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

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

1. 若要建立參數群組，請選擇**建立參數群組**。

   **建立參數群組**頁面隨即出現。

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

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

   參數群組命名限制條件如下：
   + 必須以 ASCII 字母開頭。
   + 它只能包含 ASCII 字母、數字和連字符號。
   + 長度必須介於 1 至 255 個字元之間。
   + 不能連續包含兩個連字號。
   + 結尾不能是連字號。

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

1. 在引擎版本相容性方塊中，選擇此參數群組對應的引擎版本。

1. 在**標籤**中，選擇性地新增標籤，以搜尋和篩選參數群組或追蹤AWS成本。

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

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

1. 建立參數群組時，它會擁有系列的預設值。若要變更預設值，您必須修改參數群組。如需詳細資訊，請參閱[修改參數群組](parametergroups.modifying.md)。

## 建立參數群組 (AWSCLI)
<a name="parametergroups.creating.cli"></a>

若要使用 建立參數群組AWS CLI，請使用 命令`create-parameter-group`搭配這些參數。
+ `--parameter-group-name` - 參數群組的名稱。

  參數群組命名限制條件如下：
  + 必須以 ASCII 字母開頭。
  + 它只能包含 ASCII 字母、數字和連字符號。
  + 長度必須介於 1 至 255 個字元之間。
  + 不能連續包含兩個連字號。
  + 結尾不能是連字號。
+ `--family` - 參數群組的引擎和版本系列。
+ `--description` - 使用者提供的參數群組說明。

**Example**  
下列範例使用 memorydb\$1redis6 系列作為範本，建立名為 *myRedis6x* 的參數群組。  
針對 Linux、macOS 或 Unix：  

```
aws memorydb create-parameter-group \
    --parameter-group-name myRedis6x  \
    --family memorydb_redis6 \
    --description "My first parameter group"
```
針對 Windows：  

```
aws memorydb create-parameter-group ^
    --parameter-group-name myRedis6x  ^
    --family memorydb_redis6 ^
    --description "My first parameter group"
```
此命令的輸出看起來會與以下內容相似。  

```
{
    "ParameterGroup": {
        "Name": "myRedis6x", 
        "Family": "memorydb_redis6",
        "Description": "My first parameter group",
        "ARN": "arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x"
    }
}
```

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

如需詳細資訊，請參閱[https://docs.aws.amazon.com/cli/latest/reference/memorydb/create-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/memorydb/create-parameter-group.html)。

## 建立參數群組 (MemoryDB API)
<a name="parametergroups.creating.api"></a>

若要使用 MemoryDB API 建立參數群組，請使用 `CreateParameterGroup`動作搭配這些參數。
+ `ParameterGroupName` - 參數群組的名稱。

  參數群組命名限制條件如下：
  + 必須以 ASCII 字母開頭。
  + 它只能包含 ASCII 字母、數字和連字符號。
  + 長度必須介於 1 至 255 個字元之間。
  + 不能連續包含兩個連字號。
  + 結尾不能是連字號。
+ `Family` - 參數群組的引擎和版本系列。例如 `memorydb_redis6`。
+ `Description` - 使用者提供的參數群組說明。

**Example**  
下列範例會使用 memorydb\$1redis6 系列作為範本，建立名為 *myRedis6x* 的參數群組。  

```
https://memory-db.us-east-1.amazonaws.com/
   ?Action=CreateParameterGroup
   &Family=memorydb_redis6
   &ParameterGroupName=myRedis6x
   &Description=My%20first%20parameter%20group
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20210802T192317Z
   &Version=2021-01-01
   &X-Amz-Credential=<credential>
```
此動作的回應看起來會與以下內容相似。  

```
<CreateParameterGroupResponse xmlns="http://memory-db.us-east-1.amazonaws.com/doc/2021-01-01/">
  <CreateParameterGroupResult>
    <ParameterGroup>
      <Name>myRedis6x</Name>
      <Family>memorydb_redis6</Family>
      <Description>My first parameter group</Description>
      <ARN>arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x</ARN>
    </ParameterGroup>
  </CreateParameterGroupResult>
  <ResponseMetadata>
    <RequestId>d8465952-af48-11e0-8d36-859edca6f4b8</RequestId>
  </ResponseMetadata>
</CreateParameterGroupResponse>
```

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

如需詳細資訊，請參閱[https://docs.aws.amazon.com/memorydb/latest/APIReference/API_CreateParameterGroup.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_CreateParameterGroup.html)。