API de clústeres de base de datos de Neptune - Amazon Neptune

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.

API de clústeres de base de datos de Neptune

Acciones:

Estructuras:

CreateDBCluster (acción)

        El nombre de la AWS CLI para esta API es: create-db-cluster.

Crea un nuevo clúster de base de datos Amazon Neptune.

Puede utilizar el parámetro ReplicationSourceIdentifier para crear el clúster de base de datos como réplica de lectura de otro clúster de base de datos o una instancia de base de datos de Amazon Neptune.

Tenga en cuenta que cuando crea un nuevo clúster mediante CreateDBCluster directamente, la protección de eliminación está deshabilitada de forma predeterminada (cuando crea un nuevo clúster de producción en la consola, la protección de eliminación está habilitada de forma predeterminada). Solo puede eliminar un clúster de base de datos si su campo DeletionProtection está establecido en false.

Solicitud

  • AvailabilityZones (en la CLI: --availability-zones): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de zonas de disponibilidad de EC2 en el que las que se pueden crear instancias en el clúster de base de datos.

  • BackupRetentionPeriod (en la CLI: --backup-retention-period): un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El número de días durante los que se retienen las copias de seguridad automatizadas. Debe especificar un valor mínimo de 1.

    Valor predeterminado: 1

    Restricciones:

    • Debe ser un valor entre 1 y 35.

  • CopyTagsToSnapshot (en la CLI: --copy-tags-to-snapshot): un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • DatabaseName (en la CLI: --database-name): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre para la base de datos de hasta 64 caracteres alfanuméricos. Si no proporciona un nombre, Amazon Neptune no creará una base de datos en el clúster de base de datos que está creando.

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identificador de clúster de base de datos. Este parámetro se almacena como una cadena en minúsculas.

    Restricciones:

    • Deben contener de 1 a 63 caracteres (letras, números o guiones).

    • El primer carácter debe ser una letra.

    • No puede terminar por un guion ni contener dos guiones consecutivos.

    Ejemplo: my-cluster1

  • DBClusterParameterGroupName (en la CLI: --db-cluster-parameter-group-name): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre del grupo de parámetros del clúster de base de datos que desea asociar a este clúster de base de datos. Si este argumento se omite, se utiliza el predeterminado.

    Restricciones:

    • Si se suministra, debe coincidir con el nombre de un DBClusterParameterGroup existente.

  • DBSubnetGroupName (en la CLI: --db-subnet-group-name): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Un grupo de subred de base de datos con el que asociar este clúster de base de datos.

    Limitaciones: debe coincidir con el nombre de un DBSubnetGroup existente. No debe ser predeterminado.

    Ejemplo: mySubnetgroup

  • DeletionProtection (en la CLI: --deletion-protection): un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Un valor que indica si el clúster de base de datos tiene habilitada la protección contra eliminación. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación. La protección contra eliminación está habilitada de forma predeterminada.

  • EnableCloudwatchLogsExports (en la CLI: --enable-cloudwatch-logs-exports): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos debe exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría) y slowquery (para publicar registros de consultas lentas). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • EnableIAMDatabaseAuthentication (en la CLI: --enable-iam-database-authentication): un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, habilita la autenticación de Amazon Identity and Access Management (IAM) para todo el clúster de base de datos (no se puede configurar en el nivel de instancia).

    Valor predeterminado: false.

  • Engine (en la CLI: --engine): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

    Valores válidos: neptune

  • EngineVersion (en la CLI: --engine-version): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Número de versión del motor de base de datos que se va a usar con el nuevo clúster de base de datos.

    Ejemplo: 1.2.1.0

  • GlobalClusterIdentifier (en la CLI:--global-cluster-identifier): un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    El ID de la base de datos global de Neptune a la que se debe añadir este nuevo clúster de base de datos.

  • KmsKeyId (en la CLI: --kms-key-id): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador de la clave de Amazon KMS de un clúster de base de datos cifrado.

    El identificador de la clave de KMS es el Nombre de recurso de Amazon (ARN) de la clave de cifrado de KMS. Si está creando un clúster de base de datos con la misma cuenta de Amazon a la que pertenece la clave de cifrado de KMS utilizada para cifrar el clúster de base de datos nuevo, puede utilizar el alias de la clave de KMS en lugar del ARN para la clave de cifrado de KMS.

    Si no se especifica una clave de cifrado en KmsKeyId:

    • Si ReplicationSourceIdentifier identifica un origen de cifrado, Amazon Neptune utilizará la clave de cifrado que se utiliza para cifrar el origen. De lo contrario, Amazon Neptune utilizará su clave de cifrado predeterminada.

    • Si el parámetro StorageEncrypted es "true" y no se especifica ReplicationSourceIdentifier, Amazon Neptune utilizará su clave de cifrado predeterminada.

    Amazon KMS crea la clave de cifrado predeterminada para su cuenta de Amazon. Su cuenta de Amazon dispone de una clave de cifrado predeterminada diferente para cada región de Amazon.

    Si crea una réplica de lectura de un clúster de base de datos cifrado en otra región de Amazon, debe configurar KmsKeyId en un ID de la clave de KMS que sea válido en la región de Amazon de destino. Esta clave se utiliza para cifrar la réplica de lectura en esa región de Amazon.

  • Port (en la CLI: --port): un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El número de puerto en el que las instancias en el clúster de base datos aceptan conexiones.

    Valor predeterminado: 8182

  • PreferredBackupWindow (en la CLI: --preferred-backup-window): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El intervalo de tiempo diario durante el que se crean las copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas con el parámetro BackupRetentionPeriod.

    El valor predeterminado es un periodo de 30 minutos seleccionado al azar dentro de un bloque de 8 horas para cada región de Amazon. Para ver los bloques de tiempo disponibles, consulte Periodo de mantenimiento de Neptune en la Guía del usuario de Amazon Neptune.

    Restricciones:

    • Tiene que tener el formato hh24:mi-hh24:mi.

    • Debe indicarse en Tiempo universal coordinado (UTC).

    • No debe entrar en conflicto con la ventana de mantenimiento preferida.

    • Debe durar al menos 30 minutos.

  • PreferredMaintenanceWindow (en la CLI: --preferred-maintenance-window): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en tiempo universal coordinado (UTC).

    Formato: ddd:hh24:mi-ddd:hh24:mi

    El valor predeterminado es un periodo de 30 minutos seleccionado al azar de un bloque de 8 horas de tiempo para cada región de Amazon, que tiene lugar un día de la semana de forma aleatoria. Para ver los bloques de tiempo disponibles, consulte Periodo de mantenimiento de Neptune en la Guía del usuario de Amazon Neptune.

    Días válidos: lunes, martes, miércoles, jueves, viernes, sábado, domingo.

    Restricciones: plazo mínimo de 30 minutos.

  • PreSignedUrl (en la CLI: --pre-signed-url): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Este parámetro es incompatible en estos momentos.

  • ReplicationSourceIdentifier (en la CLI: --replication-source-identifier): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) de la instancia de base de datos de origen o el clúster de base de datos si este clúster de base de datos se crea como réplica de lectura.

  • ServerlessV2ScalingConfiguration (en la CLI: --serverless-v2-scaling-configuration): un objeto ServerlessV2ScalingConfiguration.

    Incluye la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • StorageEncrypted (en la CLI: --storage-encrypted): un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType (en la CLI: --storage-type): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento para el nuevo clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) configura un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño. Si se establece en standard, el tipo de almacenamiento no aparece en la respuesta.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • Tags (en la CLI: --tags): una matriz de objetos Tag.

    Las etiquetas para asignar al nuevo clúster de base de datos.

  • VpcSecurityGroupIds (en la CLI: --vpc-security-group-ids): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de grupos de seguridad de VPC de EC2 para asociar a este clúster de base de datos.

