Ejemplos de Amazon Redshift que utilizan AWS CLI - AWS Ejemplos de código de SDK

Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de ejemplos de AWS Doc SDK.

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.

Ejemplos de Amazon Redshift que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface mediante Amazon Redshift.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar accept-reserved-node-exchange.

AWS CLI

Para aceptar un intercambio de nodos reservados

El siguiente accept-reserved-node-exchange ejemplo acepta el intercambio de un nodo DC1 reservado por un nodo DC2 reservado.

aws redshift accept-reserved-node-exchange / --reserved-node-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE / --target-reserved-node-offering-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE

Salida:

{ "ExchangedReservedNode": { "ReservedNodeId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE", "ReservedNodeOfferingId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE", "NodeType": "dc2.large", "StartTime": "2019-12-06T21:17:26Z", "Duration": 31536000, "FixedPrice": 0.0, "UsagePrice": 0.0, "CurrencyCode": "USD", "NodeCount": 1, "State": "exchanging", "OfferingType": "All Upfront", "RecurringCharges": [ { "RecurringChargeAmount": 0.0, "RecurringChargeFrequency": "Hourly" } ], "ReservedNodeOfferingType": "Regular" } }

Para obtener más información, consulte Actualización de nodos reservados con la AWS CLI en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar authorize-cluster-security-group-ingress.

AWS CLI

El GroupThis ejemplo de autorización de acceso a una EC2 seguridad autoriza el acceso a un grupo de EC2 seguridad de Amazon con nombre.Comando:

aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --ec2-security-group-name myec2securitygroup --ec2-security-group-owner-id 123445677890

Autorización del acceso a un rango de CIDR. Este ejemplo autoriza el acceso a un rango de CIDR. Comando:

aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32

En el siguiente ejemplo de código, se muestra cómo utilizar authorize-snapshot-access.

AWS CLI

Autorizar la restauración de una AWS cuenta: un SnapshotThis ejemplo autoriza a la AWS cuenta 444455556666 a restaurar la instantáneamy-snapshot-id. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift authorize-snapshot-access --snapshot-id my-snapshot-id --account-with-restore-access 444455556666

Resultado:

{ "Snapshot": { "Status": "available", "SnapshotCreateTime": "2013-07-17T22:04:18.947Z", "EstimatedSecondsToCompletion": 0, "AvailabilityZone": "us-east-1a", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "Encrypted": false, "OwnerAccount": "111122223333", "BackupProgressInMegabytes": 11.0, "ElapsedTimeInSeconds": 0, "DBName": "dev", "CurrentBackupRateInMegabytesPerSecond: 0.1534, "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "ActualIncrementalBackupSizeInMegabytes"; 11.0, "SnapshotType": "manual", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "mycluster", "TotalBackupSizeInMegabytes": 20.0, "Port": 5439, "NumberOfNodes": 2, "SnapshotIdentifier": "my-snapshot-id" } }

En el siguiente ejemplo de código, se muestra cómo utilizar batch-delete-cluster-snapshots.

AWS CLI

Para eliminar un conjunto de instantáneas del clúster

En el siguiente ejemplo de batch-delete-cluster-snapshots, se elimina un conjunto de instantáneas del clúster manual.

aws redshift batch-delete-cluster-snapshots \ --identifiers SnapshotIdentifier=mycluster-2019-11-06-14-12 SnapshotIdentifier=mycluster-2019-11-06-14-20

Salida:

{ "Resources": [ "mycluster-2019-11-06-14-12", "mycluster-2019-11-06-14-20" ] }

Para obtener más información, consulte Amazon Redshift Snapshots en la Guía de administración de clúster de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar batch-modify-cluster-snapshots.

AWS CLI

Para modificar un conjunto de instantáneas del clúster

En el siguiente ejemplo de batch-modify-cluster-snapshots, se modifica la configuración de un conjunto de instantáneas del clúster.

aws redshift batch-modify-cluster-snapshots \ --snapshot-identifier-list mycluster-2019-11-06-16-31 mycluster-2019-11-06-16-32 \ --manual-snapshot-retention-period 30

Salida:

{ "Resources": [ "mycluster-2019-11-06-16-31", "mycluster-2019-11-06-16-32" ], "Errors": [], "ResponseMetadata": { "RequestId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE", "HTTPStatusCode": 200, "HTTPHeaders": { "x-amzn-requestid": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE, "content-type": "text/xml", "content-length": "480", "date": "Sat, 07 Dec 2019 00:36:09 GMT", "connection": "keep-alive" }, "RetryAttempts": 0 } }

Para obtener más información, consulte Amazon Redshift Snapshots en la Guía de administración de clúster de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar cancel-resize.

AWS CLI

Para cancelar el cambio de tamaño de un clúster

El siguiente ejemplo de cancel-resize cancela una operación de cambio de tamaño clásica de un clúster.

aws redshift cancel-resize \ --cluster-identifier mycluster

Salida:

{ "TargetNodeType": "dc2.large", "TargetNumberOfNodes": 2, "TargetClusterType": "multi-node", "Status": "CANCELLING", "ResizeType": "ClassicResize", "TargetEncryptionType": "NONE" }

Para obtener más información, consulte Resizing Clusters in Amazon Redshift en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte CancelResizela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar copy-cluster-snapshot.

AWS CLI

El VersionsThis ejemplo Obtener una descripción de todo el clúster devuelve una descripción de todas las versiones del clúster. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift copy-cluster-snapshot --source-snapshot-identifier cm:examplecluster-2013-01-22-19-27-58 --target-snapshot-identifier my-saved-snapshot-copy

Resultado:

{ "Snapshot": { "Status": "available", "SnapshotCreateTime": "2013-01-22T19:27:58.931Z", "AvailabilityZone": "us-east-1c", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "DBName": "dev", "ClusterCreateTime": "2013-01-22T19:23:59.368Z", "SnapshotType": "manual", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "examplecluster", "Port": 5439, "NumberOfNodes": "2", "SnapshotIdentifier": "my-saved-snapshot-copy" }, "ResponseMetadata": { "RequestId": "3b279691-64e3-11e2-bec0-17624ad140dd" } }
  • Para obtener más información sobre la API, consulte CopyClusterSnapshotla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-cluster-parameter-group.

AWS CLI

El GroupThis ejemplo de creación de un parámetro de clúster crea un nuevo grupo de parámetros de clúster. Comando:

aws redshift create-cluster-parameter-group --parameter-group-name myclusterparametergroup --parameter-group-family redshift-1.0 --description "My first cluster parameter group"

Resultado:

{ "ClusterParameterGroup": { "ParameterGroupFamily": "redshift-1.0", "Description": "My first cluster parameter group", "ParameterGroupName": "myclusterparametergroup" }, "ResponseMetadata": { "RequestId": "739448f0-64cc-11e2-8f7d-3b939af52818" } }

En el siguiente ejemplo de código, se muestra cómo utilizar create-cluster-security-group.

AWS CLI

Al crear un GroupThis ejemplo de seguridad de clúster, se crea un nuevo grupo de seguridad de clúster. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group"

Resultado:

{ "create_cluster_security_group_response": { "create_cluster_security_group_result": { "cluster_security_group": { "description": "This is my cluster security group", "owner_id": "300454760768", "cluster_security_group_name": "mysecuritygroup", "ec2_security_groups": \[], "ip_ranges": \[] } }, "response_metadata": { "request_id": "5df486a0-343a-11e2-b0d8-d15d0ef48549" } } }

También puede obtener la misma información en formato de texto mediante la opción --output text. Comando:

--output text option.Command:

option.Command:

aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group" --output text

Resultado:

This is my cluster security group 300454760768 mysecuritygroup a0c0bfab-343a-11e2-95d2-c3dc9fe8ab57

En el siguiente ejemplo de código, se muestra cómo utilizar create-cluster-snapshot.

AWS CLI

El SnapshotThis ejemplo de creación de un clúster crea una nueva instantánea del clúster. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift create-cluster-snapshot --cluster-identifier mycluster --snapshot-identifier my-snapshot-id

Resultado:

{ "Snapshot": { "Status": "creating", "SnapshotCreateTime": "2013-01-22T22:20:33.548Z", "AvailabilityZone": "us-east-1a", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "DBName": "dev", "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "SnapshotType": "manual", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "mycluster", "Port": 5439, "NumberOfNodes": "2", "SnapshotIdentifier": "my-snapshot-id" }, "ResponseMetadata": { "RequestId": "f024d1a5-64e1-11e2-88c5-53eb05787dfb" } }
  • Para obtener más información sobre la API, consulte CreateClusterSnapshotla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-cluster-subnet-group.

AWS CLI

El GroupThis ejemplo de creación de una subred de clúster crea un nuevo grupo de subredes de clúster.Comando:

aws redshift create-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup --description "My subnet group" --subnet-ids subnet-763fdd1c

Resultado:

{ "ClusterSubnetGroup": { "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-763fdd1c", "SubnetAvailabilityZone": { "Name": "us-east-1a" } } ], "VpcId": "vpc-7e3fdd14", "SubnetGroupStatus": "Complete", "Description": "My subnet group", "ClusterSubnetGroupName": "mysubnetgroup" }, "ResponseMetadata": { "RequestId": "500b8ce2-698f-11e2-9790-fd67517fb6fd" } }

En el siguiente ejemplo de código, se muestra cómo utilizar create-cluster.

AWS CLI

El ParametersThis ejemplo Crear un clúster con un mínimo crea un clúster con un conjunto mínimo de parámetros. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift create-cluster --node-type dw.hs1.xlarge --number-of-nodes 2 --master-username adminuser --master-user-password TopSecret1 --cluster-identifier mycluster

Resultado:

{ "Cluster": { "NodeType": "dw.hs1.xlarge", "ClusterVersion": "1.0", "PubliclyAccessible": "true", "MasterUsername": "adminuser", "ClusterParameterGroups": [ { "ParameterApplyStatus": "in-sync", "ParameterGroupName": "default.redshift-1.0" } ], "ClusterSecurityGroups": [ { "Status": "active", "ClusterSecurityGroupName": "default" } ], "AllowVersionUpgrade": true, "VpcSecurityGroups": \[], "PreferredMaintenanceWindow": "sat:03:30-sat:04:00", "AutomatedSnapshotRetentionPeriod": 1, "ClusterStatus": "creating", "ClusterIdentifier": "mycluster", "DBName": "dev", "NumberOfNodes": 2, "PendingModifiedValues": { "MasterUserPassword": "\****" } }, "ResponseMetadata": { "RequestId": "7cf4bcfc-64dd-11e2-bea9-49e0ce183f07" } }
  • Para obtener más información sobre la API, consulte CreateClusterla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-event-subscription.

AWS CLI

Para crear una suscripción de notificaciones de un evento

El siguiente ejemplo de create-event-subscription crea una suscripción de notificación al evento.

aws redshift create-event-subscription \ --subscription-name mysubscription \ --sns-topic-arn arn:aws:sns:us-west-2:123456789012:MySNStopic \ --source-type cluster \ --source-ids mycluster

Salida:

{ "EventSubscription": { "CustomerAwsId": "123456789012", "CustSubscriptionId": "mysubscription", "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic", "Status": "active", "SubscriptionCreationTime": "2019-12-09T20:05:19.365Z", "SourceType": "cluster", "SourceIdsList": [ "mycluster" ], "EventCategoriesList": [], "Severity": "INFO", "Enabled": true, "Tags": [] } }

Para obtener más información, consulte Subscribing to Amazon Redshift Event Notifications en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar create-hsm-client-certificate.

AWS CLI

Para crear un certificado de cliente del HSM

El siguiente ejemplo de create-hsm-client-certificate genera un certificado de cliente de HSM que puede utilizar un clúster para conectarse a un HSM.

aws redshift create-hsm-client-certificate \ --hsm-client-certificate-identifier myhsmclientcert

Salida:

{ "HsmClientCertificate": { "HsmClientCertificateIdentifier": "myhsmclientcert", "HsmClientCertificatePublicKey": "-----BEGIN CERTIFICATE----- MIICiEXAMPLECQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTEXAMPLEwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25EXAMPLEIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb2EXAMPLETEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBEXAMPLEMRAwDgYD EXAMPLETZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAEXAMPLEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKEXAMPLEAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk6EXAMPLE3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugEXAMPLEzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEEXAMPLEEAtCu4 nUhVVxYUEXAMPLEh8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GEXAMPLEl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rEXAMPLE=-----END CERTIFICATE-----\n", "Tags": [] } }

Para obtener más información, consulte Amazon Redshift API Permissions Reference en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar create-hsm-configuration.

AWS CLI

Para crear una configuración del HSM

El siguiente ejemplo de create-hsm-configuration crea una configuración del HSM que contiene la información requerida por un clúster para almacenar y utilizar las claves de cifrado de base de datos en un módulo de seguridad de hardware (HSM).

aws redshift create-hsm-configuration / --hsm-configuration-identifier myhsmconnection --description "My HSM connection" --hsm-ip-address 192.0.2.09 --hsm-partition-name myhsmpartition / --hsm-partition-password A1b2c3d4 / --hsm-server-public-certificate myhsmclientcert

Salida:

{ "HsmConfiguration": { "HsmConfigurationIdentifier": "myhsmconnection", "Description": "My HSM connection", "HsmIpAddress": "192.0.2.09", "HsmPartitionName": "myhsmpartition", "Tags": [] } }
  • Para obtener más información sobre la API, consulte CreateHsmConfigurationla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-snapshot-copy-grant.

AWS CLI

Para crear una autorización de copia de instantáneas

En el siguiente create-snapshot-copy-grant ejemplo, se crea una autorización de copia instantánea y se cifran las instantáneas copiadas en una región de destino AWS .

aws redshift create-snapshot-copy-grant \ --snapshot-copy-grant-name mysnapshotcopygrantname

Salida:

{ "SnapshotCopyGrant": { "SnapshotCopyGrantName": "mysnapshotcopygrantname", "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY", "Tags": [] } }

Para obtener más información, consulte Cifrado de la base de datos de Amazon Redshift en la Guía de administración de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar create-snapshot-schedule.

AWS CLI

Para crear una programación de instantáneas

En el siguiente ejemplo de create-snapshot-schedule, se crea una programación de instantáneas con la descripción especificada y una frecuencia de cada 12 horas.

aws redshift create-snapshot-schedule \ --schedule-definitions "rate(12 hours)" \ --schedule-identifier mysnapshotschedule \ --schedule-description "My schedule description"

Salida:

{ "ScheduleDefinitions": [ "rate(12 hours)" ], "ScheduleIdentifier": "mysnapshotschedule", "ScheduleDescription": "My schedule description", "Tags": [] }

Para obtener más información, consulte Programación de instantáneas automatizadas en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte CreateSnapshotSchedulela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-tags.

AWS CLI

Para crear etiquetas para un clúster

En el siguiente ejemplo de create-tags, se agrega el par clave/valor de etiqueta especificado al clúster especificado.

aws redshift create-tags \ --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \ --tags "Key"="mytags","Value"="tag1"

Este comando no produce ninguna salida.

Para obtener más información, consulte Etiquetado de recursos en Amazon Redshift en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte CreateTagsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-cluster-parameter-group.

AWS CLI

El GroupThis ejemplo de eliminar un parámetro de clúster elimina un grupo de parámetros de clúster.Comando:

aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup

En el siguiente ejemplo de código, se muestra cómo utilizar delete-cluster-security-group.

AWS CLI

En el GroupThis ejemplo de Eliminar un clúster de seguridad, se elimina un grupo de seguridad de clúster.Comando:

aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup

En el siguiente ejemplo de código, se muestra cómo utilizar delete-cluster-snapshot.

AWS CLI

En el SnapshotThis ejemplo de eliminar un clúster, se elimina una instantánea de un clúster. Comando:

aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id
  • Para obtener más información sobre la API, consulte DeleteClusterSnapshotla Referencia de comandos.AWS CLI

En el siguiente ejemplo de código, se muestra cómo utilizar delete-cluster-subnet-group.

AWS CLI

El GroupThis ejemplo de eliminar una subred de clúster elimina un grupo de subredes de clúster.Comando:

aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup

Resultado:

{ "ResponseMetadata": { "RequestId": "253fbffd-6993-11e2-bc3a-47431073908a" } }

En el siguiente ejemplo de código, se muestra cómo utilizar delete-cluster.

AWS CLI

El SnapshotThis ejemplo de eliminar un clúster sin un clúster final elimina un clúster, lo que obliga a eliminar los datos para que no se cree una instantánea final del clúster. Comando:

aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot

El SnapshotThis ejemplo Eliminar un clúster y permitir un clúster final elimina un clúster, pero especifica una instantánea final del clúster.Comando:

aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot
  • Para obtener más información sobre la API, consulte DeleteClusterla Referencia de comandos.AWS CLI

En el siguiente ejemplo de código, se muestra cómo utilizar delete-event-subscription.

AWS CLI

Para eliminar la suscripción a un evento

En el siguiente ejemplo de delete-event-subscription, se elimina la suscripción a una notificación de evento especificada.

aws redshift delete-event-subscription \ --subscription-name mysubscription

Este comando no produce ninguna salida.

Para obtener más información, consulte Subscribing to Amazon Redshift Event Notifications en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-hsm-client-certificate.

AWS CLI

Para eliminar un certificado de cliente HSM

En el siguiente ejemplo de delete-hsm-client-certificate, se elimina un certificado de cliente de HSM.

aws redshift delete-hsm-client-certificate \ --hsm-client-certificate-identifier myhsmclientcert

Este comando no produce ninguna salida.

Para obtener más información, consulte Amazon Redshift API Permissions Reference en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-hsm-configuration.

AWS CLI

Para eliminar una configuración HSM

En el siguiente delete-hsm-configuration ejemplo, se elimina la configuración de HSM especificada de la cuenta actual AWS .

aws redshift delete-hsm-configuration / --hsm-configuration-identifier myhsmconnection

Este comando no produce ninguna salida.

  • Para obtener más información sobre la API, consulte la Referencia DeleteHsmConfigurationde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-scheduled-action.

AWS CLI

Para eliminar una acción programada

El siguiente ejemplo de delete-scheduled-action elimina una acción programada especificada.

aws redshift delete-scheduled-action \ --scheduled-action-name myscheduledaction

Este comando no produce ninguna salida.

  • Para obtener más información sobre la API, consulte DeleteScheduledActionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-snapshot-copy-grant.

AWS CLI

Para eliminar una concesión de copia de instantánea

En el siguiente ejemplo de delete-snapshot-copy-grant, se elimina la concesión de una copia de instantáneas especificada.

aws redshift delete-snapshot-copy-grant \ --snapshot-copy-grant-name mysnapshotcopygrantname

Este comando no produce ninguna salida.

Para obtener más información, consulte Cifrado de la base de datos de Amazon Redshift en la Guía de administración de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-snapshot-schedule.

AWS CLI

Para eliminar una programación de instantáneas

En el siguiente ejemplo de delete-snapshot-schedule, se elimina la programación de una instantánea especificada. Debe desasociar los clústeres antes de eliminar la programación.

aws redshift delete-snapshot-schedule \ --schedule-identifier mysnapshotschedule

Este comando no produce ninguna salida.

Para obtener más información, consulte Programación de instantáneas automatizadas en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte DeleteSnapshotSchedulela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-tags.

AWS CLI

Para eliminar etiquetas de un clúster

En el siguiente ejemplo de delete-tags, se eliminan las etiquetas con los nombres de clave especificados del clúster especificado.

aws redshift delete-tags \ --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \ --tag-keys "clustertagkey" "clustertagvalue"

Este comando no produce ninguna salida.

Para obtener más información, consulte Etiquetado de recursos en Amazon Redshift en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte DeleteTagsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-account-attributes.

AWS CLI

Para describir los atributos de una AWS cuenta

En el siguiente describe-account-attributes ejemplo, se muestran los atributos asociados a la AWS cuenta que realiza la llamada.

aws redshift describe-account-attributes

Salida:

{ "AccountAttributes": [ { "AttributeName": "max-defer-maintenance-duration", "AttributeValues": [ { "AttributeValue": "45" } ] } ] }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-db-revisions.

AWS CLI

Para describir las revisiones de la base de datos de un clúster

El siguiente ejemplo de describe-cluster-db-revisions muestra los detalles de una matriz de objetos ClusterDbRevision para el clúster especificado.

aws redshift describe-cluster-db-revisions \ --cluster-identifier mycluster

Salida:

{ "ClusterDbRevisions": [ { "ClusterIdentifier": "mycluster", "CurrentDatabaseRevision": "11420", "DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z", "RevisionTargets": [] } ] }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-parameter-groups.

AWS CLI

El GroupsThis ejemplo Obtener una descripción de todos los parámetros del clúster devuelve una descripción de todos los grupos de parámetros del clúster de la cuenta, con los encabezados de las columnas. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-cluster-parameter-groups

Resultado:

{ "ParameterGroups": [ { "ParameterGroupFamily": "redshift-1.0", "Description": "My first cluster parameter group", "ParameterGroupName": "myclusterparametergroup" } ], "ResponseMetadata": { "RequestId": "8ceb8f6f-64cc-11e2-bea9-49e0ce183f07" } }

También puede obtener la misma información en formato de texto mediante la opción --output text. Comando:

--output text option.Command:

option.Command:

aws redshift describe-cluster-parameter-groups --output text

Resultado:

redshift-1.0 My first cluster parameter group myclusterparametergroup RESPONSEMETADATA 9e665a36-64cc-11e2-8f7d-3b939af52818

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-parameters.

AWS CLI

Recuperar los parámetros de un GroupThis ejemplo de parámetro de clúster especificado recupera los parámetros del grupo de parámetros mencionado. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup

Resultado:

{ "Parameters": [ { "Description": "Sets the display format for date and time values.", "DataType": "string", "IsModifiable": true, "Source": "engine-default", "ParameterValue": "ISO, MDY", "ParameterName": "datestyle" }, { "Description": "Sets the number of digits displayed for floating-point values", "DataType": "integer", "IsModifiable": true, "AllowedValues": "-15-2", "Source": "engine-default", "ParameterValue": "0", "ParameterName": "extra_float_digits" }, (...remaining output omitted...) ] }

También puede obtener la misma información en formato de texto mediante la opción --output text. Comando:

--output text option.Command:

option.Command:

aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup --output text

Resultado:

RESPONSEMETADATA cdac40aa-64cc-11e2-9e70-918437dd236d Sets the display format for date and time values. string True engine-default ISO, MDY datestyle Sets the number of digits displayed for floating-point values integer True -15-2 engine-default 0 extra_float_digits This parameter applies a user-defined label to a group of queries that are run during the same session.. string True engine-default default query_group require ssl for all databaseconnections boolean True true,false engine-default false require_ssl Sets the schema search order for names that are not schema-qualified. string True engine-default $user, public search_path Aborts any statement that takes over the specified number of milliseconds. integer True engine-default 0 statement_timeout wlm json configuration string True engine-default \[{"query_concurrency":5}] wlm_json_configuration

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-security-groups.

AWS CLI

El GroupsThis ejemplo Obtener una descripción de toda la seguridad del clúster devuelve una descripción de todos los grupos de seguridad del clúster de la cuenta. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-cluster-security-groups

Resultado:

{ "ClusterSecurityGroups": [ { "OwnerId": "100447751468", "Description": "default", "ClusterSecurityGroupName": "default", "EC2SecurityGroups": \[], "IPRanges": [ { "Status": "authorized", "CIDRIP": "0.0.0.0/0" } ] }, { "OwnerId": "100447751468", "Description": "This is my cluster security group", "ClusterSecurityGroupName": "mysecuritygroup", "EC2SecurityGroups": \[], "IPRanges": \[] }, (...remaining output omitted...) ] }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-snapshots.

AWS CLI

El SnapshotsThis ejemplo Obtener una descripción de todo el clúster devuelve una descripción de todas las instantáneas del clúster de la cuenta. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-cluster-snapshots

Resultado:

{ "Snapshots": [ { "Status": "available", "SnapshotCreateTime": "2013-07-17T22:02:22.852Z", "EstimatedSecondsToCompletion": -1, "AvailabilityZone": "us-east-1a", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "Encrypted": false, "OwnerAccount": "111122223333", "BackupProgressInMegabytes": 20.0, "ElapsedTimeInSeconds": 0, "DBName": "dev", "CurrentBackupRateInMegabytesPerSecond: 0.0, "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "ActualIncrementalBackupSizeInMegabytes"; 20.0 "SnapshotType": "automated", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "mycluster", "Port": 5439, "TotalBackupSizeInMegabytes": 20.0, "NumberOfNodes": "2", "SnapshotIdentifier": "cm:mycluster-2013-01-22-22-04-18" }, { "EstimatedSecondsToCompletion": 0, "OwnerAccount": "111122223333", "CurrentBackupRateInMegabytesPerSecond: 0.1534, "ActualIncrementalBackupSizeInMegabytes"; 11.0, "NumberOfNodes": "2", "Status": "available", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "AccountsWithRestoreAccess": [ { "AccountID": "444455556666" } ], "TotalBackupSizeInMegabytes": 20.0, "DBName": "dev", "BackupProgressInMegabytes": 11.0, "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "ElapsedTimeInSeconds": 0, "ClusterIdentifier": "mycluster", "SnapshotCreateTime": "2013-07-17T22:04:18.947Z", "AvailabilityZone": "us-east-1a", "NodeType": "dw.hs1.xlarge", "Encrypted": false, "SnapshotType": "manual", "Port": 5439, "SnapshotIdentifier": "my-snapshot-id" } ] } (...remaining output omitted...)

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-subnet-groups.

AWS CLI

El GroupsThis ejemplo Obtener una descripción de toda la subred del clúster devuelve una descripción de todos los grupos de subredes del clúster. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-cluster-subnet-groups

Resultado:

{ "ClusterSubnetGroups": [ { "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-763fdd1c", "SubnetAvailabilityZone": { "Name": "us-east-1a" } } ], "VpcId": "vpc-7e3fdd14", "SubnetGroupStatus": "Complete", "Description": "My subnet group", "ClusterSubnetGroupName": "mysubnetgroup" } ], "ResponseMetadata": { "RequestId": "37fa8c89-6990-11e2-8f75-ab4018764c77" } }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-tracks.

AWS CLI

Para describir las pistas del clúster

En el siguiente ejemplo de describe-cluster-tracks, se muestran los detalles de las pistas de mantenimiento disponibles.

aws redshift describe-cluster-tracks \ --maintenance-track-name current

Salida:

{ "MaintenanceTracks": [ { "MaintenanceTrackName": "current", "DatabaseVersion": "1.0.11420", "UpdateTargets": [ { "MaintenanceTrackName": "preview_features", "DatabaseVersion": "1.0.11746", "SupportedOperations": [ { "OperationName": "restore-from-cluster-snapshot" } ] }, { "MaintenanceTrackName": "trailing", "DatabaseVersion": "1.0.11116", "SupportedOperations": [ { "OperationName": "restore-from-cluster-snapshot" }, { "OperationName": "modify-cluster" } ] } ] } ] }

Para obtener más información, consulte Choosing Cluster Maintenance Tracks en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte DescribeClusterTracksla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-cluster-versions.

AWS CLI

El VersionsThis ejemplo Obtener una descripción de todo el clúster devuelve una descripción de todas las versiones del clúster. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-cluster-versions

Resultado:

{ "ClusterVersions": [ { "ClusterVersion": "1.0", "Description": "Initial release", "ClusterParameterGroupFamily": "redshift-1.0" } ], "ResponseMetadata": { "RequestId": "16a53de3-64cc-11e2-bec0-17624ad140dd" } }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-clusters.

AWS CLI

El ClustersThis ejemplo Obtener una descripción de todo devuelve una descripción de todos los clústeres de la cuenta. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-clusters

Resultado:

