Exemplos do Amazon Redshift usando AWS CLI

PDF

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.

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

• Para obter detalhes da API, consulte AcceptReservedNodeExchangeem Referência de AWS CLI Comandos.

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

• Para obter detalhes da API, consulte AcceptReservedNodeExchangeem 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 EC2 de segurança autoriza o acesso a um grupo de EC2 segurança nomeado da Amazon.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 AuthorizeClusterSecurityGroupIngressem 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 EC2 de segurança autoriza o acesso a um grupo de EC2 segurança nomeado da Amazon.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 AuthorizeClusterSecurityGroupIngressem 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 AuthorizeSnapshotAccessem 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 AuthorizeSnapshotAccessem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte BatchDeleteClusterSnapshotsem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte BatchDeleteClusterSnapshotsem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte BatchModifyClusterSnapshotsem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte BatchModifyClusterSnapshotsem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CancelResizeem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CancelResizeem 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 CopyClusterSnapshotem 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 CopyClusterSnapshotem 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 CreateClusterParameterGroupem 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 CreateClusterParameterGroupem 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 CreateClusterSecurityGroupem 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 CreateClusterSecurityGroupem 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 CreateClusterSnapshotem 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 CreateClusterSnapshotem 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 CreateClusterSubnetGroupem 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 CreateClusterSubnetGroupem 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 CreateClusterem 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 CreateClusterem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateEventSubscriptionem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateEventSubscriptionem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateHsmClientCertificateem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateHsmClientCertificateem 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 CreateHsmConfigurationem 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 CreateHsmConfigurationem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateSnapshotCopyGrantem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateSnapshotCopyGrantem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateSnapshotScheduleem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte CreateSnapshotScheduleem 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 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 CreateTagsem 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 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 CreateTagsem 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 DeleteClusterParameterGroupem 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 DeleteClusterParameterGroupem 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 DeleteClusterSecurityGroupem 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 DeleteClusterSecurityGroupem 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 DeleteClusterSnapshotem 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 DeleteClusterSnapshotem 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 DeleteClusterSubnetGroupem 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 DeleteClusterSubnetGroupem 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 DeleteClusterem 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 DeleteClusterem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteEventSubscriptionem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteEventSubscriptionem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteHsmClientCertificateem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteHsmClientCertificateem 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 DeleteHsmConfigurationem 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 DeleteHsmConfigurationem 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 DeleteScheduledActionem 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 DeleteScheduledActionem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteSnapshotCopyGrantem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteSnapshotCopyGrantem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteSnapshotScheduleem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteSnapshotScheduleem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteTagsem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DeleteTagsem 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 DescribeAccountAttributesem 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 DescribeAccountAttributesem 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 DescribeClusterDbRevisionsem 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 DescribeClusterDbRevisionsem 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 DescribeClusterParameterGroupsem 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 DescribeClusterParameterGroupsem 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 DescribeClusterParametersem 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 DescribeClusterParametersem 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 DescribeClusterSecurityGroupsem 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 DescribeClusterSecurityGroupsem 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 DescribeClusterSnapshotsem 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 DescribeClusterSnapshotsem 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 DescribeClusterSubnetGroupsem 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 DescribeClusterSubnetGroupsem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DescribeClusterTracksem 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 no Guia de gerenciamento de clusters do Amazon Redshift.

• Para obter detalhes da API, consulte DescribeClusterTracksem 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 DescribeClusterVersionsem 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 DescribeClusterVersionsem 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 DescribeClustersem 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 DescribeClustersem 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 DescribeDefaultClusterParametersem 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 DescribeDefaultClusterParametersem 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 <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"
                }
            ]
        }
    ]
}

• Para obter detalhes da API, consulte DescribeEventCategoriesem 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 <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"
                }
            ]
        }
    ]
}

• Para obter detalhes da API, consulte DescribeEventCategoriesem Referência de AWS CLI Comandos.

describe-event-subscriptions

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.

• Para obter detalhes da API, consulte DescribeEventSubscriptionsem Referência de AWS CLI Comandos.

