View a markdown version of this page

Descrever Clusters 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 Clusters do Amazon DocumentDB

Você pode usar o Amazon DocumentDB Management Console ou o AWS CLI para ver detalhes como endpoints de conexão, grupos de segurança, VPCs e grupos de parâmetros relacionados aos seus clusters do Amazon DocumentDB.

Para saber mais, consulte:

Using the Console de gerenciamento da AWS

Use o procedimento a seguir para visualizar os detalhes de um cluster especificado do Amazon DocumentDB usando o console.

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

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

  3. Na lista de clusters, escolha o nome do cluster do qual você deseja ver os detalhes. As informações sobre o cluster estão organizadas nos seguintes agrupamentos:

    • Resumo — informações gerais sobre o cluster, incluindo a versão do mecanismo, o status do cluster, a manutenção pendente e o status do grupo de parâmetros.

    • Conectividade e Segurança: a seção Conectar lista os endpoints de conexão para conectar-se a este cluster, com o shell do mongo ou uma aplicação. A seção Grupos de segurança lista os grupos de segurança associados a esse cluster, suas descrições e ID da VPC.

    • Configuração: a seção Detalhes do cluster lista detalhes sobre o cluster, como nome do recurso da Amazon (ARN), o endpoint e o grupo de parâmetros do cluster. Ela também lista as informações de backup do cluster, os detalhes de manutenção e as configurações de segurança e de rede. A seção Instâncias de cluster lista as instâncias que pertencem a esse cluster com a função de cada instância e o status do grupo de parâmetros do cluster.

    • Monitoramento — As métricas do Amazon CloudWatch Logs para esse cluster. Para obter mais informações, consulte Monitorando o Amazon DocumentDB com CloudWatch.

    • Eventos e tags — a seção Eventos recentes lista os eventos recentes desse cluster. O Amazon DocumentDB mantém um registro de eventos que se relacionam a seus clusters, instâncias, capturas de tela, 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.

Using the AWS CLI

Para visualizar os detalhes dos seus clusters do Amazon DocumentDB usando o AWS CLI, use o describe-db-clusters comando conforme mostrado nos exemplos a seguir. Para obter mais informações, consulte DescribeDBClusters 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 filtro filterName=engine,Values=docdb retorna somente clusters do Amazon DocumentDB.

exemplo

Exemplo 1: listar todos os clusters do Amazon DocumentDB

O AWS CLI código a seguir lista os detalhes de todos os clusters do Amazon DocumentDB em uma região.

aws docdb describe-db-clusters --filter Name=engine,Values=docdb

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

{ "DBClusters": [ { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-1", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-2", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-3", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... } ] }
exemplo

Exemplo 2: listar todos os detalhes de um cluster especificado do Amazon DocumentDB

O AWS CLI código a seguir lista os detalhes do clustersample-cluster.

Para Linux, macOS ou Unix:

aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster

Para Windows:

aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster

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

{ "DBClusters": [ { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1c", "us-east-1a", "us-east-1d" ], "BackupRetentionPeriod": 2, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00", "Endpoint": "sample-cluster.node.us-east-1.amazon.com", "ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "5.0.0", "LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00", "Port": 27017, "MasterUsername": "chimeraAdmin", "PreferredBackupWindow": "22:22-22:52", "PreferredMaintenanceWindow": "sun:03:01-sun:03:31", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-9084c2ec", "Status": "active" } ], "HostedZoneId": "Z06853723JYKYBXTJ49RB", "StorageEncrypted": false, "DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [], "TagList": [], "StorageType": "iopt1", "AutoMinorVersionUpgrade": false, "NetworkType": "IPV4", "IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00" } ] }
exemplo

Exemplo 3: listar os detalhes específicos de um cluster Amazon DocumentDB

Para listar um subconjunto dos detalhes dos clusters usando o AWS CLI, adicione um --query que especifique quais membros do cluster a describe-db-clusters operação deve listar. O parâmetro --db-cluster-identifier é o identificador do cluster específico do qual você deseja exibir os detalhes. Para obter mais informações, consulte Como Filtrar a Saída com a Opção --query no Guia de Usuário AWS Command Line Interface .

O exemplo a seguir lista as instâncias em um cluster do Amazon DocumentDB.

Para Linux, macOS ou Unix:

aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]'

Para Windows:

aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterMembers]'

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

[ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ]