Descrever instâncias 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á.

Descrever instâncias do Amazon DocumentDB

É possível usar o Console de gerenciamento do Amazon DocumentDB ou a AWS CLI para ver detalhes como endpoints de conexão, VPCs de grupos de segurança, autoridade de certificação e grupos de parâmetros pertencentes às suas instâncias do Amazon DocumentDB.

Using the Console de gerenciamento da AWS

Para visualizar os detalhes de suas instâncias usando o Console de gerenciamento da AWS, siga as etapas abaixo.

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/emr/clusters.

  2. No painel de navegação, escolha Clusters.

    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.) no canto superior esquerdo da página.

  3. Na caixa de navegação Clusters, você verá a coluna Identificador do Cluster. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.

    Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.

  4. Na lista de instâncias, escolha o nome da instância da qual você deseja ver os detalhes. As informações sobre a instância são organizadas nos seguintes agrupamentos:

    • Resumo: informações gerais sobre a instância, incluindo a versão do mecanismo, a classe, o status e todas as manutenções pendentes.

    • Conectividade e segurança: a seção Conecte-se lista os endpoints de conexão para se conectar a essa instância com o shell do mongo ou com uma aplicação. A seção Grupos de segurança lista os grupos de segurança associados a essa instância e suas descrições e ID da VPC.

    • Configuração: a seção Detalhes lista as configurações e o status da instância, incluindo o nome do recurso da Amazon (ARN), o endpoint, o perfil, a classe e a autoridade certificadora da instância. Ela também lista as configurações de segurança e de rede da instância e as informações de backup. A seção Detalhes do cluster lista os detalhes do cluster ao qual essa instância pertence. A seção Instâncias de cluster lista todas as instâncias que pertencem ao cluster com cada função e status de grupo de parâmetros de cluster de cada instância.

      nota

      É possível modificar o cluster associado à sua instância selecionando Modificar ao lado do cabeçalho Detalhes do cluster. Para obter mais informações, consulte Modificar um cluster do Amazon DocumentDB.

    • Monitoramento: as métricas do CloudWatch Logs para essa instância. Para obter mais informações, consulte Monitorando o Amazon DocumentDB com CloudWatch.

    • Eventos e tags: a seção Eventos recentes lista os eventos recentes dessa instância. O Amazon DocumentDB mantém um registro de eventos que se relacionam a seus clusters, instâncias, snapshots, grupos de segurança e grupos de parâmetros do cluster. Essas informações incluem a data, a hora e a mensagem associadas a cada evento. A seção Tags lista as tags anexadas a este cluster. Para obter mais informações, consulte Marcação de recursos do Amazon DocumentDB.

Using the AWS CLI

Para visualizar os detalhes de suas instâncias do Amazon DocumentDB usando a AWS CLI, use o comando describe-db-clusters conforme mostrado nos exemplos abaixo. Para obter mais informações, consulte DescribeDBInstances na Referência de API para gerenciamento de recursos do Amazon DocumentDB.

nota

Para determinados atributos de gerenciamento, como o gerenciamento do ciclo de vida de cluster e instâncias, o Amazon DocumentDB aproveita a tecnologia operacional compartilhada com o Amazon RDS. O parâmetro de filtro filterName=engine,Values=docdb só retorna clusters do Amazon DocumentDB.

  1. Liste todas as instâncias do Amazon DocumentDB.

    O código da AWS CLI a seguir lista os detalhes de todas as instâncias do Amazon DocumentDB em uma região.

    Para Linux, macOS ou Unix:

    aws docdb describe-db-instances \
    --filter Name=engine,Values=docdb

    Para Windows:

    aws docdb describe-db-instances \
    --filter Name=engine,Values=docdb

  2. Listar todos os detalhes de uma instância especificada do Amazon DocumentDB

    O código a seguir lista os detalhes para sample-cluster-instance. Incluir o parâmetro --db-instance-identifier com o nome de uma instância restringe a saída às informações sobre essa instância específica.

    Para Linux, macOS ou Unix:

    aws docdb describe-db-instances \
    --db-instance-identifier sample-cluster-instance

    Para Windows:

    aws docdb describe-db-instances \
    --db-instance-identifier sample-cluster-instance

    A saída dessa operação é semelhante à seguinte.

    {
    "DBInstances": [
        {
            "DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
            "DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
            "VpcSecurityGroups": [
                {
                    "VpcSecurityGroupId": "sg-77186e0d",
                    "Status": "active"
                }
            ],
            "DBInstanceClass": "db.r5.large",
            "DBInstanceStatus": "creating",
            "AutoMinorVersionUpgrade": true,
            "PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
            "BackupRetentionPeriod": 1,
            "StorageEncrypted": true,
            "DBClusterIdentifier": "sample-cluster",
            "EngineVersion": "3.6.0",
            "AvailabilityZone": "us-east-1a",
            "Engine": "docdb",
            "PromotionTier": 2,
            "DBInstanceIdentifier": "sample-cluster-instance",
            "PreferredBackupWindow": "00:00-00:30",
            "PubliclyAccessible": false,
            "DBSubnetGroup": {
                "DBSubnetGroupName": "default",
                "Subnets": [
                    {
                        "SubnetIdentifier": "subnet-4e26d263",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1a"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-afc329f4",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1c"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-b3806e8f",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1e"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-53ab3636",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1d"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-991cb8d0",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1b"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-29ab1025",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1f"
                        },
                        "SubnetStatus": "Active"
                    }
                ],
                "VpcId": "vpc-91280df6",
                "DBSubnetGroupDescription": "default",
                "SubnetGroupStatus": "Complete"
            },
            "PendingModifiedValues": {},
            "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
        }
    ]
}