Respuesta

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

  • AllocatedStorage: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

DeleteDBCluster (acción)

        El nombre de la AWS CLI para esta API es: delete-db-cluster.

La acción DeleteDBCluster elimina un clúster de base de datos aprovisionado previamente. Al eliminar un clúster de base de datos, se eliminan todas las copias de seguridad automatizadas para ese clúster de base de datos y no se pueden recuperar. Las instantáneas manuales del clúster de base de datos del clúster de base de datos especificado no se eliminan.

Tenga en cuenta que el clúster de base de datos no se puede eliminar si la protección de eliminación está habilitada. Para eliminarlo, primero debe establecer el campo DeletionProtection en False.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador del clúster de base de datos del clúster de base de datos que se va a eliminar. Este parámetro no distingue entre mayúsculas y minúsculas.

    Restricciones:

    • Debe coincidir con un DBClusterIdentifier existente.

  • FinalDBSnapshotIdentifier (en la CLI: --final-db-snapshot-identifier): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador de instantánea de clúster de base de datos de la nueva instantánea del clúster de base de datos creada al configurar SkipFinalSnapshot como false.

    nota

    Si se especifica este parámetro y también se establece el parámetro SkipFinalShapshot en "true", se producirá un error.

    Restricciones:

    • Debe tener de 1 a 255 letras, números o guiones.

    • El primer carácter debe ser una letra

    • No puede terminar por un guion ni contener dos guiones consecutivos

  • SkipFinalSnapshot (en la CLI: --skip-final-snapshot): un booleano, del tipo: boolean (un valor booleano [true o false]).

    Determina si se crea una instantánea de clúster de base de datos antes de que se elimine el clúster de base de datos. Si se especifica true, no se crea ninguna instantánea del clúster de base de datos. Si se especifica false, se crea una instantánea de clúster de base de datos antes de que se elimine el clúster de base de datos.

    nota

    Debe especificar un parámetro FinalDBSnapshotIdentifier si SkipFinalSnapshot es false.

    Valor predeterminado: false