describe-event-subscriptions

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.

• Para obter detalhes da API, consulte DescribeEventSubscriptionsem Referência de AWS CLI Comandos.

describe-events

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 obter detalhes da API, consulte DescribeEventsem Referência de AWS CLI Comandos.

describe-events

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 obter detalhes da API, consulte DescribeEventsem Referência de AWS CLI Comandos.

describe-hsm-client-certificates

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.

• Para obter detalhes da API, consulte DescribeHsmClientCertificatesem Referência de AWS CLI Comandos.

describe-hsm-client-certificates

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.

• Para obter detalhes da API, consulte DescribeHsmClientCertificatesem Referência de AWS CLI Comandos.

describe-hsm-configurations

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

AWS CLI

Para descrever configurações HSM

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

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

• Para obter detalhes da API, consulte DescribeHsmConfigurationsem Referência de AWS CLI Comandos.

describe-hsm-configurations

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

AWS CLI

Para descrever configurações HSM

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

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

• Para obter detalhes da API, consulte DescribeHsmConfigurationsem Referência de AWS CLI Comandos.

describe-logging-status

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.

• Para obter detalhes da API, consulte DescribeLoggingStatusem Referência de AWS CLI Comandos.

describe-logging-status

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.

• Para obter detalhes da API, consulte DescribeLoggingStatusem Referência de AWS CLI Comandos.

describe-node-configuration-options

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.

• Para obter detalhes da API, consulte DescribeNodeConfigurationOptionsem Referência de AWS CLI Comandos.

describe-node-configuration-options

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.

• Para obter detalhes da API, consulte DescribeNodeConfigurationOptionsem Referência de AWS CLI Comandos.

describe-orderable-cluster-options

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

AWS CLI

O OptionsThis exemplo de descrição de todos os clusters solicitáveis retorna descrições de todas as opções de clusters 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

• Para obter detalhes da API, consulte DescribeOrderableClusterOptionsem Referência de AWS CLI Comandos.

describe-orderable-cluster-options

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

AWS CLI

O OptionsThis exemplo de descrição de todos os clusters solicitáveis retorna descrições de todas as opções de clusters 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

• Para obter detalhes da API, consulte DescribeOrderableClusterOptionsem Referência de AWS CLI Comandos.

describe-reserved-node-offerings

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

AWS CLI

O OfferingsThis exemplo de descrição do nó reservado 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 você quiser comprar uma oferta de nó reservado, você pode ligar purchase-reserved-node-offering usando um válido ReservedNodeOfferingId.

purchase-reserved-node-offeringusando um válido ReservedNodeOfferingId.

usando um válido ReservedNodeOfferingId.

ReservedNodeOfferingId.

.

• Para obter detalhes da API, consulte DescribeReservedNodeOfferingsem Referência de AWS CLI Comandos.

describe-reserved-node-offerings

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

AWS CLI

O OfferingsThis exemplo de descrição do nó reservado 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 você quiser comprar uma oferta de nó reservado, você pode ligar purchase-reserved-node-offering usando um válido ReservedNodeOfferingId.

purchase-reserved-node-offeringusando um válido ReservedNodeOfferingId.

usando um válido ReservedNodeOfferingId.

ReservedNodeOfferingId.

.

• Para obter detalhes da API, consulte DescribeReservedNodeOfferingsem Referência de AWS CLI Comandos.

describe-reserved-nodes

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

AWS CLI

Descrever Reserved O NodesThis 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"
      }
   ]
}

• Para obter detalhes da API, consulte DescribeReservedNodesem Referência de AWS CLI Comandos.

describe-reserved-nodes

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

AWS CLI

Descrever Reserved O NodesThis 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"
      }
   ]
}

• Para obter detalhes da API, consulte DescribeReservedNodesem Referência de AWS CLI Comandos.

describe-resize

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

AWS CLI

O ResizeThis 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 obter detalhes da API, consulte DescribeResizeem Referência de AWS CLI Comandos.

