# Ejemplos de Amazon Redshift que utilizan la AWS CLI
En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con 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.
**Topics**
+ [Acciones](#actions)
## Acciones
### `accept-reserved-node-exchange`
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 ejemplo de `accept-reserved-node-exchange` aceptará el intercambio de un nodo reservado de DC1 por un nodo reservado de DC2.
```
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 [Upgrading Reserved Nodes With the AWS CLI](https://docs.aws.amazon.com/redshift/latest/mgmt/purchase-reserved-node-offering-console.html) en la *Guía de administración del clúster de Amazon Redshift*.
+ Para obtener información sobre la APl, consulte [AcceptReservedNodeExchange](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/accept-reserved-node-exchange.html) en la *Referencia de comandos de la AWS CLI*.
### `authorize-cluster-security-group-ingress`
En el siguiente ejemplo de código, se muestra cómo utilizar `authorize-cluster-security-group-ingress`.
**AWS CLI**
Autorización del acceso a un grupo de seguridad de EC2. Este ejemplo autoriza el acceso a un grupo de seguridad de Amazon EC2. 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
```
+ Para obtener información sobre la API, consulte [AuthorizeClusterSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-cluster-security-group-ingress.html) en la *Referencia de comandos de la AWS CLI*.
### `authorize-snapshot-access`
En el siguiente ejemplo de código, se muestra cómo utilizar `authorize-snapshot-access`.
**AWS CLI**
Autorizar una cuenta de AWS para restaurar una instantánea. Este ejemplo autoriza a la cuenta de AWS `444455556666` a restaurar la instantánea `my-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"
}
}
```
+ Para obtener información sobre la API, consulte [AuthorizeSnapshotAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-snapshot-access.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-delete-cluster-snapshots`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) en la *Guía de administración de clúster de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [BatchDeleteClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-delete-cluster-snapshots.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-modify-cluster-snapshots`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) en la *Guía de administración de clúster de Amazon Redshift*.
+ *Para obtener información sobre la API, consulte [BatchModifyClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-modify-cluster-snapshots.html) en la Referencia de comandos de la AWS CLI*.
### `cancel-resize`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/rs-resize-tutorial.html) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [CancelResize](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/cancel-resize.html) en la *Referencia de comandos de la AWS CLI*.
### `copy-cluster-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `copy-cluster-snapshot`.
**AWS CLI**
Obtener una descripción de todas las versiones del clúster. Este ejemplo proporciona 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 información sobre la API, consulte [AWS CLICopyClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/copy-cluster-snapshot.html) en la Referencia de comandos de la *.
### `create-cluster-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-cluster-parameter-group`.
**AWS CLI**
Crear un grupo de parámetros de clúster. Este ejemplo crea un nuevo grupo de parámetros del 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"
}
}
```
+ Para obtener información sobre la API, consulte [CreateClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-cluster-security-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-cluster-security-group`.
**AWS CLI**
Creación de un grupo de seguridad de clúster. Este ejemplo 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
```
+ Para obtener información sobre la API, consulte [CreateClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-security-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-cluster-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-cluster-snapshot`.
**AWS CLI**
Crea un clúster desde una instantánea. Este ejemplo 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 información sobre la API, consulte [CreateClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `create-cluster-subnet-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-cluster-subnet-group`.
**AWS CLI**
Crear un grupo de subred del clúster. Este ejemplo crea un nuevo grupo de subred del 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"
}
}
```
+ Para obtener información sobre la API, consulte [CreateClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-subnet-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-cluster`.
**AWS CLI**
Crear un clúster con parámetros mínimos En este ejemplo, se crea un clúster con el conjunto mínimo de parámetros. De forma predeterminada, la salida es en JSON format.Command:
```
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 información sobre la API, consulte [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `create-event-subscription`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener detalles sobre la API, consulte [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-event-subscription.html) en la *Referencia de comandos de la AWS CLI*.
### `create-hsm-client-certificate`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [CreateHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-client-certificate.html) en la *Referencia de comandos de la AWS CLI*.
### `create-hsm-configuration`
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 información sobre la API, consulte [CreateHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-configuration.html) en la *Referencia de comandos de la AWS CLI*.
### `create-snapshot-copy-grant`
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 ejemplo de `create-snapshot-copy-grant`, se crea una concesión de copia de instantáneas y cifra las instantáneas copiadas en una región de AWS de destino.
```
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) en la *Guía de administración de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [CreateSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-copy-grant.html) en la *Referencia de comandos de la AWS CLI*.
### `create-snapshot-schedule`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [CreateSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-schedule.html) en la *Referencia de comandos de la AWS CLI*.
### `create-tags`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-tags.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-cluster-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-cluster-parameter-group`.
**AWS CLI**
Eliminar un grupo de parámetros de clúster. Este ejemplo elimina un grupo de parámetros del clúster. Comando:
```
aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup
```
+ Para obtener información sobre la API, consulte [DeleteClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-cluster-security-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-cluster-security-group`.
**AWS CLI**
Eliminar un grupo de seguridad del clúster. Este ejemplo elimina un grupo de seguridad del clúster. Comando:
```
aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup
```
+ Para obtener información sobre la API, consulte [DeleteClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-security-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-cluster-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-cluster-snapshot`.
**AWS CLI**
Eliminación de una instantánea de clúster En este ejemplo se elimina una instantánea de clúster. Comando:
```
aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id
```
+ Para obtener información sobre la API, consulte [DeleteClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-cluster-subnet-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-cluster-subnet-group`.
**AWS CLI**
Eliminar un grupo de subred del clúster. Este ejemplo elimina un grupo de subred del clúster. Comando:
```
aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup
```
Resultado:
```
{
"ResponseMetadata": {
"RequestId": "253fbffd-6993-11e2-bc3a-47431073908a"
}
}
```
+ Para obtener información sobre la API, consulte [DeleteClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-subnet-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-cluster`.
**AWS CLI**
Eliminación de un clúster sin una instantánea final del clúster En este ejemplo, se elimina un clúster y se fuerza la eliminación de los datos, por lo que no se crea una instantánea final del clúster. Comando:
```
aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot
```
Eliminación de un clúster, lo que permite obtener una instantánea final del clúster En este ejemplo se 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 información sobre la API, consulte [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-event-subscription`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-event-subscription.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-hsm-client-certificate`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [DeleteHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-client-certificate.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-hsm-configuration`
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 ejemplo de `delete-hsm-configuration`, se elimina una configuración HSM especificada de la cuenta de AWS especificada.
```
aws redshift delete-hsm-configuration /
--hsm-configuration-identifier myhsmconnection
```
Este comando no produce ninguna salida.
+ Para obtener información sobre la API, consulte [DeleteHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-configuration.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-scheduled-action`
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 información sobre la API, consulte [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-scheduled-action.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-snapshot-copy-grant`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) en la *Guía de administración de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [DeleteSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-copy-grant.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-snapshot-schedule`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [DeleteSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-schedule.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-tags`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-tags.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-account-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-account-attributes`.
**AWS CLI**
**Para describir atributos de una cuenta de AWS**
En el siguiente ejemplo de `describe-account-attributes`, se muestran los atributos asociados a la cuenta de AWS que llama.
```
aws redshift describe-account-attributes
```
Salida:
```
{
"AccountAttributes": [
{
"AttributeName": "max-defer-maintenance-duration",
"AttributeValues": [
{
"AttributeValue": "45"
}
]
}
]
}
```
+ Para obtener información sobre la API, consulte [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-account-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-db-revisions`
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": []
}
]
}
```
+ Para obtener información sobre la API, consulte [DescribeClusterDbRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-db-revisions.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-parameter-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cluster-parameter-groups`.
**AWS CLI**
Obtención de una descripción de todos los grupos de parámetros del clúster. En este ejemplo se devuelve una descripción de todos los grupos de parámetros del clúster, con encabezados de columna. 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
```
+ Para obtener información sobre la API, consulte [DescribeClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameter-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-parameters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cluster-parameters`.
**AWS CLI**
Recupere los parámetros de un grupo de parámetros de clúster especificado. Este ejemplo recupera los parámetros del grupo de parámetros nombrado. 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
```
+ Para obtener información sobre la API, consulte [DescribeClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-security-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cluster-security-groups`.
**AWS CLI**
Obtención de una descripción de todos los grupos de seguridad del clúster. En este ejemplo se proporciona 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...)
]
}
```
+ Para obtener información sobre la API, consulte [DescribeClusterSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-security-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-snapshots`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cluster-snapshots`.
**AWS CLI**
Obtención de una descripción de todas las instantáneas de clúster. En este ejemplo se proporciona una descripción de todas las instantáneas de 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...)
```
+ Para obtener información sobre la API, consulte [DescribeClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-snapshots.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-subnet-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cluster-subnet-groups`.
**AWS CLI**
Obtención de una descripción de todos los grupos de subred del clúster. En este ejemplo se proporciona una descripción de todos los grupos de subred 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"
}
}
```
+ Para obtener información sobre la API, consulte [DescribeClusterSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-subnet-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-tracks`
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](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html#rs-mgmt-maintenance-tracks) en la *Guía de administración de clústeres de Amazon Redshift*.
+ Para obtener información sobre la API, consulte [DescribeClusterTracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-tracks.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cluster-versions`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cluster-versions`.
**AWS CLI**
Obtener una descripción de todas las versiones del clúster. Este ejemplo proporciona 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"
}
}
```
+ Para obtener información sobre la API, consulte [DescribeClusterVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-versions.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-clusters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-clusters`.
**AWS CLI**
Obtención de una descripción de todos los clústeres En este ejemplo se devuelve una descripción de todos los clústeres de la cuenta. De forma predeterminada, la salida es en JSON format.Command:
```
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 información sobre la API, consulte [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-clusters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-default-cluster-parameters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-default-cluster-parameters`.
**AWS CLI**
Obtención de una descripción de los parámetros de clúster predeterminados En este ejemplo se proporciona una descripción de los parámetros de clúster predeterminados de la familia `redshift-1.0`. 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.
+ Para obtener información sobre la API, consulte [DescribeDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-default-cluster-parameters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-event-categories`
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 created at