Respuesta

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

  • AllocatedStorage: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

ModifyDBCluster (acción)

        El nombre de la AWS CLI para esta API es: modify-db-cluster.

Modificar una configuración para un clúster de base de datos. Puede cambiar uno o varios parámetros de configuración de la base de datos mediante la especificación de estos parámetros y los nuevos valores en la solicitud.

Solicitud

  • AllowMajorVersionUpgrade (en la CLI: --allow-major-version-upgrade): un booleano, del tipo: boolean (un valor booleano [true o false]).

    Un valor que indica si se permiten actualizaciones entre distintas versiones principales.

    Restricciones: debe establecer el indicador allow-major-version-upgrade al proporcionar un parámetro EngineVersion que utiliza una versión principal diferente de la versión actual del clúster de base de datos.

  • ApplyImmediately (en la CLI: --apply-immediately): un booleano, del tipo: boolean (un valor booleano [true o false]).

    Un valor que especifica si las modificaciones de esta solicitud y todas las modificaciones pendientes se asignan de manera asincrónica en cuanto sea posible, independientemente del valor de PreferredMaintenanceWindow del clúster de base de datos. Si este parámetro es false, los cambios realizados en el clúster de base de datos se aplican durante la siguiente ventana de mantenimiento.

    El parámetro ApplyImmediately solo afecta a los valores NewDBClusterIdentifier. Si establece el valor del parámetro ApplyImmediately en False, los cambios en los valores NewDBClusterIdentifier se aplicarán durante el siguiente periodo de mantenimiento. Todas los demás cambios se aplican de inmediato, con independencia del valor del parámetro ApplyImmediately.

    Valor predeterminado: false

  • BackupRetentionPeriod (en la CLI: --backup-retention-period): un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El número de días durante los que se retienen las copias de seguridad automatizadas. Debe especificar un valor mínimo de 1.

    Valor predeterminado: 1

    Restricciones:

    • Debe ser un valor entre 1 y 35.

  • CloudwatchLogsExportConfiguration (en la CLI: --cloudwatch-logs-export-configuration): un objeto CloudwatchLogsExportConfiguration.

    La opción de configuración para los tipos de registro que debe habilitarse para la exportación a CloudWatch Logs para un clúster de base de datos específico. Consulte Uso de la CLI para publicar registros de auditoría de Neptune en los regisgtros de CloudWatch.

  • CopyTagsToSnapshot (en la CLI: --copy-tags-to-snapshot): un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador del clúster de base de datos del clúster que se va a modificar. Este parámetro no distingue entre mayúsculas y minúsculas.

    Restricciones:

    • Debe coincidir con el identificador de un DBCluster existente.

  • DBClusterParameterGroupName (en la CLI: --db-cluster-parameter-group-name): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre del grupo de parámetros del clúster de base de datos que se va a usar para el clúster de base de datos.

  • DBInstanceParameterGroupName (en la CLI: --db-instance-parameter-group-name): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre del grupo de parámetros de base de datos que se aplicará a todas las instancias del clúster de base de datos.

    nota

    Al aplicar un grupo de parámetros mediante DBInstanceParameterGroupName, los cambios de parámetros no se aplicarán durante el siguiente periodo de mantenimiento, sino que se aplicarán inmediatamente.

    Predeterminado: la configuración de nombre existente

    Restricciones:

    • El grupo de parámetros de base de datos debe estar en la misma familia de grupos de parámetros de base de datos que la versión de clúster de base de datos de destino.

    • El parámetro DBInstanceParameterGroupName solo es válido en combinación con el parámetro AllowMajorVersionUpgrade.

  • DeletionProtection (en la CLI: --deletion-protection): un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Un valor que indica si el clúster de base de datos tiene habilitada la protección contra eliminación. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación. La protección contra eliminación está deshabilitada de forma predeterminada.

  • EnableIAMDatabaseAuthentication (en la CLI: --enable-iam-database-authentication): un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    True para habilitar el mapeo de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos; de lo contrario, el valor es False.

    Valor predeterminado: false

  • EngineVersion (en la CLI: --engine-version): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El número de versión del motor de base de datos al que desea realizar la actualización. El cambio de este parámetro produce una interrupción. El cambio se aplicará durante el siguiente período de mantenimiento, salvo que el parámetro ApplyImmediately esté establecido en "true".

    Para obtener una lista de las versiones válidas del motor, consulte Versiones del motor de Amazon Neptune o llame a DescribeDBEngineVersions (acción).

  • NewDBClusterIdentifier (en la CLI: --new-db-cluster-identifier): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nuevo identificador del clúster de base de datos cuando se cambia el nombre de un clúster de base de datos. Este valor se almacena como una cadena en minúsculas.

    Restricciones:

    • Deben contener de 1 a 63 caracteres (letras, números o guiones).

    • El primer carácter debe ser una letra

    • No puede terminar por un guion ni contener dos guiones consecutivos

    Ejemplo: my-cluster2

  • Port (en la CLI: --port): un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El número de puerto en el que el clúster de base de datos acepta las conexiones.

    Limitaciones: el valor debe ser 1150-65535

    Valor predeterminado: el mismo puerto que el clúster de base de datos original.

  • PreferredBackupWindow (en la CLI: --preferred-backup-window): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El intervalo de tiempo diario durante el que se crean las copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas con el parámetro BackupRetentionPeriod.

    El valor predeterminado es un periodo de 30 minutos seleccionado al azar dentro de un bloque de 8 horas para cada región de Amazon.

    Restricciones:

    • Tiene que tener el formato hh24:mi-hh24:mi.

    • Debe indicarse en Tiempo universal coordinado (UTC).

    • No debe entrar en conflicto con la ventana de mantenimiento preferida.

    • Debe durar al menos 30 minutos.

  • PreferredMaintenanceWindow (en la CLI: --preferred-maintenance-window): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en tiempo universal coordinado (UTC).

    Formato: ddd:hh24:mi-ddd:hh24:mi

    El valor predeterminado es un periodo de 30 minutos seleccionado al azar de un bloque de 8 horas de tiempo para cada región de Amazon, que tiene lugar un día de la semana de forma aleatoria.

    Días válidos: lunes, martes, miércoles, jueves, viernes, sábado, domingo.

    Restricciones: plazo mínimo de 30 minutos.

  • ServerlessV2ScalingConfiguration (en la CLI: --serverless-v2-scaling-configuration): un objeto ServerlessV2ScalingConfiguration.

    Incluye la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • StorageType (en la CLI: --storage-type): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se va a asociar al clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) configura un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroupIds (en la CLI: --vpc-security-group-ids): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