{ "Clusters": [ { "NodeType": "dw.hs1.xlarge", "Endpoint": { "Port": 5439, "Address": "mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com" }, "ClusterVersion": "1.0", "PubliclyAccessible": "true", "MasterUsername": "adminuser", "ClusterParameterGroups": [ { "ParameterApplyStatus": "in-sync", "ParameterGroupName": "default.redshift-1.0" } ], "ClusterSecurityGroups": [ { "Status": "active", "ClusterSecurityGroupName": "default" } ], "AllowVersionUpgrade": true, "VpcSecurityGroups": \[], "AvailabilityZone": "us-east-1a", "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "PreferredMaintenanceWindow": "sat:03:30-sat:04:00", "AutomatedSnapshotRetentionPeriod": 1, "ClusterStatus": "available", "ClusterIdentifier": "mycluster", "DBName": "dev", "NumberOfNodes": 2, "PendingModifiedValues": {} } ], "ResponseMetadata": { "RequestId": "65b71cac-64df-11e2-8f5b-e90bd6c77476" } }

También puede obtener la misma información en formato de texto mediante la opción --output text. Comando:

--output text option.Command:

option.Command:

aws redshift describe-clusters --output text

Resultado:

dw.hs1.xlarge 1.0 true adminuser True us-east-1a 2013-01-22T21:59:29.559Z sat:03:30-sat:04:00 1 available mycluster dev 2 ENDPOINT 5439 mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com in-sync default.redshift-1.0 active default PENDINGMODIFIEDVALUES RESPONSEMETADATA 934281a8-64df-11e2-b07c-f7fbdd006c67
  • Para obtener más información sobre la API, consulte DescribeClustersla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-default-cluster-parameters.

AWS CLI

El ParametersThis ejemplo Obtener una descripción del clúster predeterminado devuelve una descripción de los parámetros del clúster predeterminados de la redshift-1.0 familia. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-default-cluster-parameters --parameter-group-family redshift-1.0

Resultado:

{ "DefaultClusterParameters": { "ParameterGroupFamily": "redshift-1.0", "Parameters": [ { "Description": "Sets the display format for date and time values.", "DataType": "string", "IsModifiable": true, "Source": "engine-default", "ParameterValue": "ISO, MDY", "ParameterName": "datestyle" }, { "Description": "Sets the number of digits displayed for floating-point values", "DataType": "integer", "IsModifiable": true, "AllowedValues": "-15-2", "Source": "engine-default", "ParameterValue": "0", "ParameterName": "extra_float_digits" }, (...remaining output omitted...) ] } }

Para ver una lista de familias de grupos de parámetros válidos, use el comando describe-cluster-parameter-groups.

comando describe-cluster-parameter-groups

comando.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-event-categories.

AWS CLI

Para describir las categorías de eventos de un clúster

En el siguiente ejemplo de describe-event-categories, se muestran los detalles de las categorías de eventos de un clúster.

aws redshift describe-event-categories \ --source-type cluster

Salida:

{ "EventCategoriesMapList": [ { "SourceType": "cluster", "Events": [ { "EventId": "REDSHIFT-EVENT-2000", "EventCategories": [ "management" ], "EventDescription": "Cluster <cluster name> created at <time in UTC>.", "Severity": "INFO" }, { "EventId": "REDSHIFT-EVENT-2001", "EventCategories": [ "management" ], "EventDescription": "Cluster <cluster name> deleted at <time in UTC>.", "Severity": "INFO" }, { "EventId": "REDSHIFT-EVENT-3625", "EventCategories": [ "monitoring" ], "EventDescription": "The cluster <cluster name> can't be resumed with its previous elastic network interface <ENI id>. We will allocate a new elastic network interface and associate it with the cluster node.", "Severity": "INFO" } ] } ] }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-event-subscriptions.

AWS CLI

Para describir suscripciones a eventos

En el siguiente ejemplo de describe-event-subscriptions, se muestran las suscripciones a una notificación de evento especificada.

aws redshift describe-event-subscriptions \ --subscription-name mysubscription

Salida:

{ "EventSubscriptionsList": [ { "CustomerAwsId": "123456789012", "CustSubscriptionId": "mysubscription", "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic", "Status": "active", "SubscriptionCreationTime": "2019-12-09T21:50:21.332Z", "SourceIdsList": [], "EventCategoriesList": [ "management" ], "Severity": "ERROR", "Enabled": true, "Tags": [] } ] }

Para obtener más información, consulte Subscribing to Amazon Redshift Event Notifications en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-events.

AWS CLI

Descripción de todos los eventos: este ejemplo devuelve todos los eventos. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-events

Resultado:

{ "Events": [ { "Date": "2013-01-22T19:17:03.640Z", "SourceIdentifier": "myclusterparametergroup", "Message": "Cluster parameter group myclusterparametergroup has been created.", "SourceType": "cluster-parameter-group" } ], "ResponseMetadata": { "RequestId": "9f056111-64c9-11e2-9390-ff04f2c1e638" } }

También puede obtener la misma información en formato de texto mediante la opción --output text. Comando:

--output text option.Command:

option.Command:

aws redshift describe-events --output text

Resultado:

2013-01-22T19:17:03.640Z myclusterparametergroup Cluster parameter group myclusterparametergroup has been created. cluster-parameter-group RESPONSEMETADATA 8e5fe765-64c9-11e2-bce3-e56f52c50e17
  • Para obtener más información sobre la API, consulte DescribeEventsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-hsm-client-certificates.

AWS CLI

Para describir los certificados de cliente HSM

En el siguiente ejemplo de describe-hsm-client-certificates, se muestran los detalles del certificado de cliente HSM especificado.

aws redshift describe-hsm-client-certificates \ --hsm-client-certificate-identifier myhsmclientcert

Salida:

{ "HsmClientCertificates": [ { "HsmClientCertificateIdentifier": "myhsmclientcert", "HsmClientCertificatePublicKey": "-----BEGIN CERTIFICATE-----\ EXAMPLECAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAEXAMPLERAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zEXAMPLEwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhEXAMPLEDI1MjA0EXAMPLEN EXAMPLE0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGEXAMPLEQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsEXAMPLEdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIEXAMPLEMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY67EXAMPLEE EXAMPLEZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9EXAMPLE6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDEXAMPLEBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rEXAMPLE=-----END CERTIFICATE-----\n", "Tags": [] } ] }

Para obtener más información, consulte Amazon Redshift API Permissions Reference en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-hsm-configurations.

AWS CLI

Para describir las configuraciones de HSM

En el siguiente describe-hsm-configurations ejemplo, se muestran los detalles de las configuraciones de HSM disponibles para la AWS cuenta que realiza la llamada.

aws redshift describe-hsm-configurations / --hsm-configuration-identifier myhsmconnection

Salida:

{ "HsmConfigurations": [ { "HsmConfigurationIdentifier": "myhsmconnection", "Description": "My HSM connection", "HsmIpAddress": "192.0.2.09", "HsmPartitionName": "myhsmpartition", "Tags": [] } ] }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-logging-status.

AWS CLI

Para describir el estado de registro de un clúster

El siguiente ejemplo de describe-logging-status muestra si se está registrando información, como consultas e intentos de conexión, para un clúster.

aws redshift describe-logging-status \ --cluster-identifier mycluster

Salida:

{ "LoggingEnabled": false }

Para obtener más información, consulte Registro de auditoría de bases de datos en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte DescribeLoggingStatusla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-node-configuration-options.

AWS CLI

Para describir las opciones de configuración de nodos

El siguiente ejemplo de describe-node-configuration-options muestra las propiedades de las posibles configuraciones nodos, como por tipo de nodo, número de nodos y el uso del disco para la instantánea del clúster especificada.

aws redshift describe-node-configuration-options \ --action-type restore-cluster \ --snapshot-identifier rs:mycluster-2019-12-09-16-42-43

Salida:

{ "NodeConfigurationOptionList": [ { "NodeType": "dc2.large", "NumberOfNodes": 2, "EstimatedDiskUtilizationPercent": 19.61 }, { "NodeType": "dc2.large", "NumberOfNodes": 4, "EstimatedDiskUtilizationPercent": 9.96 }, { "NodeType": "ds2.xlarge", "NumberOfNodes": 2, "EstimatedDiskUtilizationPercent": 1.53 }, { "NodeType": "ds2.xlarge", "NumberOfNodes": 4, "EstimatedDiskUtilizationPercent": 0.78 } ] }

Para obtener más información, consulte Adquisición de nodos reservados de Amazon Redshift en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-orderable-cluster-options.

AWS CLI

El OptionsThis ejemplo Describir todos los clústeres ordenables devuelve descripciones de todas las opciones de clústeres ordenables. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift describe-orderable-cluster-options

Resultado:

{ "OrderableClusterOptions": [ { "NodeType": "dw.hs1.8xlarge", "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" } ], "ClusterVersion": "1.0", "ClusterType": "multi-node" }, { "NodeType": "dw.hs1.xlarge", "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" } ], "ClusterVersion": "1.0", "ClusterType": "multi-node" }, { "NodeType": "dw.hs1.xlarge", "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" } ], "ClusterVersion": "1.0", "ClusterType": "single-node" } ], "ResponseMetadata": { "RequestId": "f6000035-64cb-11e2-9135-ff82df53a51a" } }

También puede obtener la misma información en formato de texto mediante la opción --output text. Comando:

--output text option.Command:

option.Command:

aws redshift describe-orderable-cluster-options --output text

Resultado:

dw.hs1.8xlarge 1.0 multi-node us-east-1a us-east-1b us-east-1c dw.hs1.xlarge 1.0 multi-node us-east-1a us-east-1b us-east-1c dw.hs1.xlarge 1.0 single-node us-east-1a us-east-1b us-east-1c RESPONSEMETADATA e648696b-64cb-11e2-bec0-17624ad140dd

En el siguiente ejemplo de código, se muestra cómo utilizar describe-reserved-node-offerings.

AWS CLI

El OfferingsThis ejemplo Describe un nodo reservado muestra todas las ofertas de nodos reservados que están disponibles para su compra. Comando:

aws redshift describe-reserved-node-offerings

Resultado:

{ "ReservedNodeOfferings": [ { "OfferingType": "Heavy Utilization", "FixedPrice": "", "NodeType": "dw.hs1.xlarge", "UsagePrice": "", "RecurringCharges": [ { "RecurringChargeAmount": "", "RecurringChargeFrequency": "Hourly" } ], "Duration": 31536000, "ReservedNodeOfferingId": "ceb6a579-cf4c-4343-be8b-d832c45ab51c" }, { "OfferingType": "Heavy Utilization", "FixedPrice": "", "NodeType": "dw.hs1.8xlarge", "UsagePrice": "", "RecurringCharges": [ { "RecurringChargeAmount": "", "RecurringChargeFrequency": "Hourly" } ], "Duration": 31536000, "ReservedNodeOfferingId": "e5a2ff3b-352d-4a9c-ad7d-373c4cab5dd2" }, ...remaining output omitted... ], "ResponseMetadata": { "RequestId": "8b1a1a43-75ff-11e2-9666-e142fe91ddd1" } }

