Descripción de los clústeres de Amazon DocumentDB - Amazon DocumentDB

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Descripción de los clústeres de Amazon DocumentDB

Puede utilizar la Consola de administración de Amazon DocumentDB o la AWS CLI para ver detalles como puntos de conexión, grupos de seguridad, VPC y grupos de parámetros pertenecientes a los clústeres de Amazon DocumentDB.

Para más información, consulte los siguientes temas:

Using the AWS Management Console

Use el siguiente procedimiento para ver los detalles de un clúster de Amazon DocumentDB especificado mediante la consola.

  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

  2. En el panel de navegación, seleccione Clusters (Clústeres).

    sugerencia

    Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (Hamburger menu icon with three horizontal lines.) en la esquina superior izquierda de la página.

  3. En la lista de clústeres, elija el nombre del clúster cuyos detalles desea ver. La información sobre el clúster está organizada en las siguientes agrupaciones:

    • Resumen: información general sobre el clúster, incluida la versión del motor, el estado del clúster, el mantenimiento pendiente y el estado de su grupo de parámetros.

    • Conectividad y seguridad: la sección Conectar muestra los puntos de conexión para conectarse a este clúster con el intérprete de comandos de mongo o con una aplicación. La sección Grupos de seguridad muestra los grupos de seguridad asociados a este clúster y su ID de VPC y descripciones.

    • Configuración la sección Detalles del clúster muestra detalles sobre el clúster, incluidos el nombre de recurso de Amazon (ARN), el punto de conexión y el grupo de parámetros de clúster. También muestra la información de copia de seguridad del clúster, los detalles de mantenimiento y la configuración de seguridad y red. La sección Instancias del clúster muestra las instancias que pertenecen a este clúster con el rol de cada instancia y el estado del grupo de parámetros del clúster.

    • Monitoreo: las métricas de los Registros de Amazon CloudWatch para este clúster. Para obtener más información, consulte Supervisión de Amazon DocumentDB con CloudWatch.

    • Eventos y etiquetas: en la sección de eventos recientes se enumeran los eventos recientes de este clúster. Amazon DocumentDB mantiene un registro de los eventos relacionados con los clústeres, las instancias, las instantáneas, los grupos de seguridad y los grupos de parámetros de clúster. Esta información incluye la fecha, la hora y el mensaje asociados a cada evento. La sección Etiquetas muestra las etiquetas asociadas a este clúster.

Using the AWS CLI

Para ver los detalles de los clústeres de Amazon DocumentDB mediante la AWS CLI, utilice el comando describe-db-clusters como se muestra en los siguientes ejemplos. Para obtener más información, consulte DescribeDBClusters en la Referencia de la API para administración de recursos de Amazon DocumentDB.

nota

Para ciertas características de administración, como la administración del ciclo de vida de clúster y de instancia, Amazon DocumentDB aprovecha la tecnología operativa que se comparte con Amazon RDS. El parámetro de filtro filterName=engine,Values=docdb devuelve solo clústeres de Amazon DocumentDB.

Ejemplo 1: enumerar todos los clústeres de Amazon DocumentDB

El código de la AWS CLI siguiente enumera los detalles de todos los clústeres de Amazon DocumentDB de una región.

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

La salida de esta operación será similar a lo que se indica a continuación.

{ "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", ... } ] }

Ejemplo 2: mostrar todos los detalles de un clúster de Amazon DocumentDB especificado

El siguiente código de la AWS CLI muestra los detalles del clúster sample-cluster.

Para Linux, macOS o 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

La salida de esta operación será similar a lo que se indica a continuación.

{ "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" } ] }

Ejemplo 3: mostrar detalles específicos de un clúster de Amazon DocumentDB

Para mostrar un subconjunto de los detalles del clúster mediante la AWS CLI, añada un --query que especifique los miembros del clúster que la operación describe-db-clusters debe mostrar. El parámetro de --db-cluster-identifier es el identificador del clúster concreto del que desea mostrar los detalles. Para obtener más información sobre consultas, consulte Cómo filtrar la salida con la opción --query en la Guía de usuario de AWS Command Line Interface.

En el siguiente ejemplo de la se muestran las instancias de un clúster de Amazon DocumentDB.

Para Linux, macOS o 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]'

La salida de esta operación será similar a lo que se indica a continuación.

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