Respuesta

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

  • AllocatedStorage: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

StartDBCluster (acción)

        El nombre de la AWS CLI para esta API es: start-db-cluster.

Inicia un clúster de base de datos de Amazon Neptune que se detuvo con la consola de Amazon, el comando de la CLI de Amazon stop-db-cluster o la API StopDBCluster.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador del clúster de base de datos del clúster de base de datos de Neptune que se va a iniciar. Este parámetro se almacena como una cadena en minúsculas.

Respuesta

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

  • AllocatedStorage: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

StopDBCluster (acción)

        El nombre de la AWS CLI para esta API es: stop-db-cluster.

Detiene un nuevo clúster de base de datos Amazon Neptune. Cuando se detiene un clúster de base de datos, Neptune conserva los metadatos del clúster de base de datos, incluidos sus puntos de enlace y grupos de parámetros de base de datos.

Neptune también conserva los registros de transacciones para que se pueda realizar una restauración a un momento dado si es necesario.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador del clúster de base de datos del clúster de base de datos de Neptune que se va a detener. Este parámetro se almacena como una cadena en minúsculas.

Respuesta

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

  • AllocatedStorage: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

AddRoleToDBCluster (acción)

        El nombre de la AWS CLI para esta API es: add-role-to-db-cluster.

Asocia un rol de Identity and Access Management (IAM) con un clúster de base de datos de Neptune.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre del clúster de base de datos con el que asociar el rol de IAM.

  • FeatureName (en la CLI: --feature-name): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre de la característica del clúster de base de datos de Neptune con el que asociar el rol de IAM. Para ver la lista de nombres de características admitidos, consulte DBEngineVersion (estructura).

  • RoleArn (en la CLI: --role-arn): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) del rol de IAM que se va a asociar al clúster de base de datos de Neptune, por ejemplo arn:aws:iam::123456789012:role/NeptuneAccessRole.