Si desea comprar una oferta de nodo reservado, puede llamar purchase-reserved-node-offering utilizando una oferta válida. ReservedNodeOfferingId

purchase-reserved-node-offeringutilizando una válida ReservedNodeOfferingId.

utilizando un válido ReservedNodeOfferingId.

ReservedNodeOfferingId.

.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-reserved-nodes.

AWS CLI

El NodesThis ejemplo Describe Reserved muestra una oferta de nodo reservado que se ha comprado. Comando:

aws redshift describe-reserved-nodes

Resultado:

{ "ResponseMetadata": { "RequestId": "bc29ce2e-7600-11e2-9949-4b361e7420b7" }, "ReservedNodes": [ { "OfferingType": "Heavy Utilization", "FixedPrice": "", "NodeType": "dw.hs1.xlarge", "ReservedNodeId": "1ba8e2e3-bc01-4d65-b35d-a4a3e931547e", "UsagePrice": "", "RecurringCharges": [ { "RecurringChargeAmount": "", "RecurringChargeFrequency": "Hourly" } ], "NodeCount": 1, "State": "payment-pending", "StartTime": "2013-02-13T17:08:39.051Z", "Duration": 31536000, "ReservedNodeOfferingId": "ceb6a579-cf4c-4343-be8b-d832c45ab51c" } ] }
  • Para obtener más información sobre la API, consulte DescribeReservedNodesla Referencia de comandos.AWS CLI

En el siguiente ejemplo de código, se muestra cómo utilizar describe-resize.

AWS CLI

El ResizeThis ejemplo Describe describe el último cambio de tamaño de un clúster. La solicitud era para tres nodos del tipo dw.hs1.8xlarge. Comando:

aws redshift describe-resize --cluster-identifier mycluster

Resultado:

{ "Status": "NONE", "TargetClusterType": "multi-node", "TargetNodeType": "dw.hs1.8xlarge", "ResponseMetadata": { "RequestId": "9f52b0b4-7733-11e2-aa9b-318b2909bd27" }, "TargetNumberOfNodes": "3" }
  • Para obtener información sobre la API, consulte DescribeResizela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-scheduled-actions.

AWS CLI

Para describir acciones programadas

En el siguiente ejemplo de describe-scheduled-actions, se muestran los detalles de las acciones programadas actualmente.

aws redshift describe-scheduled-actions

Salida:

{ "ScheduledActions": [ { "ScheduledActionName": "resizecluster", "TargetAction": { "ResizeCluster": { "ClusterIdentifier": "mycluster", "NumberOfNodes": 4, "Classic": false } }, "Schedule": "at(2019-12-10T00:07:00)", "IamRole": "arn:aws:iam::123456789012:role/myRedshiftRole", "State": "ACTIVE", "NextInvocations": [ "2019-12-10T00:07:00Z" ] } ] }

En el siguiente ejemplo de código, se muestra cómo utilizar describe-snapshot-copy-grants.

AWS CLI

Para describir concesiones de copia de instantánea

En el siguiente ejemplo de describe-snapshot-copy-grants, se muestran los detalles de la concesión de copia de instantáneas del clúster especificada.

aws redshift describe-snapshot-copy-grants \ --snapshot-copy-grant-name mysnapshotcopygrantname

Salida:

{ "SnapshotCopyGrants": [ { "SnapshotCopyGrantName": "mysnapshotcopygrantname", "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY", "Tags": [] } ] }

Para obtener más información, consulte Cifrado de la base de datos de Amazon Redshift en la Guía de administración de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-snapshot-schedules.

AWS CLI

Para describir las programaciones de instantáneas

En el siguiente ejemplo de describe-snapshot-schedules, se muestran los detalles de la programación de instantáneas del clúster especificada.

aws redshift describe-snapshot-schedules \ --cluster-identifier mycluster \ --schedule-identifier mysnapshotschedule

Salida:

{ "SnapshotSchedules": [ { "ScheduleDefinitions": [ "rate(12 hours)" ], "ScheduleIdentifier": "mysnapshotschedule", "ScheduleDescription": "My schedule description", "Tags": [], "AssociatedClusterCount": 1, "AssociatedClusters": [ { "ClusterIdentifier": "mycluster", "ScheduleAssociationState": "ACTIVE" } ] } ] }

Para obtener más información, consulte Programación de instantáneas automatizadas en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-storage.

AWS CLI

Para describir el almacenamiento

En el siguiente ejemplo de describe-storage, se muestran detalles sobre el almacenamiento de copias de seguridad y sobre los tamaños de almacenamiento provisional de la cuenta.

aws redshift describe-storage

Salida:

{ "TotalBackupSizeInMegaBytes": 193149.0, "TotalProvisionedStorageInMegaBytes": 655360.0 }

Para obtener más información, consulte Managing Snapshot Storage en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte DescribeStoragela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-table-restore-status.

AWS CLI

Para describir el estado de las solicitudes de restauración de tablas desde una instantánea del clúster

En el siguiente ejemplo de describe-table-restore-status, se muestran los detalles de las solicitudes de restauración de tablas realizadas para el clúster especificado.

aws redshift describe-table-restore-status / --cluster-identifier mycluster

Salida:

{ "TableRestoreStatusDetails": [ { "TableRestoreRequestId": "z1116630-0e80-46f4-ba86-bd9670411ebd", "Status": "IN_PROGRESS", "RequestTime": "2019-12-27T18:22:12.257Z", "ClusterIdentifier": "mycluster", "SnapshotIdentifier": "mysnapshotid", "SourceDatabaseName": "dev", "SourceSchemaName": "public", "SourceTableName": "mytable", "TargetDatabaseName": "dev", "TargetSchemaName": "public", "NewTableName": "mytable-clone" } ] }

Para obtener más información, consulte Restauración de una tabla a partir de una instantánea en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-tags.

AWS CLI

Para describir las etiquetas

En el siguiente ejemplo de describe-tags, se muestran los recursos que el clúster especificado asoció a los nombres y valores de las etiquetas especificadas.

aws redshift describe-tags \ --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \ --tag-keys clustertagkey \ --tag-values clustertagvalue

Salida:

{ "TaggedResources": [ { "Tag": { "Key": "clustertagkey", "Value": "clustertagvalue" }, "ResourceName": "arn:aws:redshift:us-west-2:123456789012:cluster:mycluster", "ResourceType": "cluster" } ] }

Para obtener más información, consulte Etiquetado de recursos en Amazon Redshift en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte DescribeTagsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar disable-snapshot-copy.

AWS CLI

Para deshabilitar la copia de una instantánea para un clúster

En el siguiente ejemplo de disable-snapshot-copy, se deshabilita la copia automática de una instantánea para el clúster especificado.

aws redshift disable-snapshot-copy \ --cluster-identifier mycluster

Salida:

{ "Cluster": { "ClusterIdentifier": "mycluster", "NodeType": "dc2.large", "ClusterStatus": "available", "ClusterAvailabilityStatus": "Available", "MasterUsername": "adminuser", "DBName": "dev", "Endpoint": { "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com", "Port": 5439 }, "ClusterCreateTime": "2019-12-05T18:44:36.991Z", "AutomatedSnapshotRetentionPeriod": 3, "ManualSnapshotRetentionPeriod": -1, "ClusterSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sh-i9b431cd", "Status": "active" } ], "ClusterParameterGroups": [ { "ParameterGroupName": "default.redshift-1.0", "ParameterApplyStatus": "in-sync" } ], "ClusterSubnetGroupName": "default", "VpcId": "vpc-b1fel7t9", "AvailabilityZone": "us-west-2f", "PreferredMaintenanceWindow": "sat:16:00-sat:16:30", "PendingModifiedValues": { "NodeType": "dc2.large", "NumberOfNodes": 2, "ClusterType": "multi-node" }, "ClusterVersion": "1.0", "AllowVersionUpgrade": true, "NumberOfNodes": 4, "PubliclyAccessible": false, "Encrypted": false, "Tags": [ { "Key": "mytags", "Value": "tag1" } ], "EnhancedVpcRouting": false, "IamRoles": [ { "IamRoleArn": "arn:aws:iam::123456789012:role/myRedshiftRole", "ApplyStatus": "in-sync" } ], "MaintenanceTrackName": "current", "DeferredMaintenanceWindows": [], "ExpectedNextSnapshotScheduleTime": "2019-12-10T04:42:43.390Z", "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack", "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z" } }

Para obtener más información, consulte Copiar instantáneas a otra AWS región en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte la Referencia DisableSnapshotCopyde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar enable-snapshot-copy.

AWS CLI

Para habilitar la copia de una instantánea para un clúster

En el siguiente ejemplo de enable-snapshot-copy, se habilita la copia automática de una instantánea para el clúster especificado.

aws redshift enable-snapshot-copy \ --cluster-identifier mycluster \ --destination-region us-west-1

Salida:

