Modificar um grupo de sub-redes do Amazon DocumentDB - Amazon DocumentDB

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

Você pode usar o AWS Management Console 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 AWS Management Console

Você pode usar a AWS Management Console 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 AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

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

    Se você não visualizar o painel de navegação à esquerda da tela, selecione o ícone do menu (Hamburger menu icon with three horizontal lines.) no canto superior esquerdo da página.

  3. Escolha Actions (Ações) e, em seguida, Modify (Modificar).

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

  5. Para alterar as sub-redes associadas ao grupo de sub-redes, na seção Add subnets (Adicionar sub-redes), siga um ou mais destes procedimentos:

    • Para remover todas as sub-redes desse grupo, escolha Remove all (Remover todos).

    • Para remover sub-redes específicas desse grupo, escolha Remove (Remover) para cada sub-rede que você deseja remover.

    • Para adicionar todas as sub-redes associadas a essa VPC, escolha Add all the subnets related to this VPC (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.

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

      3. Escolha Adicioinar sub-rede.

  6. Na caixa de diálogo de confirmação:

    • Para fazer essas alterações no grupo de sub-redes, escolha Modify (Modificar).

    • Para manter o grupo de sub-redes inalterado, escolha Cancel (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.

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. 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"
    }
}