describe-resize

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

AWS CLI

O ResizeThis 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 obter detalhes da API, consulte DescribeResizeem Referência de AWS CLI Comandos.

describe-scheduled-actions

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

• Para obter detalhes da API, consulte DescribeScheduledActionsem Referência de AWS CLI Comandos.

describe-scheduled-actions

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

• Para obter detalhes da API, consulte DescribeScheduledActionsem Referência de AWS CLI Comandos.

describe-snapshot-copy-grants

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.

• Para obter detalhes da API, consulte DescribeSnapshotCopyGrantsem Referência de AWS CLI Comandos.

describe-snapshot-copy-grants

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.

• Para obter detalhes da API, consulte DescribeSnapshotCopyGrantsem Referência de AWS CLI Comandos.

describe-snapshot-schedules

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.

• Para obter detalhes da API, consulte DescribeSnapshotSchedulesem Referência de AWS CLI Comandos.

describe-snapshot-schedules

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.

• Para obter detalhes da API, consulte DescribeSnapshotSchedulesem Referência de AWS CLI Comandos.

describe-storage

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 obter detalhes da API, consulte DescribeStorageem Referência de AWS CLI Comandos.

describe-storage

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 obter detalhes da API, consulte DescribeStorageem Referência de AWS CLI Comandos.

describe-table-restore-status

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.

• Para obter detalhes da API, consulte DescribeTableRestoreStatusem Referência de AWS CLI Comandos.

describe-table-restore-status

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.

• Para obter detalhes da API, consulte DescribeTableRestoreStatusem Referência de AWS CLI Comandos.

describe-tags

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 obter detalhes da API, consulte DescribeTagsem Referência de AWS CLI Comandos.

describe-tags

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 obter detalhes da API, consulte DescribeTagsem Referência de AWS CLI Comandos.

disable-snapshot-copy

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

• Para obter detalhes da API, consulte DisableSnapshotCopyem Referência de AWS CLI Comandos.

disable-snapshot-copy

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

• Para obter detalhes da API, consulte DisableSnapshotCopyem Referência de AWS CLI Comandos.

enable-snapshot-copy

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

• Para obter detalhes da API, consulte EnableSnapshotCopyem Referência de AWS CLI Comandos.

enable-snapshot-copy

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

• Para obter detalhes da API, consulte EnableSnapshotCopyem Referência de AWS CLI Comandos.

get-cluster-credentials

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

AWS CLI

Para obter credenciais de cluster para uma conta AWS

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.

• Para obter detalhes da API, consulte GetClusterCredentialsem Referência de AWS CLI Comandos.

get-cluster-credentials

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

AWS CLI

Para obter credenciais de cluster para uma conta AWS

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.

• Para obter detalhes da API, consulte GetClusterCredentialsem Referência de AWS CLI Comandos.

get-reserved-node-exchange-offerings

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

• Para obter detalhes da API, consulte GetReservedNodeExchangeOfferingsem Referência de AWS CLI Comandos.

get-reserved-node-exchange-offerings

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

• Para obter detalhes da API, consulte GetReservedNodeExchangeOfferingsem Referência de AWS CLI Comandos.

modify-cluster-iam-roles

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 modify-cluster-iam-roles exemplo a seguir remove a função AWS do IAM especificada 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.

• Para obter detalhes da API, consulte ModifyClusterIamRolesem Referência de AWS CLI Comandos.

modify-cluster-iam-roles

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 modify-cluster-iam-roles exemplo a seguir remove a função AWS do IAM especificada 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.

• Para obter detalhes da API, consulte ModifyClusterIamRolesem Referência de AWS CLI Comandos.

modify-cluster-maintenance

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.

• Para obter detalhes da API, consulte ModifyClusterMaintenanceem Referência de AWS CLI Comandos.

modify-cluster-maintenance

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.

• Para obter detalhes da API, consulte ModifyClusterMaintenanceem Referência de AWS CLI Comandos.

modify-cluster-parameter-group

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