{ "Cluster": { "ClusterIdentifier": "mycluster", "NodeType": "dc2.large", "ClusterStatus": "available", "ClusterAvailabilityStatus": "Available", "MasterUsername": "adminuser", "DBName": "dev", "Endpoint": { "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com", "Port": 5439 }, "ClusterCreateTime": "2019-12-05T18:44:36.991Z", "AutomatedSnapshotRetentionPeriod": 3, "ManualSnapshotRetentionPeriod": -1, "ClusterSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sh-f4c731cd", "Status": "active" } ], "ClusterParameterGroups": [ { "ParameterGroupName": "default.redshift-1.0", "ParameterApplyStatus": "in-sync" } ], "ClusterSubnetGroupName": "default", "VpcId": "vpc-b1ael7t9", "AvailabilityZone": "us-west-2f", "PreferredMaintenanceWindow": "sat:16:00-sat:16:30", "PendingModifiedValues": { "NodeType": "dc2.large", "NumberOfNodes": 2, "ClusterType": "multi-node" }, "ClusterVersion": "1.0", "AllowVersionUpgrade": true, "NumberOfNodes": 4, "PubliclyAccessible": false, "Encrypted": false, "ClusterSnapshotCopyStatus": { "DestinationRegion": "us-west-1", "RetentionPeriod": 7, "ManualSnapshotRetentionPeriod": -1 }, "Tags": [ { "Key": "mytags", "Value": "tag1" } ], "EnhancedVpcRouting": false, "IamRoles": [ { "IamRoleArn": "arn:aws:iam::123456789012:role/myRedshiftRole", "ApplyStatus": "in-sync" } ], "MaintenanceTrackName": "current", "DeferredMaintenanceWindows": [], "ExpectedNextSnapshotScheduleTime": "2019-12-10T04:42:43.390Z", "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack", "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z" } }

Para obtener más información, consulte Copiar instantáneas a otra AWS región en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte la Referencia EnableSnapshotCopyde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-cluster-credentials.

AWS CLI

Para obtener las credenciales de clúster de una AWS cuenta

El siguiente ejem plo de get-cluster-credentials recupera las credenciales temporales que permiten acceder a una base de datos de Amazon Redshift.

aws redshift get-cluster-credentials \ --db-user adminuser --db-name dev \ --cluster-identifier mycluster

Salida:

{ "DbUser": "IAM:adminuser", "DbPassword": "AMAFUyyuros/QjxPTtgzcsuQsqzIasdzJEN04aCtWDzXx1O9d6UmpkBtvEeqFly/EXAMPLE==", "Expiration": "2019-12-10T17:25:05.770Z" }

Para obtener más información, consulte Generación de credenciales de base de datos para una identidad de IAM mediante la CLI o la API de Amazon Redshift en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener información sobre la API, consulte GetClusterCredentialsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-reserved-node-exchange-offerings.

AWS CLI

Para obtener ofertas de intercambio de nodos reservados

El siguiente ejemplo de get-reserved-node-exchange-offerings recupera una matriz de DC2 ReservedNodeOfferings que coincide con el nodo reservado DC1 especificado.

aws redshift get-reserved-node-exchange-offerings \ --reserved-node-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE

Salida:

{ "ReservedNodeOfferings": [ { "ReservedNodeOfferingId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE", "NodeType": "dc2.large", "Duration": 31536000, "FixedPrice": 0.0, "UsagePrice": 0.0, "CurrencyCode": "USD", "OfferingType": "All Upfront", "RecurringCharges": [ { "RecurringChargeAmount": 0.0, "RecurringChargeFrequency": "Hourly" } ], "ReservedNodeOfferingType": "Regular" } ] }

Para obtener más información, consulte Actualización de nodos reservados con la AWS CLI en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-cluster-iam-roles.

AWS CLI

Para modificar el rol de IAM de un clúster

En el siguiente modify-cluster-iam-roles ejemplo, se elimina la función de AWS IAM especificada del clúster especificado.

aws redshift modify-cluster-iam-roles \ --cluster-identifier mycluster \ --remove-iam-roles arn:aws:iam::123456789012:role/myRedshiftRole

Salida:

{ "Cluster": { "ClusterIdentifier": "mycluster", "NodeType": "dc2.large", "ClusterStatus": "available", "ClusterAvailabilityStatus": "Available", "MasterUsername": "adminuser", "DBName": "dev", "Endpoint": { "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com", "Port": 5439 }, "ClusterCreateTime": "2019-12-05T18:44:36.991Z", "AutomatedSnapshotRetentionPeriod": 3, "ManualSnapshotRetentionPeriod": -1, "ClusterSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sh-f9b731sd", "Status": "active" } ], "ClusterParameterGroups": [ { "ParameterGroupName": "default.redshift-1.0", "ParameterApplyStatus": "in-sync" } ], "ClusterSubnetGroupName": "default", "VpcId": "vpc-b2fal7t9", "AvailabilityZone": "us-west-2f", "PreferredMaintenanceWindow": "sat:16:00-sat:16:30", "PendingModifiedValues": { "NodeType": "dc2.large", "NumberOfNodes": 2, "ClusterType": "multi-node" }, "ClusterVersion": "1.0", "AllowVersionUpgrade": true, "NumberOfNodes": 4, "PubliclyAccessible": false, "Encrypted": false, "ClusterSnapshotCopyStatus": { "DestinationRegion": "us-west-1", "RetentionPeriod": 7, "ManualSnapshotRetentionPeriod": -1 }, "Tags": [ { "Key": "mytags", "Value": "tag1" } ], "EnhancedVpcRouting": false, "IamRoles": [], "MaintenanceTrackName": "current", "DeferredMaintenanceWindows": [], "ExpectedNextSnapshotScheduleTime": "2019-12-11T04:42:55.631Z", "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack", "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z" } }

Para obtener más información, consulte Uso de políticas basadas en identidad (políticas de IAM) para Amazon Redshift en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte ModifyClusterIamRolesla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-cluster-maintenance.

AWS CLI

Para modificar el mantenimiento del clúster

El siguiente ejemplo de modify-cluster-maintenance aplaza 30 días el mantenimiento del clúster especificado durante 30 días.

aws redshift modify-cluster-maintenance \ --cluster-identifier mycluster \ --defer-maintenance \ --defer-maintenance-duration 30

Salida:

{ "Cluster": { "ClusterIdentifier": "mycluster", "NodeType": "dc2.large", "ClusterStatus": "available", "ClusterAvailabilityStatus": "Available", "MasterUsername": "adminuser", "DBName": "dev", "Endpoint": { "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com", "Port": 5439 }, "ClusterCreateTime": "2019-12-05T18:44:36.991Z", "AutomatedSnapshotRetentionPeriod": 3, "ManualSnapshotRetentionPeriod": -1, "ClusterSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sh-a1a123ab", "Status": "active" } ], "ClusterParameterGroups": [ { "ParameterGroupName": "default.redshift-1.0", "ParameterApplyStatus": "in-sync" } ], "ClusterSubnetGroupName": "default", "VpcId": "vpc-b1ael7t9", "AvailabilityZone": "us-west-2f", "PreferredMaintenanceWindow": "sat:16:00-sat:16:30", "PendingModifiedValues": { "NodeType": "dc2.large", "NumberOfNodes": 2, "ClusterType": "multi-node" }, "ClusterVersion": "1.0", "AllowVersionUpgrade": true, "NumberOfNodes": 4, "PubliclyAccessible": false, "Encrypted": false, "ClusterSnapshotCopyStatus": { "DestinationRegion": "us-west-1", "RetentionPeriod": 7, "ManualSnapshotRetentionPeriod": -1 }, "Tags": [ { "Key": "mytags", "Value": "tag1" } ], "EnhancedVpcRouting": false, "IamRoles": [], "MaintenanceTrackName": "current", "DeferredMaintenanceWindows": [ { "DeferMaintenanceIdentifier": "dfm-mUdVIfFcT1B4SGhw6fyF", "DeferMaintenanceStartTime": "2019-12-10T18:18:39.354Z", "DeferMaintenanceEndTime": "2020-01-09T18:18:39.354Z" } ], "ExpectedNextSnapshotScheduleTime": "2019-12-11T04:42:55.631Z", "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack", "NextMaintenanceWindowStartTime": "2020-01-11T16:00:00Z" } }

Para obtener más información, consulte Mantenimiento de clústeres en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-cluster-parameter-group.

AWS CLI

Modificar un parámetro en un grupo de parámetros

El siguiente ejemplo de modify-cluster-parameter-group modifica el parámetro wlm_json_configuration para la administración de la carga de trabajo. Acepta los parámetros de un archivo que contiene el contenido JSON que se muestra a continuación.

aws redshift modify-cluster-parameter-group \ --parameter-group-name myclusterparametergroup \ --parameters file://modify_pg.json

Contenido de modify_pg.json:

[ { "ParameterName": "wlm_json_configuration", "ParameterValue": "[{\"user_group\":\"example_user_group1\",\"query_group\": \"example_query_group1\", \"query_concurrency\":7},{\"query_concurrency\":5}]" } ]

Salida:

{ "ParameterGroupStatus": "Your parameter group has been updated but changes won't get applied until you reboot the associated Clusters.", "ParameterGroupName": "myclusterparametergroup", "ResponseMetadata": { "RequestId": "09974cc0-64cd-11e2-bea9-49e0ce183f07" } }

En el siguiente ejemplo de código, se muestra cómo utilizar modify-cluster-snapshot-schedule.

AWS CLI

Para modificar la programación de instantáneas del clúster

El siguiente ejemplo de modify-cluster-snapshot-schedule elimina la programación de instantánea especificada desde el clúster especificado.

aws redshift modify-cluster-snapshot-schedule \ --cluster-identifier mycluster \ --schedule-identifier mysnapshotschedule \ --disassociate-schedule

Este comando no produce ninguna salida.

Para obtener más información, consulte Programación de instantáneas automatizadas en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-cluster-snapshot.

AWS CLI

Para modificar la instantánea del clúster

El siguiente ejemplo de modify-cluster-snapshot establece la configuración del período de retención manual para la instantánea del clúster especificado en un valor de 10 días.

aws redshift modify-cluster-snapshot \ --snapshot-identifier mycluster-2019-11-06-16-32 \ --manual-snapshot-retention-period 10

Salida:

