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 los puntos de conexión, los grupos de seguridad y los grupos de parámetros relacionados con sus clústeres de Amazon DocumentDB. VPCs

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 consola AWS Management Console de Amazon DocumentDB y ábrala 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ú () 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, así como su VPC ID y sus 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 final y el grupo de parámetros del 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.

    • Supervisión: las métricas de Amazon CloudWatch Logs de 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 sus clústeres de Amazon DocumentDB mediante el AWS CLI, utilice el describe-db-clusters comando tal y como se muestra en los ejemplos siguientes. Para obtener más información, consulte la DescribeDBClustersreferencia sobre administración API de recursos de Amazon DocumentDB.

nota

Para determinadas funciones de administración, como la administración del ciclo de vida de clústeres e instancias, 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 AWS CLI código siguiente muestra 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

En el AWS CLI código siguiente se enumeran los detalles del clústersample-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 enumerar un subconjunto de los detalles de los clústeres mediante el AWS CLI, añada un elemento --query que especifique los miembros del clúster que se van a enumerar en la describe-db-clusters operación. 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 } ] ] ]