Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos do Amazon Redshift usando 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 `accept-reserved-node-exchange` exemplo a seguir aceita a troca de um nó DC1 reservado por um nó DC2 reservado.
```
aws redshift accept-reserved-node-exchange /
--reserved-node-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE /
--target-reserved-node-offering-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE
```
Saída:
```
{
"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 [Atualização de 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 obter detalhes da API, consulte [AcceptReservedNodeExchange](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/accept-reserved-node-exchange.html)em *Referência de AWS CLI Comandos*.
### `authorize-cluster-security-group-ingress`
O código de exemplo a seguir mostra como usar `authorize-cluster-security-group-ingress`.
**AWS CLI**
Autorizar o acesso a um GroupThis exemplo de segurança do EC2 autoriza o acesso a um grupo de segurança do Amazon EC2 nomeado. 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 obter detalhes da API, consulte [AuthorizeClusterSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-cluster-security-group-ingress.html)em *Referência de AWS CLI Comandos*.
### `authorize-snapshot-access`
O código de exemplo a seguir mostra como usar `authorize-snapshot-access`.
**AWS CLI**
Autorizar uma AWS conta para restaurar um SnapshotThis exemplo autoriza a AWS conta a `444455556666` 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 obter detalhes da API, consulte [AuthorizeSnapshotAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-snapshot-access.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [BatchDeleteClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-delete-cluster-snapshots.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [BatchModifyClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-modify-cluster-snapshots.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [CancelResize](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/cancel-resize.html)em *Referência de AWS CLI Comandos*.
### `copy-cluster-snapshot`
O código de exemplo a seguir mostra como usar `copy-cluster-snapshot`.
**AWS CLI**
O VersionsThis exemplo Obter uma descrição de todo o cluster 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 obter detalhes da API, consulte [CopyClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/copy-cluster-snapshot.html)em *Referência de AWS CLI Comandos*.
### `create-cluster-parameter-group`
O código de exemplo a seguir mostra como usar `create-cluster-parameter-group`.
**AWS CLI**
Criar um GroupThis exemplo de parâmetro de cluster 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 obter detalhes da API, consulte [CreateClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-parameter-group.html)em *Referência de AWS CLI Comandos*.
### `create-cluster-security-group`
O código de exemplo a seguir mostra como usar `create-cluster-security-group`.
**AWS CLI**
A criação de um GroupThis exemplo de segurança de cluster cria um novo grupo de segurança de 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 obter detalhes da API, consulte [CreateClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-security-group.html)em *Referência de AWS CLI Comandos*.
### `create-cluster-snapshot`
O código de exemplo a seguir mostra como usar `create-cluster-snapshot`.
**AWS CLI**
Criar um SnapshotThis exemplo de cluster cria um novo instantâneo 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 obter detalhes da API, consulte [CreateClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-snapshot.html)em *Referência de AWS CLI Comandos*.
### `create-cluster-subnet-group`
O código de exemplo a seguir mostra como usar `create-cluster-subnet-group`.
**AWS CLI**
Crie um GroupThis exemplo de sub-rede de cluster cria um novo grupo de sub-redes de 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 obter detalhes da API, consulte [CreateClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-subnet-group.html)em *Referência de AWS CLI Comandos*.
### `create-cluster`
O código de exemplo a seguir mostra como usar `create-cluster`.
**AWS CLI**
O ParametersThis exemplo Criar um cluster com mínimo 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"
}
}
```
+ Para obter detalhes da API, consulte [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-event-subscription.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-client-certificate.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"HsmConfiguration": {
"HsmConfigurationIdentifier": "myhsmconnection",
"Description": "My HSM connection",
"HsmIpAddress": "192.0.2.09",
"HsmPartitionName": "myhsmpartition",
"Tags": []
}
}
```
+ Para obter detalhes da API, consulte [CreateHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-configuration.html)em *Referência de AWS CLI Comandos*.
### `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 `create-snapshot-copy-grant` exemplo a seguir cria uma concessão de cópia de instantâneo e criptografa instantâneos copiados em uma região de destino. AWS
```
aws redshift create-snapshot-copy-grant \
--snapshot-copy-grant-name mysnapshotcopygrantname
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-copy-grant.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-schedule.html)em *Referência de AWS CLI Comandos*.
### `create-tags`
O código de exemplo a seguir mostra como usar `create-tags`.
**AWS CLI**
**Para criar tags para um cluster**
O `create-tags` exemplo a seguir adiciona o key/value par de tags 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*.
+ Para obter detalhes da API, consulte [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-tags.html)em *Referência de AWS CLI Comandos*.
### `delete-cluster-parameter-group`
O código de exemplo a seguir mostra como usar `delete-cluster-parameter-group`.
**AWS CLI**
Excluir um GroupThis exemplo de parâmetro de cluster exclui um grupo de parâmetros de cluster.Comando:
```
aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup
```
+ Para obter detalhes da API, consulte [DeleteClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-parameter-group.html)em *Referência de AWS CLI Comandos*.
### `delete-cluster-security-group`
O código de exemplo a seguir mostra como usar `delete-cluster-security-group`.
**AWS CLI**
Excluir um GroupThis exemplo de segurança de cluster exclui um grupo de segurança de cluster.Comando:
```
aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup
```
+ Para obter detalhes da API, consulte [DeleteClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-security-group.html)em *Referência de AWS CLI Comandos*.
### `delete-cluster-snapshot`
O código de exemplo a seguir mostra como usar `delete-cluster-snapshot`.
**AWS CLI**
Excluir um SnapshotThis exemplo de cluster exclui um snapshot do cluster.Comando:
```
aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id
```
+ Para obter detalhes da API, consulte [DeleteClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-snapshot.html)em *Referência de AWS CLI Comandos*.
### `delete-cluster-subnet-group`
O código de exemplo a seguir mostra como usar `delete-cluster-subnet-group`.
**AWS CLI**
Excluir um GroupThis exemplo de sub-rede de cluster exclui um grupo de sub-redes de cluster.Comando:
```
aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup
```
Resultado:
```
{
"ResponseMetadata": {
"RequestId": "253fbffd-6993-11e2-bc3a-47431073908a"
}
}
```
+ Para obter detalhes da API, consulte [DeleteClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-subnet-group.html)em *Referência de AWS CLI Comandos*.
### `delete-cluster`
O código de exemplo a seguir mostra como usar `delete-cluster`.
**AWS CLI**
O SnapshotThis exemplo Excluir um cluster sem cluster final exclui um cluster, forçando a exclusão de dados para que nenhum instantâneo final do cluster seja criado.Comando:
```
aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot
```
Excluir um cluster, Permitindo um SnapshotThis exemplo de cluster final exclui um cluster, mas especifica um instantâneo final do cluster.Comando:
```
aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot
```
+ Para obter detalhes da API, consulte [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-event-subscription.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-client-certificate.html)em *Referência de AWS CLI Comandos*.
### `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 `delete-hsm-configuration` exemplo a seguir exclui a configuração HSM especificada da conta atual AWS .
```
aws redshift delete-hsm-configuration /
--hsm-configuration-identifier myhsmconnection
```
Esse comando não produz nenhuma saída.
+ Para obter detalhes da API, consulte [DeleteHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-configuration.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-scheduled-action.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-copy-grant.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-schedule.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-tags.html)em *Referência de AWS CLI Comandos*.
### `describe-account-attributes`
O código de exemplo a seguir mostra como usar `describe-account-attributes`.
**AWS CLI**
**Para descrever os atributos de uma AWS conta**
O `describe-account-attributes` exemplo a seguir exibe os atributos associados à AWS conta de chamada.
```
aws redshift describe-account-attributes
```
Saída:
```
{
"AccountAttributes": [
{
"AttributeName": "max-defer-maintenance-duration",
"AttributeValues": [
{
"AttributeValue": "45"
}
]
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-account-attributes.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"ClusterDbRevisions": [
{
"ClusterIdentifier": "mycluster",
"CurrentDatabaseRevision": "11420",
"DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z",
"RevisionTargets": []
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeClusterDbRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-db-revisions.html)em *Referência de AWS CLI Comandos*.
### `describe-cluster-parameter-groups`
O código de exemplo a seguir mostra como usar `describe-cluster-parameter-groups`.
**AWS CLI**
O GroupsThis exemplo Obter uma descrição de todos os parâmetros do cluster retorna uma descrição de todos os grupos de parâmetros do cluster da conta, com cabeçalhos de coluna. 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 obter detalhes da API, consulte [DescribeClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameter-groups.html)em *Referência de AWS CLI Comandos*.
### `describe-cluster-parameters`
O código de exemplo a seguir mostra como usar `describe-cluster-parameters`.
**AWS CLI**
O GroupThis exemplo de Recuperar os parâmetros para um parâmetro de cluster especificado 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 obter detalhes da API, consulte [DescribeClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameters.html)em *Referência de AWS CLI Comandos*.
### `describe-cluster-security-groups`
O código de exemplo a seguir mostra como usar `describe-cluster-security-groups`.
**AWS CLI**
O GroupsThis exemplo Obter uma descrição de toda a segurança do cluster retorna uma descrição de todos os grupos de segurança do cluster da 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 obter detalhes da API, consulte [DescribeClusterSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-security-groups.html)em *Referência de AWS CLI Comandos*.
### `describe-cluster-snapshots`
O código de exemplo a seguir mostra como usar `describe-cluster-snapshots`.
**AWS CLI**
O SnapshotsThis exemplo Obter uma descrição de todo o cluster retorna uma descrição de todos os instantâneos do cluster da 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 obter detalhes da API, consulte [DescribeClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-snapshots.html)em *Referência de AWS CLI Comandos*.
### `describe-cluster-subnet-groups`
O código de exemplo a seguir mostra como usar `describe-cluster-subnet-groups`.
**AWS CLI**
O GroupsThis exemplo Obter uma descrição de todas as sub-redes do cluster 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 obter detalhes da API, consulte [DescribeClusterSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-subnet-groups.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [DescribeClusterTracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-tracks.html)em *Referência de AWS CLI Comandos*.
### `describe-cluster-versions`
O código de exemplo a seguir mostra como usar `describe-cluster-versions`.
**AWS CLI**
O VersionsThis exemplo Obter uma descrição de todo o cluster 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 obter detalhes da API, consulte [DescribeClusterVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-versions.html)em *Referência de AWS CLI Comandos*.
### `describe-clusters`
O código de exemplo a seguir mostra como usar `describe-clusters`.
**AWS CLI**
O ClustersThis exemplo Obter uma descrição de tudo 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
```
+ Para obter detalhes da API, consulte [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-clusters.html)em *Referência de AWS CLI Comandos*.
### `describe-default-cluster-parameters`
O código de exemplo a seguir mostra como usar `describe-default-cluster-parameters`.
**AWS CLI**
O ParametersThis exemplo Obter uma descrição do cluster padrão retorna uma descrição dos parâmetros de cluster padrão para a `redshift-1.0` família. 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 obter detalhes da API, consulte [DescribeDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-default-cluster-parameters.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"EventCategoriesMapList": [
{
"SourceType": "cluster",
"Events": [
{
"EventId": "REDSHIFT-EVENT-2000",
"EventCategories": [
"management"
],
"EventDescription": "Cluster created at