Respuesta
  • Sin parámetros de respuesta.

RemoveRoleFromDBCluster (acción)

        El nombre de la AWS CLI para esta API es: remove-role-from-db-cluster.

Disocia un rol de Identity and Access Management (IAM) de un clúster de base de datos.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre del clúster de base de datos del que disociar el rol de IAM.

  • FeatureName (en la CLI: --feature-name): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre de la característica del clúster de base de datos del que se va a anular la asociación del rol de IAM. Para ver la lista de nombres de características admitidos, consulte DescribeDBEngineVersions (acción).

  • RoleArn (en la CLI: --role-arn): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) del rol de IAM que se va a disasociar del clúster de base de datos, por ejemplo arn:aws:iam::123456789012:role/NeptuneAccessRole.

Respuesta
  • Sin parámetros de respuesta.

FailoverDBCluster (acción)

        El nombre de la AWS CLI para esta API es: failover-db-cluster.

Fuerza una conmutación por error para un clúster de base de datos.

Una conmutación por error de un clúster de base de datos promueve una de las réplicas de lectura (instancias de solo lectura) del clúster de base de datos a instancia principal (la instancia de escritura del clúster).

Amazon Neptune conmuta automáticamente a una réplica de lectura, si existe, cuando se produce un error en la instancia principal. Puede forzar una conmutación por error cuando desee simular un error en una instancia principal para realizar pruebas. Como cada instancia de un clúster de base de datos tiene su propia dirección de punto de enlace, tendrá que eliminar y restablecer las conexiones existentes que utilizan dichas direcciones de punto de enlace cuando se haya completado la conmutación por error.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Un identificador del clúster de base de datos para forzar una conmutación por error. Este parámetro no distingue entre mayúsculas y minúsculas.

    Restricciones:

    • Debe coincidir con el identificador de un DBCluster existente.

  • TargetDBInstanceIdentifier (en la CLI: --target-db-instance-identifier): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre de la instancia que se va a promover a instancia principal.

    Debe especificar el identificador de instancias para una réplica de lectura del clúster de base de datos. Por ejemplo, mydbcluster-replica1.

Respuesta

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

  • AllocatedStorage: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

PromoteReadReplicaDBCluster (acción)

        El nombre de la AWS CLI para esta API es: promote-read-replica-db-cluster.

No admitido.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): obligatorio: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No admitido.

Respuesta

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

  • AllocatedStorage: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

DescribeDBClusters (acción)

        El nombre de la AWS CLI para esta API es: describe-db-clusters.

Devuelve información sobre clústeres de base de datos aprovisionados y admite la paginación.

nota

Esta operación también puede devolver información para clústeres de Amazon RDS y clústeres de Amazon DocDB.

Solicitud

  • DBClusterIdentifier (en la CLI: --db-cluster-identifier): una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador de clúster de base de datos suministrado por el usuario. Si se especifica este parámetro, se devuelve información solo del clúster de base de datos específico. Este parámetro no distingue entre mayúsculas y minúsculas.

    Restricciones:

    • Si se suministra, debe coincidir con un DBClusterIdentifier existente.

  • Filters (en la CLI: --filters): una matriz de objetos Filtro.

    Un filtro que especifica uno o varios clústeres de bases de datos para describir.

    Filtros compatibles:

    • db-cluster-id: acepta identificadores de clúster de base de datos y Nombres de recursos de Amazon (ARN). La lista de resultados solo incluirá información sobre los clústeres de base de datos identificados por estos ARN.

    • engine - Acepta un nombre de motor (como neptune), y restringe la lista de resultados a clústeres de base de datos creados por ese motor.

    Por ejemplo, para invocar esta API desde la CLI de Amazon y filtrar de modo que solo se devuelvan los clústeres de base de datos de Neptune, puede utilizar el siguiente comando:

    aws neptune describe-db-clusters \ --filters Name=engine,Values=neptune
  • Marker (en la CLI: --marker): una cadena, del tipo: string (una cadena codificada con UTF-8).

    Un token de paginación opcional proporcionado por una solicitud DescribeDBClusters (acción) anterior. Si se especifica este parámetro, la respuesta solo incluye registros más allá del marcador, hasta el valor especificado por MaxRecords.

  • MaxRecords (en la CLI: --max-records): un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El número máximo de registros que se deben incluir en la respuesta. Si el número de registros es superior al valor MaxRecords especificado, se incluye en la respuesta un token de paginación que se conoce como marcador, de modo que se pueda recuperar el resto de resultados.

    Predeterminado: 100

    Restricciones: Mínimo 20, máximo 100.