{ "Snapshot": { "SnapshotIdentifier": "mycluster-2019-11-06-16-32", "ClusterIdentifier": "mycluster", "SnapshotCreateTime": "2019-12-07T00:34:05.633Z", "Status": "available", "Port": 5439, "AvailabilityZone": "us-west-2f", "ClusterCreateTime": "2019-12-05T18:44:36.991Z", "MasterUsername": "adminuser", "ClusterVersion": "1.0", "SnapshotType": "manual", "NodeType": "dc2.large", "NumberOfNodes": 2, "DBName": "dev", "VpcId": "vpc-b1cel7t9", "Encrypted": false, "EncryptedWithHSM": false, "OwnerAccount": "123456789012", "TotalBackupSizeInMegaBytes": 64384.0, "ActualIncrementalBackupSizeInMegaBytes": 24.0, "BackupProgressInMegaBytes": 24.0, "CurrentBackupRateInMegaBytesPerSecond": 13.0011, "EstimatedSecondsToCompletion": 0, "ElapsedTimeInSeconds": 1, "Tags": [ { "Key": "mytagkey", "Value": "mytagvalue" } ], "EnhancedVpcRouting": false, "MaintenanceTrackName": "current", "ManualSnapshotRetentionPeriod": 10, "ManualSnapshotRemainingDays": 6, "SnapshotRetentionStartTime": "2019-12-07T00:34:07.479Z" } }

Para obtener más información, consulte Amazon Redshift Snapshots en la Guía de administración de clúster de Amazon Redshift.

  • Para obtener más información sobre la API, consulte ModifyClusterSnapshotla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-cluster-subnet-group.

AWS CLI

En el GroupThis ejemplo de modificación de las subredes de un clúster, se muestra cómo modificar la lista de subredes de un grupo de subredes de caché. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift modify-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup --subnet-ids subnet-763fdd1 subnet-ac830e9

Resultado:

