As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criação de um grupo de parâmetros do ElastiCache
<a name="ParameterGroups.Creating"></a>

Você precisará criar um novo parameter group se houver um ou mais valores de parâmetros que você deseja alterar a partir dos valores padrão. Você pode criar um grupo de parâmetros usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache.

## Criação de um grupo de parâmetros do ElastiCache (console)
<a name="ParameterGroups.Creating.CON"></a>

O procedimento a seguir mostra como criar um grupo de parâmetros usando o console do ElastiCache.

**Para criar um grupo de parâmetros usando o console do ElastiCache**

1. Faça login no Console de gerenciamento da AWS e abra o console do ElastiCache em [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Para ver uma lista de todos os parameter groups disponíveis, no painel de navegação à esquerda, escolha **Parameter Groups**.

1. Para criar um parameter group, escolha **Create Parameter Group**.

   A tela **Create Parameter Group** (Criar grupo de parâmetros) será exibida.

1. Na lista **Family**, escolha a família de parameter groups que será o modelo para o seu parameter group.

   A família de grupo de parâmetros, como *memcached1.4* ou *redis3.2*, define os parâmetros efetivos em seu grupo de parâmetros, além de seus valores iniciais. A família de parameter groups deve corresponder ao mecanismo e à versão do cluster.

1. Na caixa **Name**, digite um nome exclusivo para esse parameter group.

   Ao criar um cluster ou modificar o parameter group de um cluster, você escolherá o parameter group pelo seu nome. Portanto, recomendamos que o nome seja informativo e de alguma forma identifique a família do parameter group.

   As limitações de nomenclatura de grupo de parâmetros são as seguintes:
   + Deve começar com uma letra ASCII.
   + Pode conter apenas letras ASCII, dígitos e hífens.
   + Deve ter entre 1 e 255 caracteres.
   + Não podem conter dois hifens consecutivos.
   + Não podem terminar com um hífen.

1. Na caixa **Description**, digite uma descrição para o parameter group.

1. Para criar o parameter group, escolha **Create**.

   Para encerrar o processo sem criar o parameter group, escolha **Cancel**.

1. Quando o parameter group for criado, ele terá os valores padrão da família. Para alterar os valores padrão, você deve modificar o parameter group. Para obter mais informações, consulte [Modificação de um grupo de parâmetros do ElastiCache](ParameterGroups.Modifying.md).

## Criação de um grupo de parâmetros do ElastiCache (AWS CLI)
<a name="ParameterGroups.Creating.CLI"></a>

Para criar um grupo de parâmetros usando a AWS CLI, use o comando `create-cache-parameter-group` com esses parâmetros.
+ `--cache-parameter-group-name`: O nome do grupo de parâmetros.

  As limitações de nomenclatura de grupo de parâmetros são as seguintes:
  + Deve começar com uma letra ASCII.
  + Pode conter apenas letras ASCII, dígitos e hífens.
  + Deve ter entre 1 e 255 caracteres.
  + Não podem conter dois hifens consecutivos.
  + Não podem terminar com um hífen.
+ `--cache-parameter-group-family`: o mecanismo e a família de versões para o grupo de parâmetros.
+ `--description`: uma descrição fornecida pelo usuário para o grupo de parâmetros.

**Example**  
O exemplo a seguir cria um parameter group chamado *myMem14* usando a família memcached1.4 como modelo.   
Para Linux, macOS ou Unix:  

```
aws elasticache create-cache-parameter-group \
    --cache-parameter-group-name myMem14  \
    --cache-parameter-group-family memcached1.4 \
    --description "My first parameter group"
```
Para Windows:  

```
aws elasticache create-cache-parameter-group ^
    --cache-parameter-group-name myMem14  ^
    --cache-parameter-group-family memcached1.4 ^
    --description "My first parameter group"
```
A saída desse comando deve ser semelhante a esta.  

```
{
    "CacheParameterGroup": {
        "CacheParameterGroupName": "myMem14", 
        "CacheParameterGroupFamily": "memcached1.4", 
        "Description": "My first  parameter group"
    }
}
```

**Example**  
O exemplo a seguir cria um parameter group chamado *myRed28* usando a família redis2.8 como modelo.   
Para Linux, macOS ou Unix:  

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

```
aws elasticache create-cache-parameter-group ^
    --cache-parameter-group-name myRed28  ^
    --cache-parameter-group-family redis2.8 ^
    --description "My first parameter group"
```
A saída desse comando deve ser semelhante a esta.  

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

Quando o parameter group for criado, ele terá os valores padrão da família. Para alterar os valores padrão, você deve modificar o parameter group. Para obter mais informações, consulte [Modificação de um grupo de parâmetros do ElastiCache](ParameterGroups.Modifying.md).

Para obter mais informações, consulte [https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-parameter-group.html).

## Criação de um grupo de parâmetros do ElastiCache (API do ElastiCache)
<a name="ParameterGroups.Creating.API"></a>

Para criar um grupo de parâmetros usando a API do ElastiCache, use a ação `CreateCacheParameterGroup` com esses parâmetros.
+ `ParameterGroupName`: O nome do grupo de parâmetros.

  As limitações de nomenclatura de grupo de parâmetros são as seguintes:
  + Deve começar com uma letra ASCII.
  + Pode conter apenas letras ASCII, dígitos e hífens.
  + Deve ter entre 1 e 255 caracteres.
  + Não podem conter dois hifens consecutivos.
  + Não podem terminar com um hífen.
+ `CacheParameterGroupFamily`: o mecanismo e a família de versões para o grupo de parâmetros. Por exemplo, `memcached1.4`.
+ `CacheParameterGroupFamily`: o mecanismo e a família de versões para o grupo de parâmetros. Por exemplo, `redis2.8`.
+ `Description`: uma descrição fornecida pelo usuário para o grupo de parâmetros.

**Example**  
O exemplo a seguir cria um parameter group chamado *myMem14* usando a família memcached1.4 como modelo.   

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateCacheParameterGroup
   &CacheParameterGroupFamily=memcached1.4
   &CacheParameterGroupName=myMem14
   &Description=My%20first%20parameter%20group
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &Version=2015-02-02
   &X-Amz-Credential=<credential>
```
A resposta dessa ação deve ser algo semelhante ao seguinte.  

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

**Example**  
O exemplo a seguir cria um parameter group chamado *myRed28* usando a família redis2.8 como modelo.   

```
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>
```
A resposta dessa ação deve ser algo semelhante ao seguinte.  

```
<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>
```

Quando o parameter group for criado, ele terá os valores padrão da família. Para alterar os valores padrão, você deve modificar o parameter group. Para obter mais informações, consulte [Modificação de um grupo de parâmetros do ElastiCache](ParameterGroups.Modifying.md).

Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheParameterGroup.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheParameterGroup.html).