Respuesta

  • DBClusters: matriz de objetos DBCluster.

    Contiene una lista de los clústeres de base de datos para el usuario.

  • Marker: una cadena, del tipo: string (una cadena codificada con UTF-8).

    Un token de paginación que se pueda utilizar en una solicitud DescribeDBClusters posterior.

Estructuras:

DBCluster (estructura)

Contiene los detalles de un clúster de base de datos de Amazon Neptune.

Este tipo de datos se utiliza como un elemento de respuesta en DescribeDBClusters (acción).

Campos
  • AllocatedStorage: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • AssociatedRoles: se trata de una matriz de objetos DBClusterRole.

    Proporciona una lista de los roles de Amazon Identity and Access Management (IAM) que están asociados con el clúster de base de datos. Los roles de IAM que están asociados a un clúster de base de datos conceden permiso para que este obtenga acceso a otros servicios de Amazon en su nombre.

  • AutomaticRestartTime: se trata de un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Hora en la que el clúster de base de datos se reiniciará automáticamente.

  • AvailabilityZones: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona la lista de zonas de disponibilidad de EC2 en las que se pueden crear instancias en el clúster de base de datos.

  • BacktrackConsumedChangeRecords: se trata de un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BacktrackWindow: se trata de un valor LongOptional, del tipo: long (valor entero firmado de 64 bits).

    No es compatible con Neptune.

  • BackupRetentionPeriod: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • Capacity: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    No es compatible con Neptune.

  • CloneGroupId: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Identifica el grupo de clones al que está asociado el clúster de base de datos.

  • ClusterCreateTime: se trata de un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la hora a la que se creó el clúster de base de datos, en tiempo universal coordinado (UTC).

  • CopyTagsToSnapshot: se trata de un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, las etiquetas se copian en cualquier instantánea del clúster de base de datos que se cree.

  • CrossAccountClone: se trata de un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Si se establece en true, el clúster de base de datos se puede clonar en todas las cuentas.

  • DatabaseName: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene el nombre de la base de datos inicial de este clúster de base de datos que se proporcionó en el momento de la creación, si se especificó uno cuando se creó el clúster de base de datos. Este mismo nombre se devuelve durante el tiempo que dura el clúster de base de datos.

  • DBClusterArn: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) para el clúster de base de datos.

  • DBClusterIdentifier: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene un identificador de clúster de base de datos suministrado por el usuario. Este identificador es la clave única que identifica un clúster de base de datos.

  • DBClusterMembers: se trata de una matriz de objetos DBClusterMember.

    Proporciona la lista de instancias que componen el clúster de base de datos.

  • DBClusterParameterGroup: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el nombre del grupo de parámetros del clúster de base de datos para el clúster de base de datos.

  • DbClusterResourceId: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El identificador inmutable único de la región de Amazon para el clúster de base de datos. Este identificador se encuentra en las entradas de registro de Amazon CloudTrail siempre que se accede a la clave de Amazon KMS para el clúster de base de datos.

  • DBSubnetGroup: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica información sobre el grupo de subred asociado con el clúster de base de datos, incluido el nombre, la descripción y subredes en el grupo de subred.

  • DeletionProtection: se trata de un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Indica si el clúster de base de datos tiene habilitada la protección contra eliminación o no. La base de datos no se puede eliminar cuando está habilitada la protección contra eliminación.

  • EarliestBacktrackTime: se trata de un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    No es compatible con Neptune.

  • EarliestRestorableTime: se trata de un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • EnabledCloudwatchLogsExports: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Una lista de tipos de registro para los que este clúster de base de datos está configurado para exportar a los registros de CloudWatch. Los tipos de registro válidos son: audit (para publicar registros de auditoría en CloudWatch) y slowquery (para publicar registros de consultas lentas en CloudWatch). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

  • Endpoint: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el punto de enlace de conexión para la instancia principal del clúster de base de datos.

  • Engine: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Proporciona el nombre del motor de base de datos que se debe utilizar para este clúster de base de datos.

  • EngineVersion: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Indica la versión del motor de base de datos.

  • GlobalClusterIdentifier: se trata de un GlobalClusterIdentifier, del tipo: string (una cadena codificada con UTF-8), no menos de 1 ni superior a 255 ¿st?s, que coincide con esta expresión regular: [A-Za-z][0-9A-Za-z-:._]*.

    Incluye un identificador de clúster de base de datos global facilitado por el usuario. Este identificador es la clave única que identifica una base de datos global.

  • HostedZoneId: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el ID que Amazon Route 53 asigna al crear una zona alojada.

  • IAMDatabaseAuthenticationEnabled: se trata de un booleano, del tipo: boolean (un valor booleano [true o false]).

    True (Verdadero) si la asignación de cuentas de Amazon Identity and Access Management (IAM) a cuentas de base de datos está habilitada; de lo contrario, el valor es false (falso).

  • IOOptimizedNextAllowedModificationTime: se trata de un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    La próxima vez, podrá modificar el clúster de base de datos para utilizar el tipo de almacenamiento iopt1.

  • KmsKeyId: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Si el valor de StorageEncrypted es true (verdadero), el identificador de la clave de Amazon KMS para el clúster de base de datos cifrado.

  • LatestRestorableTime: se trata de un TStamp, del tipo: timestamp (un momento específico, generalmente definido como un desplazamiento desde la medianoche del 1 de enero de 1970).

    Especifica la última hora a la que se puede restaurar una base de datos con la restauración de un punto en el tiempo.

  • MultiAZ: se trata de un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos tiene instancias en varias zonas de disponibilidad.

  • PendingModifiedValues: se trata de un objeto ClusterPendingModifiedValues.

    Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

  • PercentProgress: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el progreso de la operación como porcentaje.

  • Port: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Especifica el puerto en el que escucha el motor de la base de datos.

  • PreferredBackupWindow: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo diario durante el cual se crean copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas, de acuerdo con la propiedad BackupRetentionPeriod.

  • PreferredMaintenanceWindow: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en el horario universal coordinado (UTC).

  • ReaderEndpoint: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El punto de enlace del lector para el clúster de base de datos. El punto de enlace del lector de un clúster de base de datos equilibra la carga de las conexiones entre las réplicas de lectura que están disponibles en un clúster de base de datos. A medida que los clientes solicitan nuevas conexiones al punto de enlace del lector, Neptune distribuye las solicitudes de conexión entre las réplicas de lectura del clúster de base de datos. Esta funcionalidad puede ayudar a equilibrar la carga de trabajo de lectura entre las distintas réplicas de lectura en el clúster de base de datos.

    Si se produce una conmutación por error y la réplica de lectura a la que está conectado se convierte en la nueva instancia principal, la conexión se interrumpe. Para seguir enviando la carga de trabajo de lectura a otras réplicas de lectura del clúster, puede volver a conectarse al punto de enlace del lector.

  • ReadReplicaIdentifiers: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Contiene uno o varios identificadores de las réplicas de lectura asociados con este clúster de base de datos.

  • ReplicationSourceIdentifier: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ReplicationType: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    No es compatible con Neptune.

  • ServerlessV2ScalingConfiguration: se trata de un objeto ServerlessV2ScalingConfigurationInfo.

    Muestra la configuración de escalado de un clúster de base de datos de Neptune sin servidor.

    Para obtener más información, consulte Uso de Amazon Neptune sin servidor en la Guía del usuario de Amazon Neptune.

  • Status: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado actual de este clúster de base de datos.

  • StorageEncrypted: se trata de un booleano, del tipo: boolean (un valor booleano [true o false]).

    Especifica si el clúster de base de datos está cifrado.

  • StorageType: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El tipo de almacenamiento que se utiliza para el clúster de base de datos.

    Valores válidos:

    • standard: (predeterminado) proporciona un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.

  • VpcSecurityGroups: se trata de una matriz de objetos VpcSecurityGroupMembership.

    Proporciona una lista de grupos de seguridad de VPC a los que pertenece el clúster de base de datos.

