Exemplos do Amazon Redshift com o uso da AWS CLI - AWS Command Line Interface
Ações

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.

Tópicos

Ações

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

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 Atualizar nós reservados com a AWS CLI no Guia de gerenciamento de clusters do Amazon Redshift.

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

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"
   }
}

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte CancelResize na Referência de comandos da AWS CLI.

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 na Referência de comandos da AWS CLI.

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"
   }
}

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

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"
   }
}

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"
   }
}

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"
   }
}

  • Para ver detalhes da API, consulte CreateCluster em AWS CLI Command Reference.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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": []
    }
}

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

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para obter detalhes da API, consulte CreateTags na Referência de comandos da AWS CLI.

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

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

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

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"
   }
}

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

  • Para ver detalhes da API, consulte DeleteCluster em AWS CLI Command Reference.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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.

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.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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 no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte DeleteTags na Referência de comandos da AWS CLI.

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

Saída:

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

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": []
        }
    ]
}

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

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

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...)
   ]
}

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...)

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"
   }
}

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 no Guia de gerenciamento de clusters do Amazon Redshift.

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"
   }
}

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

  • Para ver detalhes da API, consulte DescribeClusters em AWS CLI Command Reference.

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.

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

O código de exemplo a seguir mostra como usar describe-event-subscriptions.

AWS CLI

Para descrever assinaturas de eventos

O exemplo describe-event-subscriptions a seguir exibe assinaturas de notificações de eventos para a assinatura especificada.

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

Saída:

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

Para obter mais informações, consulte Como se inscrever nas notificações de eventos do Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar describe-events.

AWS CLI

Descreve todos os eventos. Este exemplo retorna todos os eventos. Por padrão, o formato da saída é JSON. Comando:

aws redshift describe-events

Resultado:

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

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-events --output text

Resultado:

2013-01-22T19:17:03.640Z    myclusterparametergroup Cluster parameter group myclusterparametergroup has been created.       cluster-parameter-group
RESPONSEMETADATA    8e5fe765-64c9-11e2-bce3-e56f52c50e17

  • Para ver detalhes da API, consulte DescribeEvents na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-hsm-client-certificates.

AWS CLI

Para descrever certificados de cliente HSM

O exemplo describe-hsm-client-certificates a seguir exibe os detalhes do certificado de cliente HSM especificado.

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

Saída:

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

Para obter mais informações, consulte Referência de permissões da API do Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar describe-hsm-configurations.

AWS CLI

Para descrever configurações HSM

O exemplo describe-hsm-configurations a seguir exibe detalhes das configurações HSM disponíveis para a conta de chamadaAWS.

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

Saída:

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

O código de exemplo a seguir mostra como usar describe-logging-status.

AWS CLI

Para descrever o status de registro em log de um cluster

O exemplo describe-logging-status a seguir exibe se as informações, como consultas e tentativas de conexão, estão sendo registradas em log para um cluster.

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

Saída:

{
    "LoggingEnabled": false
}

Para obter mais informações, consulte Registros em logo de auditoria de bancos de dados no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar describe-node-configuration-options.

AWS CLI

Para descrever as opções de configuração de nó

O exemplo describe-node-configuration-options a seguir exibe as propriedades de possíveis configurações de nó, como tipo de nó, número de nós e uso de disco para o snapshot do cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Adquirindo nós reservados do Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar describe-orderable-cluster-options.

AWS CLI

Descreve todas as opções de cluster solicitáveis. Este exemplo retorna descrições de todas as opções de cluster solicitáveis. Por padrão, o formato da saída é JSON. Comando:

aws redshift describe-orderable-cluster-options

Resultado:

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

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-orderable-cluster-options --output text

Resultado:

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

O código de exemplo a seguir mostra como usar describe-reserved-node-offerings.

AWS CLI

Descreve as ofertas de nós reservados. Este exemplo mostra todas as ofertas de nós reservados que estão disponíveis para compra. Comando:

aws redshift describe-reserved-node-offerings

Resultado:

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

Se quiser comprar uma oferta de nó reservado, você pode chamar purchase-reserved-node-offering usando um ReservedNodeOfferingID válido.

purchase-reserved-node-offeringusando ReservedNodeOfferingID válido.

usando um ReservedNodeOfferingID válido.

ReservedNodeOfferingId.

.

O código de exemplo a seguir mostra como usar describe-reserved-nodes.

AWS CLI

Descreva os nós reservados. Este exemplo mostra uma oferta de nó reservado que foi comprada. Comando:

aws redshift describe-reserved-nodes

Resultado:

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

O código de exemplo a seguir mostra como usar describe-resize.

AWS CLI

Descreve o redimensionamento. Este exemplo descreve o último redimensionamento de um cluster. A solicitação foi para 3 nós do tipo dw.hs1.8xlarge.Comando:

aws redshift describe-resize --cluster-identifier mycluster

Resultado:

{
   "Status": "NONE",
   "TargetClusterType": "multi-node",
   "TargetNodeType": "dw.hs1.8xlarge",
   "ResponseMetadata": {
      "RequestId": "9f52b0b4-7733-11e2-aa9b-318b2909bd27"
   },
   "TargetNumberOfNodes": "3"
}

  • Para ver detalhes da API, consulte DescribeResize na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-scheduled-actions.

AWS CLI

Para descrever ações programadas

O exemplo describe-scheduled-actions a seguir exibe detalhes de todas as ações programadas atualmente.

aws redshift describe-scheduled-actions

Saída:

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

O código de exemplo a seguir mostra como usar describe-snapshot-copy-grants.

AWS CLI

Para descrever concessões de cópia de snapshot

O exemplo describe-snapshot-copy-grants a seguir exibe os detalhes da concessão de cópia de snapshot do cluster especificado.

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

Saída:

{
    "SnapshotCopyGrants": [
        {
            "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 no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar describe-snapshot-schedules.

AWS CLI

Para descrever as programações de snapshots

O exemplo describe-snapshot-schedules a seguir exibe os detalhes da programação de snapshot do cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Programações de snapshot automáticas no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar describe-storage.

AWS CLI

Para descrever o armazenamento

O exemplo describe-storage a seguir exibe detalhes sobre o armazenamento de backup e os tamanhos de armazenamento provisório da conta.

aws redshift describe-storage

Saída:

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

Para obter mais informações, consulte Gerenciamento de armazenamento de snapshots no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte DescribeStorage na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-table-restore-status.

AWS CLI

Para descrever o status das solicitações de restauração de tabela a partir de um snapshot de cluster

O exemplo describe-table-restore-status a seguir exibe detalhes das solicitações de restauração de tabela feitas para o cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Restaurar uma tabela a partir de um snapshot no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar describe-tags.

AWS CLI

Para descrever as tags

O exemplo describe-tags a seguir exibe os recursos que o cluster especificado associou aos nomes e valores das tags especificados.

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

Saída:

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

Para obter mais informações, consulte Marcação de recursos no Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte DescribeTags na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar disable-snapshot-copy.

AWS CLI

Para desabilitar a cópia de snapshot para um cluster

O exemplo disable-snapshot-copy a seguir desativa a cópia automática de um snapshot para o cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Cópia de snapshots para outra região da AWS no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte DisableSnapshotCopy na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar enable-snapshot-copy.

AWS CLI

Para habilitar a cópia do snapshot para um cluster

O exemplo enable-snapshot-copy a seguir permite a cópia automática de um snapshot para o cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Cópia de snapshots para outra região da AWS no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte EnableSnapshotCopy na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar get-cluster-credentials.

AWS CLI

Para obter credenciais de cluster para uma AWS conta

O exemplo get-cluster-credentials a seguir recupera credenciais temporárias que permitem o acesso a um banco de dados do Amazon Redshift.

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

Saída:

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

Para obter mais informações, consulte Gerar credenciais de banco de dados IAM usando a CLI ou API do Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar get-reserved-node-exchange-offerings.

AWS CLI

Para obter ofertas reservadas de troca de nós

O exemplo get-reserved-node-exchange-offerings a seguir recupera uma matriz DC2 ReservedNodeOfferings que corresponde ao nó DC1 reservado especificado.

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

Saída:

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

Para obter mais informações, consulte Atualizar nós reservados com a AWS CLI no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar modify-cluster-iam-roles.

AWS CLI

Para modificar o perfil do IAM para um cluster

O exemplo modify-cluster-iam-roles a seguir remove o perfil AWS do IAM especificado do cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Usar políticas baseadas em identidade (políticas do IAM) para o Amazon Redshift, no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar modify-cluster-maintenance.

AWS CLI

Para modificar a manutenção do cluster

O exemplo modify-cluster-maintenance a seguir adia a manutenção do cluster especificado em 30 dias.

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

Saída:

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

Para obter mais informações, consulte Manutenção de cluster no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar modify-cluster-parameter-group.

AWS CLI

Modificar um parâmetro em um grupo de parâmetros

O exemplo modify-cluster-parameter-group a seguir modifica o parâmetro wlm_json_configuration para o gerenciamento de workload. Ele aceita os parâmetros de um arquivo que contém o conteúdo JSON mostrado abaixo.

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

Conteúdo de modify_pg.json:

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

Saída:

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

O código de exemplo a seguir mostra como usar modify-cluster-snapshot-schedule.

AWS CLI

Para modificar a programação de snapshot do cluster

O exemplo modify-cluster-snapshot-schedule a seguir remove a programação de snapshot especificada do cluster especificado.

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

Esse comando não produz nenhuma saída.

Para obter mais informações, consulte Programações de snapshot automáticas no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar modify-cluster-snapshot.

AWS CLI

Para modificar o snapshot do cluster

O exemplo modify-cluster-snapshot a seguir define a configuração do período de retenção manual para o snapshot de cluster especificado no valor de 10 dias.

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

Saída:

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

Para obter mais informações, consulte Snapshots do Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar modify-cluster-subnet-group.

AWS CLI

Modificar as sub-redes em um grupo de sub-redes de cluster. Este exemplo mostra como modificar a lista de sub-redes em um grupo de sub-redes de cache. Por padrão, o formato da saída é JSON. Comando:

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

Resultado:

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

O código de exemplo a seguir mostra como usar modify-cluster.

AWS CLI

Associar um grupo de segurança a um cluster Este exemplo mostra como associar um grupo de segurança de cluster ao cluster especificado. Comando:

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

Modificar a janela de manutenção de um cluster Este exemplo mostra como alterar a janela de manutenção semanal preferencial de um cluster para a janela de intervalo mínimo de quatro horas, começando aos domingos às 23h15 e terminando às segundas-feiras às 3h15. Comando:

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

Alterar a senha mestre do cluster Este exemplo mostra como alterar a senha mestre de um cluster. Comando:

aws redshift modify-cluster --cluster-identifier mycluster --master-user-password A1b2c3d4

  • Para ver detalhes da API, consulte ModifyCluster em AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar modify-event-subscription.

AWS CLI

Para modificar a assinatura de evento

O exemplo modify-event-subscription a seguir desativa a assinatura de notificação de evento especificada.

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

Saída:

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

Para obter mais informações, consulte Como se inscrever nas notificações de eventos do Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar modify-scheduled-action.

AWS CLI

Para editar uma ação programada

O exemplo modify-scheduled-action a seguir adiciona uma descrição à ação programada existente especificada.

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

Saída:

{
    "ScheduledActionName": "myscheduledaction",
    "TargetAction": {
        "ResizeCluster": {
            "ClusterIdentifier": "mycluster",
            "NumberOfNodes": 2,
            "Classic": false
        }
    },
    "Schedule": "at(2019-12-25T00:00:00)",
    "IamRole": "arn:aws:iam::123456789012:role/myRedshiftRole",
    "ScheduledActionDescription": "My scheduled action",
    "State": "ACTIVE",
    "NextInvocations": [
        "2019-12-25T00:00:00Z"
    ]
}

O código de exemplo a seguir mostra como usar modify-snapshot-copy-retention-period.

AWS CLI

Para modificar o período de retenção de cópia de snapshot

O exemplo modify-snapshot-copy-retention-period a seguir modifica o número de dias para reter snapshots do cluster especificado na região de destino da AWS após serem copiados da região de origem da AWS.

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

Saída:

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

Para obter mais informações, consulte Formato de programação de snapshots no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar modify-snapshot-schedule.

AWS CLI

Para modificar a programação de snapshots

O exemplo modify-snapshot-schedule a seguir modifica a taxa da programação de snapshot especificada para cada 10 horas.

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

Saída:

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

Para obter mais informações, consulte Formato de programação de snapshots no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar purchase-reserved-node-offering.

AWS CLI

Comprar um nó reservado. Este exemplo mostra como comprar uma oferta de nó reservada. O reserved-node-offering-id é obtido chamando describe-reserved-node-offerings. Comando:

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

Resultado:

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

O código de exemplo a seguir mostra como usar reboot-cluster.

AWS CLI

Reinicializar um cluster. Este exemplo reinicia um cluster. Por padrão, o formato da saída é JSON. Comando:

aws redshift reboot-cluster --cluster-identifier mycluster

Resultado:

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

  • Para ver detalhes da API, consulte RebootCluster na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar reset-cluster-parameter-group.

AWS CLI

Redefinir parâmetros em um grupo de parâmetros. Este exemplo mostra como redefinir todos os parâmetros em um grupo de parâmetros.Comando:

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

O código de exemplo a seguir mostra como usar resize-cluster.

AWS CLI

Para redimensionar um cluster

O exemplo resize-cluster a seguir redimensiona o cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Redimensionar um Cluster no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte ResizeCluster na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar restore-from-cluster-snapshot.

AWS CLI

Restaurar um cluster a partir de um snapshot. Este exemplo restaura um cluster de um snapshot.Comando:

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

Resultado:

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

O código de exemplo a seguir mostra como usar restore-table-from-cluster-snapshot.

AWS CLI

Para restaurar um cluster a partir de um snapshot

O exemplo restore-table-from-cluster-snapshot a seguir cria uma nova tabela a partir da tabela especificada no snapshot do cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Restaurar uma tabela a partir de um snapshot no Guia de gerenciamento de clusters do Amazon Redshift.

O código de exemplo a seguir mostra como usar revoke-cluster-security-group-ingress.

AWS CLI

Revogar o acesso de um grupo de segurança do EC2. Este exemplo revoga o acesso a um grupo de segurança do Amazon EC2 nomeado. Comando:

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

Revogando o acesso a um intervalo CIDR. Este exemplo revoga o acesso a um intervalo CIDR. Comando:

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

O código de exemplo a seguir mostra como usar revoke-snapshot-access.

AWS CLI

Revogar a autorização de uma conta da AWS para restaurar um snapshot. Este exemplo revoga a autorização da conta da AWS 444455556666 para restaurar o snapshotmy-snapshot-id. Por padrão, o formato da saída é JSON. Comando:

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

Resultado:

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

O código de exemplo a seguir mostra como usar rotate-encryption-key.

AWS CLI

Para alternar as chaves de criptografia de um cluster

O exemplo rotate-encryption-key a seguir gira a chave de criptografia para o cluster especificado.

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

Saída:

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

Para obter mais informações, consulte Criptografia de banco de dados do Amazon Redshift no Guia de gerenciamento de clusters do Amazon Redshift.

  • Para ver detalhes da API, consulte RotateEncryptionKey na Referência de comandos da AWS CLI.