• Para obter detalhes da API, consulte ModifyClusterParameterGroupem Referência de AWS CLI Comandos.

modify-cluster-parameter-group

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

• Para obter detalhes da API, consulte ModifyClusterParameterGroupem Referência de AWS CLI Comandos.

modify-cluster-snapshot-schedule

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.

• Para obter detalhes da API, consulte ModifyClusterSnapshotScheduleem Referência de AWS CLI Comandos.

modify-cluster-snapshot-schedule

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.

• Para obter detalhes da API, consulte ModifyClusterSnapshotScheduleem Referência de AWS CLI Comandos.

modify-cluster-snapshot

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.

• Para obter detalhes da API, consulte ModifyClusterSnapshotem Referência de AWS CLI Comandos.

modify-cluster-snapshot

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.

• Para obter detalhes da API, consulte ModifyClusterSnapshotem Referência de AWS CLI Comandos.

modify-cluster-subnet-group

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

AWS CLI

O GroupThis exemplo de Modificar as sub-redes em uma sub-rede de cluster 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"
   }
}

• Para obter detalhes da API, consulte ModifyClusterSubnetGroupem Referência de AWS CLI Comandos.

modify-cluster-subnet-group

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

AWS CLI

O GroupThis exemplo de Modificar as sub-redes em uma sub-rede de cluster 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"
   }
}

• Para obter detalhes da API, consulte ModifyClusterSubnetGroupem Referência de AWS CLI Comandos.

modify-cluster

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

AWS CLI

Associar um grupo de segurança a um ClusterThis 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 para a ClusterThis mostra como alterar a janela de manutenção semanal preferencial de um cluster para a janela mínima 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 mestra do ClusterThis exemplo mostra como alterar a senha mestra de um cluster.Comando:

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

• Para obter detalhes da API, consulte ModifyClusterem Referência de AWS CLI Comandos.

modify-cluster

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

AWS CLI

Associar um grupo de segurança a um ClusterThis 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 para a ClusterThis mostra como alterar a janela de manutenção semanal preferencial de um cluster para a janela mínima 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 mestra do ClusterThis exemplo mostra como alterar a senha mestra de um cluster.Comando:

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

• Para obter detalhes da API, consulte ModifyClusterem Referência de AWS CLI Comandos.

modify-event-subscription

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.

• Para obter detalhes da API, consulte ModifyEventSubscriptionem Referência de AWS CLI Comandos.

modify-event-subscription

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.

• Para obter detalhes da API, consulte ModifyEventSubscriptionem Referência de AWS CLI Comandos.

modify-scheduled-action

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

• Para obter detalhes da API, consulte ModifyScheduledActionem Referência de AWS CLI Comandos.

modify-scheduled-action

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

• Para obter detalhes da API, consulte ModifyScheduledActionem Referência de AWS CLI Comandos.

modify-snapshot-copy-retention-period

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 modify-snapshot-copy-retention-period exemplo a seguir modifica o número de dias para reter os instantâneos do cluster especificado na AWS região de destino após serem copiados da região de origem. 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.

• Para obter detalhes da API, consulte ModifySnapshotCopyRetentionPeriodem Referência de AWS CLI Comandos.

modify-snapshot-copy-retention-period

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 modify-snapshot-copy-retention-period exemplo a seguir modifica o número de dias para reter os instantâneos do cluster especificado na AWS região de destino após serem copiados da região de origem. 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.

• Para obter detalhes da API, consulte ModifySnapshotCopyRetentionPeriodem Referência de AWS CLI Comandos.

modify-snapshot-schedule

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.

• Para obter detalhes da API, consulte ModifySnapshotScheduleem Referência de AWS CLI Comandos.

modify-snapshot-schedule

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.

• Para obter detalhes da API, consulte ModifySnapshotScheduleem Referência de AWS CLI Comandos.

purchase-reserved-node-offering

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

AWS CLI

O NodeThis exemplo de compra de um nó reservado mostra como comprar uma oferta de nó reservado. 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"
   }
}