DBCluster se utiliza como el elemento de respuesta para:

DBClusterMember (estructura)

Contiene información sobre una instancia que forma parte de un clúster de base de datos.

Campos
  • DBClusterParameterGroupStatus: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el estado del grupo de parámetros del clúster de base de datos para este miembro del clúster de base de datos.

  • DBInstanceIdentifier: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Especifica el identificador de la instancia de este miembro del clúster de base de datos.

  • IsClusterWriter: se trata de un booleano, del tipo: boolean (un valor booleano [true o false]).

    El valor que es true si el miembro del clúster es la instancia principal del clúster de base de datos y false en caso contrario.

  • PromotionTier: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    Un valor que especifica el orden en que se promueve una réplica de lectura a la instancia principal tras un error de la instancia principal existente.

DBClusterRole (estructura)

Describe un rol de Amazon Identity and Access Management (IAM) que está asociado con un clúster de base de datos.

Campos
  • FeatureName: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El nombre de la característica asociada al rol de Amazon Identity and Access Management (IAM). Para ver la lista de nombres de características admitidos, consulte DescribeDBEngineVersions (acción).

  • RoleArn: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El Nombre de recurso de Amazon (ARN) del rol de IAM asociado al clúster de base de datos.

  • Status: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Describe el estado de asociación entre el rol de IAM y el clúster de base de datos. La propiedad del estado devuelve uno de los siguientes valores:

    • ACTIVE: el ARN del rol de IAM se asocia con el clúster de base de datos y se puede utilizar para obtener acceso a otros servicios de Amazon en su nombre.

    • PENDING: el ARN del rol de IAM se está asociando al clúster de base de datos.

    • INVALID: el ARN del rol de IAM se asocia con el clúster de base de datos, pero el clúster de base de datos no puede asumir el rol de IAM para acceder a otros servicios de Amazon en su nombre.