{ "ClusterSubnetGroup": { "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-763fdd1c", "SubnetAvailabilityZone": { "Name": "us-east-1a" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-ac830e9", "SubnetAvailabilityZone": { "Name": "us-east-1b" } } ], "VpcId": "vpc-7e3fdd14", "SubnetGroupStatus": "Complete", "Description": "My subnet group", "ClusterSubnetGroupName": "mysubnetgroup" }, "ResponseMetadata": { "RequestId": "8da93e89-8372-f936-93a8-873918938197a" } }

En el siguiente ejemplo de código, se muestra cómo utilizar modify-cluster.

AWS CLI

Asociar un grupo de seguridad a un ClusterThis ejemplo muestra cómo asociar un grupo de seguridad de clúster al clúster especificado.Comando:

aws redshift modify-cluster --cluster-identifier mycluster --cluster-security-groups mysecuritygroup

Modificar el período de mantenimiento por a ClusterThis muestra cómo cambiar el período de mantenimiento semanal preferido para un clúster para que sea el período mínimo de cuatro horas, que comienza los domingos a las 23:15 horas y termina los lunes a las 3:15 a.m. Comando:

aws redshift modify-cluster --cluster-identifier mycluster --preferred-maintenance-window Sun:23:15-Mon:03:15

Cambiar la contraseña maestra del ClusterThis ejemplo muestra cómo cambiar la contraseña maestra de un cluster.Comando:

aws redshift modify-cluster --cluster-identifier mycluster --master-user-password A1b2c3d4
  • Para obtener más información sobre la API, consulte la Referencia de ModifyClustercomandos AWS CLI .

En el siguiente ejemplo de código, se muestra cómo utilizar modify-event-subscription.

AWS CLI

Para modificar la suscripción a un evento

En el siguiente ejemplo de modify-event-subscription se deshabilita la suscripción a una notificación de evento especificada.

aws redshift modify-event-subscription \ --subscription-name mysubscription \ --no-enabled

Salida:

{ "EventSubscription": { "CustomerAwsId": "123456789012", "CustSubscriptionId": "mysubscription", "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic", "Status": "active", "SubscriptionCreationTime": "2019-12-09T21:50:21.332Z", "SourceIdsList": [], "EventCategoriesList": [ "management" ], "Severity": "ERROR", "Enabled": false, "Tags": [] } }

Para obtener más información, consulte Subscribing to Amazon Redshift Event Notifications en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-scheduled-action.

AWS CLI

Para modificar una acción programada

En el siguiente ejemplo de modify-scheduled-action, se agrega una descripción a la acción programada existente especificada.

aws redshift modify-scheduled-action \ --scheduled-action-name myscheduledaction \ --scheduled-action-description "My scheduled action"

Salida:

{ "ScheduledActionName": "myscheduledaction", "TargetAction": { "ResizeCluster": { "ClusterIdentifier": "mycluster", "NumberOfNodes": 2, "Classic": false } }, "Schedule": "at(2019-12-25T00:00:00)", "IamRole": "arn:aws:iam::123456789012:role/myRedshiftRole", "ScheduledActionDescription": "My scheduled action", "State": "ACTIVE", "NextInvocations": [ "2019-12-25T00:00:00Z" ] }
  • Para obtener más información sobre la API, consulte ModifyScheduledActionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-snapshot-copy-retention-period.

AWS CLI

Para modificar el período de retención de la copia de una instantánea

El siguiente modify-snapshot-copy-retention-period ejemplo modifica el número de días para conservar las instantáneas del clúster especificado en la AWS región de destino después de copiarlas de la región de origen AWS .

aws redshift modify-snapshot-copy-retention-period \ --cluster-identifier mycluster \ --retention-period 15

Salida:

{ "Cluster": { "ClusterIdentifier": "mycluster", "NodeType": "dc2.large", "ClusterStatus": "available", "ClusterAvailabilityStatus": "Available", "MasterUsername": "adminuser", "DBName": "dev", "Endpoint": { "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com", "Port": 5439 }, "ClusterCreateTime": "2019-12-05T18:44:36.991Z", "AutomatedSnapshotRetentionPeriod": 3, "ManualSnapshotRetentionPeriod": -1, "ClusterSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sh-a1a123ab", "Status": "active" } ], "ClusterParameterGroups": [ { "ParameterGroupName": "default.redshift-1.0", "ParameterApplyStatus": "in-sync" } ], "ClusterSubnetGroupName": "default", "VpcId": "vpc-b1fet7t9", "AvailabilityZone": "us-west-2f", "PreferredMaintenanceWindow": "sat:16:00-sat:16:30", "PendingModifiedValues": { "NodeType": "dc2.large", "NumberOfNodes": 2, "ClusterType": "multi-node" }, "ClusterVersion": "1.0", "AllowVersionUpgrade": true, "NumberOfNodes": 4, "PubliclyAccessible": false, "Encrypted": false, "ClusterSnapshotCopyStatus": { "DestinationRegion": "us-west-1", "RetentionPeriod": 15, "ManualSnapshotRetentionPeriod": -1 }, "Tags": [ { "Key": "mytags", "Value": "tag1" } ], "EnhancedVpcRouting": false, "IamRoles": [], "MaintenanceTrackName": "current", "DeferredMaintenanceWindows": [ { "DeferMaintenanceIdentifier": "dfm-mUdVSfDcT1F4SGhw6fyF", "DeferMaintenanceStartTime": "2019-12-10T18:18:39.354Z", "DeferMaintenanceEndTime": "2020-01-09T18:18:39.354Z" } ], "NextMaintenanceWindowStartTime": "2020-01-11T16:00:00Z" } }

Para obtener más información, consulte Formato de la programación de instantáneas en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar modify-snapshot-schedule.

AWS CLI

Para modificar la programación de instantáneas

En el siguiente ejemplo de modify-snapshot-schedule, se modifica la frecuencia de la programación de instantáneas especificada para que pase a ser cada 10 horas.

aws redshift modify-snapshot-schedule \ --schedule-identifier mysnapshotschedule \ --schedule-definitions "rate(10 hours)"

Salida:

{ "ScheduleDefinitions": [ "rate(10 hours)" ], "ScheduleIdentifier": "mysnapshotschedule", "ScheduleDescription": "My schedule description", "Tags": [] }

Para obtener más información, consulte Formato de la programación de instantáneas en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte ModifySnapshotSchedulela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar purchase-reserved-node-offering.

AWS CLI

El NodeThis ejemplo Comprar un nodo reservado muestra cómo comprar una oferta de nodo reservado. El reserved-node-offering-id se obtiene llamando a describe-reserved-node-offerings. Comando:

aws redshift purchase-reserved-node-offering --reserved-node-offering-id ceb6a579-cf4c-4343-be8b-d832c45ab51c

Resultado:

{ "ReservedNode": { "OfferingType": "Heavy Utilization", "FixedPrice": "", "NodeType": "dw.hs1.xlarge", "ReservedNodeId": "1ba8e2e3-bc01-4d65-b35d-a4a3e931547e", "UsagePrice": "", "RecurringCharges": [ { "RecurringChargeAmount": "", "RecurringChargeFrequency": "Hourly" } ], "NodeCount": 1, "State": "payment-pending", "StartTime": "2013-02-13T17:08:39.051Z", "Duration": 31536000, "ReservedNodeOfferingId": "ceb6a579-cf4c-4343-be8b-d832c45ab51c" }, "ResponseMetadata": { "RequestId": "01bda7bf-7600-11e2-b605-2568d7396e7f" } }

En el siguiente ejemplo de código, se muestra cómo utilizar reboot-cluster.

AWS CLI

Reiniciar un ClusterThis ejemplo reinicia un clúster. De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift reboot-cluster --cluster-identifier mycluster

Resultado:

{ "Cluster": { "NodeType": "dw.hs1.xlarge", "Endpoint": { "Port": 5439, "Address": "mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com" }, "ClusterVersion": "1.0", "PubliclyAccessible": "true", "MasterUsername": "adminuser", "ClusterParameterGroups": [ { "ParameterApplyStatus": "in-sync", "ParameterGroupName": "default.redshift-1.0" } ], "ClusterSecurityGroups": [ { "Status": "active", "ClusterSecurityGroupName": "default" } ], "AllowVersionUpgrade": true, "VpcSecurityGroups": \[], "AvailabilityZone": "us-east-1a", "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "PreferredMaintenanceWindow": "sun:23:15-mon:03:15", "AutomatedSnapshotRetentionPeriod": 1, "ClusterStatus": "rebooting", "ClusterIdentifier": "mycluster", "DBName": "dev", "NumberOfNodes": 2, "PendingModifiedValues": {} }, "ResponseMetadata": { "RequestId": "61c8b564-64e8-11e2-8f7d-3b939af52818" } }
  • Para obtener información sobre la API, consulte RebootClusterla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar reset-cluster-parameter-group.

AWS CLI

El GroupThis ejemplo de restablecer los parámetros en un parámetro muestra cómo restablecer todos los parámetros de un grupo de parámetros.Comando:

aws redshift reset-cluster-parameter-group --parameter-group-name myclusterparametergroup --reset-all-parameters

En el siguiente ejemplo de código, se muestra cómo utilizar resize-cluster.

AWS CLI

Para redimensionar un clúster

El siguiente ejemplo de resize-cluster redimensiona el clúster especificado.

aws redshift resize-cluster \ --cluster-identifier mycluster \ --cluster-type multi-node \ --node-type dc2.large \ --number-of-nodes 6 \ --classic

Salida:

{ "Cluster": { "ClusterIdentifier": "mycluster", "NodeType": "dc2.large", "ClusterStatus": "resizing", "ClusterAvailabilityStatus": "Modifying", "MasterUsername": "adminuser", "DBName": "dev", "Endpoint": { "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com", "Port": 5439 }, "ClusterCreateTime": "2019-12-05T18:44:36.991Z", "AutomatedSnapshotRetentionPeriod": 3, "ManualSnapshotRetentionPeriod": -1, "ClusterSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sh-a1a123ab", "Status": "active" } ], "ClusterParameterGroups": [ { "ParameterGroupName": "default.redshift-1.0", "ParameterApplyStatus": "in-sync" } ], "ClusterSubnetGroupName": "default", "VpcId": "vpc-a1abc1a1", "AvailabilityZone": "us-west-2f", "PreferredMaintenanceWindow": "sat:16:00-sat:16:30", "PendingModifiedValues": { "NodeType": "dc2.large", "NumberOfNodes": 6, "ClusterType": "multi-node" }, "ClusterVersion": "1.0", "AllowVersionUpgrade": true, "NumberOfNodes": 4, "PubliclyAccessible": false, "Encrypted": false, "ClusterSnapshotCopyStatus": { "DestinationRegion": "us-west-1", "RetentionPeriod": 15, "ManualSnapshotRetentionPeriod": -1 }, "Tags": [ { "Key": "mytags", "Value": "tag1" } ], "EnhancedVpcRouting": false, "IamRoles": [], "MaintenanceTrackName": "current", "DeferredMaintenanceWindows": [ { "DeferMaintenanceIdentifier": "dfm-mUdVCfDcT1B4SGhw6fyF", "DeferMaintenanceStartTime": "2019-12-10T18:18:39.354Z", "DeferMaintenanceEndTime": "2020-01-09T18:18:39.354Z" } ], "NextMaintenanceWindowStartTime": "2020-01-11T16:00:00Z", "ResizeInfo": { "ResizeType": "ClassicResize", "AllowCancelResize": true } } }

Para obtener más información, consulte Redimensionamiento de un clúster en la Guía de administración de clústeres de Amazon Redshift.

  • Para obtener más información sobre la API, consulte ResizeClusterla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar restore-from-cluster-snapshot.

AWS CLI

Restaurar un clúster a partir de un SnapshotThis ejemplo restaura un clúster desde una instantánea. Comando:

aws redshift restore-from-cluster-snapshot --cluster-identifier mycluster-clone --snapshot-identifier my-snapshot-id

Resultado:

{ "Cluster": { "NodeType": "dw.hs1.xlarge", "ClusterVersion": "1.0", "PubliclyAccessible": "true", "MasterUsername": "adminuser", "ClusterParameterGroups": [ { "ParameterApplyStatus": "in-sync", "ParameterGroupName": "default.redshift-1.0" } ], "ClusterSecurityGroups": [ { "Status": "active", "ClusterSecurityGroupName": "default" } ], "AllowVersionUpgrade": true, "VpcSecurityGroups": \[], "PreferredMaintenanceWindow": "sun:23:15-mon:03:15", "AutomatedSnapshotRetentionPeriod": 1, "ClusterStatus": "creating", "ClusterIdentifier": "mycluster-clone", "DBName": "dev", "NumberOfNodes": 2, "PendingModifiedValues": {} }, "ResponseMetadata": { "RequestId": "77fd512b-64e3-11e2-8f5b-e90bd6c77476" } }

En el siguiente ejemplo de código, se muestra cómo utilizar restore-table-from-cluster-snapshot.

AWS CLI

Para restaurar una tabla a partir de la instantánea de un clúster

En el siguiente ejemplo de restore-table-from-cluster-snapshot, se crea una tabla nueva a partir de la tabla especificada en la instantánea del clúster especificada.

aws redshift restore-table-from-cluster-snapshot / --cluster-identifier mycluster / --snapshot-identifier mycluster-2019-11-19-16-17 / --source-database-name dev / --source-schema-name public / --source-table-name mytable / --target-database-name dev / --target-schema-name public / --new-table-name mytable-clone

Salida:

{ "TableRestoreStatus": { "TableRestoreRequestId": "a123a12b-abc1-1a1a-a123-a1234ab12345", "Status": "PENDING", "RequestTime": "2019-12-20T00:20:16.402Z", "ClusterIdentifier": "mycluster", "SnapshotIdentifier": "mycluster-2019-11-19-16-17", "SourceDatabaseName": "dev", "SourceSchemaName": "public", "SourceTableName": "mytable", "TargetDatabaseName": "dev", "TargetSchemaName": "public", "NewTableName": "mytable-clone" } }

Para obtener más información, consulte Restauración de una tabla a partir de una instantánea en la Guía de administración de clústeres de Amazon Redshift.

En el siguiente ejemplo de código, se muestra cómo utilizar revoke-cluster-security-group-ingress.

AWS CLI

Revocar el acceso desde un GroupThis ejemplo de EC2 seguridad revoca el acceso a un grupo de EC2 seguridad de Amazon con nombre.Comando:

aws redshift revoke-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --ec2-security-group-name myec2securitygroup --ec2-security-group-owner-id 123445677890

Revocación del acceso a un rango de CIDR. Este ejemplo revoca el acceso a un rango de CIDR. Comando:

aws redshift revoke-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32

En el siguiente ejemplo de código, se muestra cómo utilizar revoke-snapshot-access.

AWS CLI

Revocar la autorización de una AWS cuenta para restaurar un SnapshotThis ejemplo revoca la autorización de la AWS cuenta 444455556666 para restaurar la instantánea. my-snapshot-id De forma predeterminada, el resultado es en formato JSON. Comando:

aws redshift revoke-snapshot-access --snapshot-id my-snapshot-id --account-with-restore-access 444455556666

Resultado:

{ "Snapshot": { "Status": "available", "SnapshotCreateTime": "2013-07-17T22:04:18.947Z", "EstimatedSecondsToCompletion": 0, "AvailabilityZone": "us-east-1a", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "Encrypted": false, "OwnerAccount": "111122223333", "BackupProgressInMegabytes": 11.0, "ElapsedTimeInSeconds": 0, "DBName": "dev", "CurrentBackupRateInMegabytesPerSecond: 0.1534, "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "ActualIncrementalBackupSizeInMegabytes"; 11.0, "SnapshotType": "manual", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "mycluster", "TotalBackupSizeInMegabytes": 20.0, "Port": 5439, "NumberOfNodes": 2, "SnapshotIdentifier": "my-snapshot-id" } }
  • Para obtener más información sobre la API, consulte la Referencia RevokeSnapshotAccessde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar rotate-encryption-key.

AWS CLI

Para rotar la clave de cifrado de un clúster

En el siguiente ejemplo de rotate-encryption-key, se rota la clave de cifrado del clúster especificado.

aws redshift rotate-encryption-key \ --cluster-identifier mycluster

Salida:

{ "Cluster": { "ClusterIdentifier": "mycluster", "NodeType": "dc2.large", "ClusterStatus": "rotating-keys", "ClusterAvailabilityStatus": "Modifying", "MasterUsername": "adminuser", "DBName": "dev", "Endpoint": { "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com", "Port": 5439 }, "ClusterCreateTime": "2019-12-10T19:25:45.886Z", "AutomatedSnapshotRetentionPeriod": 30, "ManualSnapshotRetentionPeriod": -1, "ClusterSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sh-a1a123ab", "Status": "active" } ], "ClusterParameterGroups": [ { "ParameterGroupName": "default.redshift-1.0", "ParameterApplyStatus": "in-sync" } ], "ClusterSubnetGroupName": "default", "VpcId": "vpc-a1abc1a1", "AvailabilityZone": "us-west-2a", "PreferredMaintenanceWindow": "sat:16:00-sat:16:30", "PendingModifiedValues": {}, "ClusterVersion": "1.0", "AllowVersionUpgrade": true, "NumberOfNodes": 2, "PubliclyAccessible": false, "Encrypted": true, "Tags": [], "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY", "EnhancedVpcRouting": false, "IamRoles": [ { "IamRoleArn": "arn:aws:iam::123456789012:role/myRedshiftRole", "ApplyStatus": "in-sync" } ], "MaintenanceTrackName": "current", "DeferredMaintenanceWindows": [], "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z" } }

Para obtener más información, consulte Cifrado de la base de datos de Amazon Redshift en la Guía de administración de Amazon Redshift.

  • Para obtener más información sobre la API, consulte RotateEncryptionKeyla Referencia de AWS CLI comandos.