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á.

# Modificar um grupo de sub-redes do Amazon DocumentDB
<a name="document-db-subnet-group-modify"></a>

Você pode usar o Console de gerenciamento da AWS ou AWS CLI para modificar a descrição de um grupo de sub-redes ou para adicionar ou remover sub-redes de um grupo de sub-redes do Amazon DocumentDB. No entanto, você não pode modificar o grupo de sub-redes `default`.

------
#### [ Using the Console de gerenciamento da AWS ]

Você pode usar a Console de gerenciamento da AWS para alterar a descrição de um grupo de sub-redes ou para adicionar e remover sub-redes. Lembre-se de que, ao terminar, você deve ter pelo menos duas zonas de disponibilidade associadas ao seu grupo de sub-redes.

**Para modificar o grupo de sub-redes**

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

1. No painel de navegação, escolha **Grupos de sub-redes**. Em seguida, escolha o botão à esquerda do nome do grupo de sub-redes. Lembre-se de que você não pode modificar o grupo de sub-redes `default`.
**dica**  
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.

1. Escolha **Ações** e, em seguida, **Modificar**.

1. **Descrição**-Para alterar a descrição de seu grupo de sub-redes, insira uma nova descrição.

1. Para alterar as sub-redes associadas ao grupo de sub-redes, na seção **Adicionar sub-redes**, siga um ou mais destes procedimentos:
   + Para remover todas as sub-redes desse grupo, escolha **Remover todos**.
   + Para remover sub-redes específicas desse grupo, escolha **Remover** para cada sub-rede que você deseja remover.
   + Para adicionar todas as sub-redes associadas a essa VPC, escolha **Adicionar todas as sub-redes relacionadas a essa VPC**.
   + Para adicionar sub-redes específicas a esse grupo de sub-redes, faça o seguinte para cada zona de disponibilidade à qual você deseja adicionar uma sub-rede.

     1. **Zona de disponibilidade**-Na lista, escolha uma nova zona de disponibilidade.

     1. **Sub-rede**—Na lista, escolha uma sub-rede na zona de disponibilidade escolhida para esse grupo de sub-redes.

     1. Escolha **Adicioinar sub-rede**.

1. Na caixa de diálogo de confirmação:
   + Para fazer essas alterações no grupo de sub-redes, escolha **Modificar**.
   + Para manter o grupo de sub-redes inalterado, escolha **Cancelar**.

------
#### [ Using the AWS CLI ]

Você pode usar a AWS CLI para alterar a descrição de um grupo de sub-redes ou para adicionar e remover sub-redes. Lembre-se de que, ao terminar, você deve ter pelo menos duas zonas de disponibilidade associadas ao seu grupo de sub-redes. Você não pode modificar o grupo de sub-redes `default`.

**Parâmetros:**
+ `--db-subnet-group-name`—Obrigatório. O nome do grupo de sub-redes do Amazon DocumentDB que você está modificando.
+ `--subnet-ids`—Obrigatório. Uma lista de todas as sub-redes que você deseja no grupo de sub-redes após essa alteração é feita.
**Importante**  
Todas as sub-redes que estiverem no grupo, mas não estiverem nessa lista serão removidas do grupo de sub-redes. Se você desejar manter qualquer uma das sub-redes que estiverem atualmente no grupo, inclua-as nessa lista.
+ `--db-subnet-group-description`: opcional. A descrição do grupo de sub-redes.

**Example**  
O código a seguir modifica a descrição e substitui as sub-redes existentes pelas sub-redes `subnet-991cb8d0`, `subnet-53ab3636` e `subnet-29ab1025`.  
Para Linux, macOS ou Unix:  

```
aws docdb modify-db-subnet-group \
    --db-subnet-group-name sample-subnet-group \
    --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \
    --db-subnet-group-description "Modified subnet group"
```
Para Windows:  

```
aws docdb modify-db-subnet-group ^
    --db-subnet-group-name sample-subnet-group ^
    --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^
    --db-subnet-group-description "Modified subnet group"
```
A saída dessa operação é semelhante ao seguinte (formato JSON). Observe que esse é o mesmo grupo de sub-rede que foi criado na seção [Criação de um grupo de sub-redes do Amazon DocumentDB](document-db-subnet-group-create.md). No entanto, as sub-redes no grupo de sub-rede são substituídas pelas listadas na operação `modify-db-subnet-group`.  

```
{
    "DBSubnetGroup": {
        "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
        "DBSubnetGroupDescription": "Modified subnet group",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1d"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-53ab3636"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1b"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-991cb8d0"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1f"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-29ab1025"
            }
        ],
        "VpcId": "vpc-91280df6",
        "DBSubnetGroupName": "sample-subnet-group"
    }
}
```

------