CloudwatchLogsExportConfiguration (estructura)

La opción de configuración para los tipos de registro que se debe habilitar para la exportación a CloudWatch Logs para una instancia de base de datos específica o un clúster de base de datos.

Las matrices EnableLogTypes y DisableLogTypes determinan qué registros se exportarán (o no) a CloudWatch Logs.

Los tipos de registro válidos son: audit (para publicar registros de auditoría) y slowquery (para publicar registros de consultas lentas). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

Campos
  • DisableLogTypes: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    La lista de tipos de registros que desea deshabilitar.

  • EnableLogTypes: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    La lista de tipos de registros que desea habilitar.

PendingCloudwatchLogsExports (estructura)

Una lista de los tipos de registro cuya configuración sigue pendiente. En otras palabras, estos tipos de registro se están activando o desactivando.

Los tipos de registro válidos son: audit (para publicar registros de auditoría) y slowquery (para publicar registros de consultas lentas). Consulte Publicación de registros de Neptune en Registros de Amazon CloudWatch.

Campos
  • LogTypesToDisable: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Tipos de registro que están en proceso de habilitarse. Una vez habilitados, estos tipos de registro se exportan a CloudWatch Logs.

  • LogTypesToEnable: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    Tipos de registro que están en proceso de desactivación. Una vez desactivados, estos tipos de registro no se exportan a CloudWatch Logs.

ClusterPendingModifiedValues (estructura)

Este tipo de datos se utiliza como un elemento de respuesta en la operación ModifyDBCluster e incluye cambios que se aplicarán durante el siguiente periodo de mantenimiento.

Campos
  • AllocatedStorage: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El tamaño de almacenamiento asignado en gibibytes (GiB) para los motores de base de datos. Para Neptune, AllocatedStorage siempre devuelve 1, ya que el tamaño de almacenamiento del clúster de base de datos de Neptune no es fijo, sino que se ajusta automáticamente según sea necesario.

  • BackupRetentionPeriod: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El número de días durante los que se conservan las instantáneas de base de datos automáticas.

  • DBClusterIdentifier: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El valor DBClusterIdentifier del clúster de base de datos.

  • EngineVersion: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    La versión del motor de base de datos.

  • IAMDatabaseAuthenticationEnabled: se trata de un BooleanOptional, del tipo: boolean (un valor booleano [true o false]).

    Un valor que indica si se habilita el mapeo de cuentas de AWS Identity and Access Management (IAM) a la base de datos.

  • Iops: se trata de un IntegerOptional, del tipo: integer (un valor entero firmado de 32 bits).

    El valor de las IOPS aprovisionadas (las operaciones de E/S por segundo). Este ajuste es solo para clústeres de base de datos Multi-AZ.

  • PendingCloudwatchLogsExports: se trata de un objeto PendingCloudwatchLogsExports.

    Esta estructura PendingCloudwatchLogsExports especifica los cambios pendientes en los que los registros de CloudWatch están habilitados y cuáles están deshabilitados.

  • StorageType: se trata de una cadena, del tipo: string (una cadena codificada con UTF-8).

    El cambio pendiente en el tipo de almacenamiento del clúster de base de datos.   Valores válidos:

    • standard: (predeterminado) configura un almacenamiento de bases de datos rentable para aplicaciones con un uso de E/S de moderado a pequeño.

    • iopt1: habilita el almacenamiento optimizado para E/S que está diseñado para satisfacer las necesidades de las cargas de trabajo de gráficos con uso intensivo de operaciones de E/S que requieren precios predecibles con una latencia de E/S baja y un rendimiento de E/S constante.

      El almacenamiento optimizado para E/S de Neptune solo está disponible a partir de la versión 1.3.0.0 del motor.