• Para obter detalhes da API, consulte PurchaseReservedNodeOfferingem Referência de AWS CLI Comandos.

purchase-reserved-node-offering

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

AWS CLI

O NodeThis exemplo de compra de um nó reservado mostra como comprar uma oferta de nó reservado. 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"
   }
}

• Para obter detalhes da API, consulte PurchaseReservedNodeOfferingem Referência de AWS CLI Comandos.

reboot-cluster

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

AWS CLI

Reinicialize um ClusterThis exemplo reinicializa 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 obter detalhes da API, consulte RebootClusterem Referência de AWS CLI Comandos.

reboot-cluster

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

AWS CLI

Reinicialize um ClusterThis exemplo reinicializa 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 obter detalhes da API, consulte RebootClusterem Referência de AWS CLI Comandos.

reset-cluster-parameter-group

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

AWS CLI

Redefinir parâmetros em um GroupThis exemplo de parâmetro 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

• Para obter detalhes da API, consulte ResetClusterParameterGroupem Referência de AWS CLI Comandos.

reset-cluster-parameter-group

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

AWS CLI

Redefinir parâmetros em um GroupThis exemplo de parâmetro 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

• Para obter detalhes da API, consulte ResetClusterParameterGroupem Referência de AWS CLI Comandos.

resize-cluster

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 obter detalhes da API, consulte ResizeClusterem Referência de AWS CLI Comandos.

resize-cluster

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 obter detalhes da API, consulte ResizeClusterem Referência de AWS CLI Comandos.

restore-from-cluster-snapshot

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

AWS CLI

Restaurar um cluster A partir de um SnapshotThis exemplo restaura um cluster a partir 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"
   }
}

• Para obter detalhes da API, consulte RestoreFromClusterSnapshotem Referência de AWS CLI Comandos.

restore-from-cluster-snapshot

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

AWS CLI

Restaurar um cluster A partir de um SnapshotThis exemplo restaura um cluster a partir 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"
   }
}

• Para obter detalhes da API, consulte RestoreFromClusterSnapshotem Referência de AWS CLI Comandos.

restore-table-from-cluster-snapshot

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.

• Para obter detalhes da API, consulte RestoreTableFromClusterSnapshotem Referência de AWS CLI Comandos.

restore-table-from-cluster-snapshot

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.

• Para obter detalhes da API, consulte RestoreTableFromClusterSnapshotem Referência de AWS CLI Comandos.

revoke-cluster-security-group-ingress

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

AWS CLI

Revogar o acesso de um GroupThis exemplo de EC2 segurança revoga o acesso a um grupo de EC2 segurança da Amazon 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

• Para obter detalhes da API, consulte RevokeClusterSecurityGroupIngressem Referência de AWS CLI Comandos.

revoke-cluster-security-group-ingress

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

AWS CLI

Revogar o acesso de um GroupThis exemplo de EC2 segurança revoga o acesso a um grupo de EC2 segurança da Amazon 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

• Para obter detalhes da API, consulte RevokeClusterSecurityGroupIngressem Referência de AWS CLI Comandos.

revoke-snapshot-access

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

AWS CLI

Revogar a autorização de uma AWS conta para restaurar um SnapshotThis exemplo revoga a autorização da AWS conta 444455556666 para restaurar o snapshot. my-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"
   }
}

• Para obter detalhes da API, consulte RevokeSnapshotAccessem Referência de AWS CLI Comandos.

revoke-snapshot-access

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

AWS CLI

Revogar a autorização de uma AWS conta para restaurar um SnapshotThis exemplo revoga a autorização da AWS conta 444455556666 para restaurar o snapshot. my-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"
   }
}

• Para obter detalhes da API, consulte RevokeSnapshotAccessem Referência de AWS CLI Comandos.

rotate-encryption-key

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 obter detalhes da API, consulte RotateEncryptionKeyem Referência de AWS CLI Comandos.

rotate-encryption-key

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 obter detalhes da API, consulte RotateEncryptionKeyem Referência de AWS CLI Comandos.