# Exemplos do Amazon Redshift com o uso da AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Amazon Redshift.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `accept-reserved-node-exchange`
O código de exemplo a seguir mostra como usar `accept-reserved-node-exchange`.
**AWS CLI**
**Para aceitar a troca de nós reservados**
O exemplo `accept-reserved-node-exchange` a seguir aceita a troca de um nó reservado DC1 por um nó reservado 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
```
Resultado:
```
{
"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 obter mais informações, consulte [Atualizar nós reservados com a AWS CLI](https://docs.aws.amazon.com/redshift/latest/mgmt/purchase-reserved-node-offering-console.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [AcceptReservedNodeExchange](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/accept-reserved-node-exchange.html) na *Referência de comandos da AWS CLI*.
### `authorize-cluster-security-group-ingress`
O código de exemplo a seguir mostra como usar `authorize-cluster-security-group-ingress`.
**AWS CLI**
Como autorizar o acesso a um grupo de segurança do EC2. Este exemplo autoriza o acesso a um grupo de segurança nomeado do 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
```
Como autorizar o acesso a um intervalo CIDR. Este exemplo autoriza o acesso a um intervalo CIDR. Comando:
```
aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32
```
+ Para ver detalhes da API, consulte [AuthorizeClusterSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-cluster-security-group-ingress.html) na *Referência de comandos da AWS CLI*.
### `authorize-snapshot-access`
O código de exemplo a seguir mostra como usar `authorize-snapshot-access`.
**AWS CLI**
Autorizar uma AWS conta a restaurar um snapshot. Este exemplo autoriza a AWS conta `444455556666` a restaurar o snapshot `my-snapshot-id`. Por padrão, o formato da saída é 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 ver detalhes da API, consulte [AuthorizeSnapshotAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-snapshot-access.html) na *Referência de comandos da AWS CLI*.
### `batch-delete-cluster-snapshots`
O código de exemplo a seguir mostra como usar `batch-delete-cluster-snapshots`.
**AWS CLI**
**Para excluir um conjunto de snapshots do cluster**
O exemplo `batch-delete-cluster-snapshots` a seguir exclui um conjunto de snapshots manuais do cluster.
```
aws redshift batch-delete-cluster-snapshots \
--identifiers SnapshotIdentifier=mycluster-2019-11-06-14-12 SnapshotIdentifier=mycluster-2019-11-06-14-20
```
Resultado:
```
{
"Resources": [
"mycluster-2019-11-06-14-12",
"mycluster-2019-11-06-14-20"
]
}
```
Para obter mais informações, consulte [Snapshots do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [BatchDeleteClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-delete-cluster-snapshots.html) na *Referência de comandos da AWS CLI*.
### `batch-modify-cluster-snapshots`
O código de exemplo a seguir mostra como usar `batch-modify-cluster-snapshots`.
**AWS CLI**
**Para modificar um conjunto de snapshots do cluster**
O exemplo `batch-modify-cluster-snapshots` a seguir modifica as configurações de um conjunto de snapshots do cluster.
```
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
```
Resultado:
```
{
"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 obter mais informações, consulte [Snapshots do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [BatchModifyClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-modify-cluster-snapshots.html) na *Referência de comandos da AWS CLI*.
### `cancel-resize`
O código de exemplo a seguir mostra como usar `cancel-resize`.
**AWS CLI**
**Para cancelar o redimensionamento de um cluster**
O exemplo `cancel-resize` a seguir cancela uma operação de redimensionamento clássica para um cluster.
```
aws redshift cancel-resize \
--cluster-identifier mycluster
```
Resultado:
```
{
"TargetNodeType": "dc2.large",
"TargetNumberOfNodes": 2,
"TargetClusterType": "multi-node",
"Status": "CANCELLING",
"ResizeType": "ClassicResize",
"TargetEncryptionType": "NONE"
}
```
Para obter mais informações, consulte [Redimensionar clusters do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/rs-resize-tutorial.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [CancelResize](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/cancel-resize.html) na *Referência de comandos da AWS CLI*.
### `copy-cluster-snapshot`
O código de exemplo a seguir mostra como usar `copy-cluster-snapshot`.
**AWS CLI**
Obter uma descrição de todas as versões do cluster. Este exemplo retorna uma descrição de todas as versões do cluster. Por padrão, o formato da saída é 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 ver detalhes da API, consulte [CopyClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/copy-cluster-snapshot.html) na *Referência de comandos da AWS CLI*.
### `create-cluster-parameter-group`
O código de exemplo a seguir mostra como usar `create-cluster-parameter-group`.
**AWS CLI**
Criar um grupo de parâmetros de cluster. Este exemplo cria um novo grupo de parâmetros de cluster. 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 ver detalhes da API, consulte [CreateClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-parameter-group.html) na *Referência de comandos da AWS CLI*.
### `create-cluster-security-group`
O código de exemplo a seguir mostra como usar `create-cluster-security-group`.
**AWS CLI**
Para criar um grupo de segurança do cluster. Este exemplo cria um novo grupo de segurança do cluster. Por padrão, o formato da saída é 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"
}
}
}
```
Você pode obter as mesmas informações em formato de texto com a opção `--output text`. Comando:
opção `--output text`. Comando:
opção. Comando:
```
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 ver detalhes da API, consulte [CreateClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-security-group.html) na *Referência de comandos da AWS CLI*.
### `create-cluster-snapshot`
O código de exemplo a seguir mostra como usar `create-cluster-snapshot`.
**AWS CLI**
Criar um snapshot do cluster. Este exemplo cria um novo snapshot do cluster. Por padrão, o formato da saída é 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 ver detalhes da API, consulte [CreateClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-snapshot.html) na *Referência de comandos da AWS CLI*.
### `create-cluster-subnet-group`
O código de exemplo a seguir mostra como usar `create-cluster-subnet-group`.
**AWS CLI**
Criar um grupo de sub-redes do cluster. Este exemplo cria um novo grupo de sub-redes do cluster. 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 ver detalhes da API, consulte [CreateClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-subnet-group.html) na *Referência de comandos da AWS CLI*.
### `create-cluster`
O código de exemplo a seguir mostra como usar `create-cluster`.
**AWS CLI**
Criar um cluster com parâmetros mínimos Este exemplo cria um cluster com o conjunto mínimo de parâmetros. Por padrão, o formato da saída é 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"
}
}
```
+ Consulte detalhes da API em [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster.html) na *Referência de comandos da AWS CLI*.
### `create-event-subscription`
O código de exemplo a seguir mostra como usar `create-event-subscription`.
**AWS CLI**
**Para criar uma assinatura de notificação para um evento**
O exemplo `create-event-subscription` a seguir cria uma assinatura de notificação de 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
```
Resultado:
```
{
"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 obter mais informações, consulte [Como se inscrever nas notificações de eventos do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-event-subscription.html) na *Referência de comandos da AWS CLI*.
### `create-hsm-client-certificate`
O código de exemplo a seguir mostra como usar `create-hsm-client-certificate`.
**AWS CLI**
**Para criar um certificado de cliente HSM**
O exemplo `create-hsm-client-certificate` a seguir gera um certificado de cliente HSM usado por um cluster para se conectar a um HSM.
```
aws redshift create-hsm-client-certificate \
--hsm-client-certificate-identifier myhsmclientcert
```
Resultado:
```
{
"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 obter mais informações, consulte [Referência de permissões da API do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [CreateHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-client-certificate.html) na *Referência de comandos da AWS CLI*.
### `create-hsm-configuration`
O código de exemplo a seguir mostra como usar `create-hsm-configuration`.
**AWS CLI**
**Para criar uma configuração HSM**
O exemplo `create-hsm-configuration` a seguir cria uma configuração do HSM que contém as informações necessárias para um cluster armazenar e usar chaves de criptografia de banco de dados em um módulo de segurança 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
```
Resultado:
```
{
"HsmConfiguration": {
"HsmConfigurationIdentifier": "myhsmconnection",
"Description": "My HSM connection",
"HsmIpAddress": "192.0.2.09",
"HsmPartitionName": "myhsmpartition",
"Tags": []
}
}
```
+ Para ver detalhes da API, consulte [CreateHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-configuration.html) na *Referência de comandos da AWS CLI*.
### `create-snapshot-copy-grant`
O código de exemplo a seguir mostra como usar `create-snapshot-copy-grant`.
**AWS CLI**
**Para criar uma concessão de cópia do snapshot**
O exemplo `create-snapshot-copy-grant` a seguir cria uma concessão de cópia do snapshot e criptografa snapshots copiados em uma região de destino da AWS.
```
aws redshift create-snapshot-copy-grant \
--snapshot-copy-grant-name mysnapshotcopygrantname
```
Resultado:
```
{
"SnapshotCopyGrant": {
"SnapshotCopyGrantName": "mysnapshotcopygrantname",
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
"Tags": []
}
}
```
Para obter mais informações, consulte [Criptografia de banco de dados do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [CreateSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-copy-grant.html) na *Referência de comandos da AWS CLI*.
### `create-snapshot-schedule`
O código de exemplo a seguir mostra como usar `create-snapshot-schedule`.
**AWS CLI**
**Para criar uma programação de snapshot**
O exemplo `create-snapshot-schedule` a seguir cria uma programação de snapshot com a descrição especificada e uma taxa a cada 12 horas.
```
aws redshift create-snapshot-schedule \
--schedule-definitions "rate(12 hours)" \
--schedule-identifier mysnapshotschedule \
--schedule-description "My schedule description"
```
Resultado:
```
{
"ScheduleDefinitions": [
"rate(12 hours)"
],
"ScheduleIdentifier": "mysnapshotschedule",
"ScheduleDescription": "My schedule description",
"Tags": []
}
```
Para obter mais informações, consulte [Programações de snapshot automáticas](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [CreateSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-schedule.html) na *Referência de comandos da AWS CLI*.
### `create-tags`
O código de exemplo a seguir mostra como usar `create-tags`.
**AWS CLI**
**Para criar tags para um cluster**
O exemplo `create-tags` a seguir adiciona o par chave/valor da tag especificado ao cluster especificado.
```
aws redshift create-tags \
--resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
--tags "Key"="mytags","Value"="tag1"
```
Esse comando não produz nenhuma saída.
Para obter mais informações, consulte [Marcação de recursos no Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Consulte detalhes da API em [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-tags.html) na *Referência de comandos da AWS CLI*.
### `delete-cluster-parameter-group`
O código de exemplo a seguir mostra como usar `delete-cluster-parameter-group`.
**AWS CLI**
Excluir um grupo de parâmetros de cluster. Este exemplo exclui um grupo de parâmetros de cluster. Comando:
```
aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup
```
+ Para ver detalhes da API, consulte [DeleteClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-parameter-group.html) na *Referência de comandos da AWS CLI*.
### `delete-cluster-security-group`
O código de exemplo a seguir mostra como usar `delete-cluster-security-group`.
**AWS CLI**
Excluir um grupo de segurança do cluster. Este exemplo exclui um grupo de segurança do cluster. Comando:
```
aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup
```
+ Para ver detalhes da API, consulte [DeleteClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-security-group.html) na *Referência de comandos da AWS CLI*.
### `delete-cluster-snapshot`
O código de exemplo a seguir mostra como usar `delete-cluster-snapshot`.
**AWS CLI**
Excluir um snapshot do cluster. Este exemplo exclui um snapshot do cluster. Comando:
```
aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id
```
+ Para ver detalhes da API, consulte [DeleteClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-snapshot.html) na *Referência de comandos da AWS CLI*.
### `delete-cluster-subnet-group`
O código de exemplo a seguir mostra como usar `delete-cluster-subnet-group`.
**AWS CLI**
Excluir um grupo de sub-redes do cluster. Este exemplo exclui um grupo de sub-redes do cluster. Comando:
```
aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup
```
Resultado:
```
{
"ResponseMetadata": {
"RequestId": "253fbffd-6993-11e2-bc3a-47431073908a"
}
}
```
+ Para ver detalhes da API, consulte [DeleteClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-subnet-group.html) na *Referência de comandos da AWS CLI*.
### `delete-cluster`
O código de exemplo a seguir mostra como usar `delete-cluster`.
**AWS CLI**
Excluir um cluster sem um snapshot final do cluster Este exemplo exclui um cluster, forçando a exclusão de dados, para que nenhum snapshot final do cluster seja criado. Comando:
```
aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot
```
Excluir um cluster, permitindo a criação de um snapshot final do cluster Este exemplo exclui um cluster, mas especifica o snapshot final do cluster. Comando:
```
aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot
```
+ Consulte detalhes da API em [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster.html) na *Referência de comandos da AWS CLI*.
### `delete-event-subscription`
O código de exemplo a seguir mostra como usar `delete-event-subscription`.
**AWS CLI**
**Para excluir a assinatura de evento**
O exemplo `delete-event-subscription` a seguir exclui a assinatura de notificação de evento especificada.
```
aws redshift delete-event-subscription \
--subscription-name mysubscription
```
Esse comando não produz nenhuma saída.
Para obter mais informações, consulte [Como se inscrever nas notificações de eventos do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-event-subscription.html) na *Referência de comandos da AWS CLI*.
### `delete-hsm-client-certificate`
O código de exemplo a seguir mostra como usar `delete-hsm-client-certificate`.
**AWS CLI**
**Para excluir o certificado do cliente HSM**
O exemplo `delete-hsm-client-certificate` a seguir exclui um certificado de cliente HSM.
```
aws redshift delete-hsm-client-certificate \
--hsm-client-certificate-identifier myhsmclientcert
```
Esse comando não produz nenhuma saída.
Para obter mais informações, consulte [Referência de permissões da API do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [DeleteHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-client-certificate.html) na *Referência de comandos da AWS CLI*.
### `delete-hsm-configuration`
O código de exemplo a seguir mostra como usar `delete-hsm-configuration`.
**AWS CLI**
**Para excluir uma configuração HSM**
O exemplo `delete-hsm-configuration` a seguir exclui a configuração HSM especificada da conta atual da AWS.
```
aws redshift delete-hsm-configuration /
--hsm-configuration-identifier myhsmconnection
```
Esse comando não produz nenhuma saída.
+ Para ver detalhes da API, consulte [DeleteHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-configuration.html) na *Referência de comandos da AWS CLI*.
### `delete-scheduled-action`
O código de exemplo a seguir mostra como usar `delete-scheduled-action`.
**AWS CLI**
**Para excluir uma ação programada**
O exemplo `delete-scheduled-action` a seguir exclui uma ação programada específica.
```
aws redshift delete-scheduled-action \
--scheduled-action-name myscheduledaction
```
Esse comando não produz nenhuma saída.
+ Para ver detalhes da API, consulte [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-scheduled-action.html) na *Referência de comandos da AWS CLI*.
### `delete-snapshot-copy-grant`
O código de exemplo a seguir mostra como usar `delete-snapshot-copy-grant`.
**AWS CLI**
**Para excluir uma concessão de cópia do snapshot**
O exemplo `delete-snapshot-copy-grant` a seguir exclui a concessão de cópia do snapshot especificada.
```
aws redshift delete-snapshot-copy-grant \
--snapshot-copy-grant-name mysnapshotcopygrantname
```
Esse comando não produz nenhuma saída.
Para obter mais informações, consulte [Criptografia de banco de dados do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [DeleteSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-copy-grant.html) na *Referência de comandos da AWS CLI*.
### `delete-snapshot-schedule`
O código de exemplo a seguir mostra como usar `delete-snapshot-schedule`.
**AWS CLI**
**Para excluir a programação do snapshot**
O exemplo `delete-snapshot-schedule` a seguir exclui a programação do snapshot especificada. Você deve desassociar os clusters antes de excluir a programação.
```
aws redshift delete-snapshot-schedule \
--schedule-identifier mysnapshotschedule
```
Esse comando não produz nenhuma saída.
Para obter mais informações, consulte [Programações de snapshot automáticas](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [DeleteSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-schedule.html) na *Referência de comandos da AWS CLI*.
### `delete-tags`
O código de exemplo a seguir mostra como usar `delete-tags`.
**AWS CLI**
**Para excluir tags de um cluster**
O exemplo `delete-tags` a seguir exclui as tags com os nomes de chave especificados do cluster especificado.
```
aws redshift delete-tags \
--resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
--tag-keys "clustertagkey" "clustertagvalue"
```
Esse comando não produz nenhuma saída.
Para obter mais informações, consulte [Marcação de recursos no Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-tags.html) na *Referência de comandos da AWS CLI*.
### `describe-account-attributes`
O código de exemplo a seguir mostra como usar `describe-account-attributes`.
**AWS CLI**
**Para descrever os atributos de uma** conta da AWS
O exemplo `describe-account-attributes` a seguir exibe os atributos associados à conta da AWS que está fazendo a chamada.
```
aws redshift describe-account-attributes
```
Resultado:
```
{
"AccountAttributes": [
{
"AttributeName": "max-defer-maintenance-duration",
"AttributeValues": [
{
"AttributeValue": "45"
}
]
}
]
}
```
+ Consulte detalhes da API em [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-account-attributes.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-db-revisions`
O código de exemplo a seguir mostra como usar `describe-cluster-db-revisions`.
**AWS CLI**
**Para descrever as revisões de banco de dados para um cluster**
O exemplo `describe-cluster-db-revisions` a seguir exibe os detalhes de uma matriz de objetos `ClusterDbRevision` para o cluster especificado.
```
aws redshift describe-cluster-db-revisions \
--cluster-identifier mycluster
```
Resultado:
```
{
"ClusterDbRevisions": [
{
"ClusterIdentifier": "mycluster",
"CurrentDatabaseRevision": "11420",
"DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z",
"RevisionTargets": []
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeClusterDbRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-db-revisions.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-parameter-groups`
O código de exemplo a seguir mostra como usar `describe-cluster-parameter-groups`.
**AWS CLI**
Obter uma descrição de todos os grupos de parâmetros de cluster. Este exemplo retorna uma descrição de todos os grupos do parâmetros de cluster da conta, com cabeçalhos de colunas. Por padrão, o formato da saída é 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"
}
}
```
Você pode obter as mesmas informações em formato de texto com a opção `--output text`. Comando:
opção `--output text`. Comando:
opção. Comando:
```
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 ver detalhes da API, consulte [DescribeClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameter-groups.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-parameters`
O código de exemplo a seguir mostra como usar `describe-cluster-parameters`.
**AWS CLI**
Recupere os parâmetros de um grupo de parâmetros de cluster especificado. Este exemplo recupera os parâmetros do grupo de parâmetros nomeado. Por padrão, o formato da saída é 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...)
]
}
```
Você pode obter as mesmas informações em formato de texto com a opção `--output text`. Comando:
opção `--output text`. Comando:
opção. Comando:
```
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 ver detalhes da API, consulte [DescribeClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameters.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-security-groups`
O código de exemplo a seguir mostra como usar `describe-cluster-security-groups`.
**AWS CLI**
Obter uma descrição de todos os grupos de segurança de cluster Este exemplo retorna uma descrição de todos os grupos de segurança de cluster para a conta. Por padrão, o formato da saída é 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 ver detalhes da API, consulte [DescribeClusterSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-security-groups.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-snapshots`
O código de exemplo a seguir mostra como usar `describe-cluster-snapshots`.
**AWS CLI**
Obter uma descrição de todos os snapshots do cluster. Este exemplo retorna uma descrição de todos os snapshots do cluster para a conta. Por padrão, o formato da saída é 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 ver detalhes da API, consulte [DescribeClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-snapshots.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-subnet-groups`
O código de exemplo a seguir mostra como usar `describe-cluster-subnet-groups`.
**AWS CLI**
Obter uma descrição de todos os grupos de sub-redes do cluster Este exemplo retorna uma descrição de todos os grupos de sub-redes do cluster. Por padrão, o formato da saída é 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 ver detalhes da API, consulte [DescribeClusterSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-subnet-groups.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-tracks`
O código de exemplo a seguir mostra como usar `describe-cluster-tracks`.
**AWS CLI**
**Para descrever as trilhas do cluster**
O exemplo `describe-cluster-tracks` a seguir exibe detalhes das trilhas de manutenção disponíveis.
```
aws redshift describe-cluster-tracks \
--maintenance-track-name current
```
Resultado:
```
{
"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 obter mais informações, consulte [Como escolher trilhas de manutenção de cluster](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html#rs-mgmt-maintenance-tracks) no *Guia de gerenciamento de clusters do Amazon Redshift*.
+ Para ver detalhes da API, consulte [DescribeClusterTracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-tracks.html) na *Referência de comandos da AWS CLI*.
### `describe-cluster-versions`
O código de exemplo a seguir mostra como usar `describe-cluster-versions`.
**AWS CLI**
Obter uma descrição de todas as versões do cluster. Este exemplo retorna uma descrição de todas as versões do cluster. Por padrão, o formato da saída é 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 ver detalhes da API, consulte [DescribeClusterVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-versions.html) na *Referência de comandos da AWS CLI*.
### `describe-clusters`
O código de exemplo a seguir mostra como usar `describe-clusters`.
**AWS CLI**
Obter uma descrição de todos os clusters Este exemplo retorna uma descrição de todos os clusters da conta. Por padrão, o formato da saída é 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"
}
}
```
Você pode obter as mesmas informações em formato de texto com a opção `--output text`. Comando:
opção `--output text`. Comando:
opção. Comando:
```
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
```
+ Consulte detalhes da API em [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-clusters.html) na *Referência de comandos da AWS CLI*.
### `describe-default-cluster-parameters`
O código de exemplo a seguir mostra como usar `describe-default-cluster-parameters`.
**AWS CLI**
Obter uma descrição dos parâmetros padrão de cluster. Este exemplo retorna uma descrição dos parâmetros padrão do cluster para a família `redshift-1.0`. Por padrão, o formato da saída é 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 uma lista de famílias de grupos de parâmetros válidas, use o comando `describe-cluster-parameter-groups`.
comando `describe-cluster-parameter-groups`.
comando.
+ Para ver detalhes da API, consulte [DescribeDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-default-cluster-parameters.html) na *Referência de comandos da AWS CLI*.
### `describe-event-categories`
O código de exemplo a seguir mostra como usar `describe-event-categories`.
**AWS CLI**
**Para descrever categorias de eventos para um cluster**
O exemplo `describe-event-categories` a seguir exibe detalhes das categorias de eventos de um cluster.
```
aws redshift describe-event-categories \
--source-type cluster
```
Resultado:
```
{
"EventCategoriesMapList": [
{
"SourceType": "cluster",
"Events": [
{
"EventId": "REDSHIFT-EVENT-2000",
"EventCategories": [
"management"
],
"EventDescription": "Cluster created at