Amazon Redshift Redshift-Beispiele mit AWS CLI

So akzeptieren Sie den Austausch reservierter Knoten

Das folgende accept-reserved-node-exchange Beispiel akzeptiert den Austausch eines DC1 reservierten Knotens gegen einen DC2 reservierten Knoten.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Upgrading Reserved Nodes with the AWS CLI im Amazon Redshift Cluster Management Guide.

Ein GroupThis Beispiel für die Autorisierung des Zugriffs auf eine EC2 Sicherheitsgruppe autorisiert den Zugriff auf eine benannte EC2 Amazon-Sicherheitsgruppe.Befehl:

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

Autorisieren des Zugriffs auf einen CIDR-BereichIn diesem Beispiel wird der Zugriff auf einen CIDR-Bereich autorisiert.Befehl:

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

Ein AWS Konto zur Wiederherstellung autorisieren Ein SnapshotThis Beispiel autorisiert das AWS Konto444455556666, den Snapshot wiederherzustellen. my-snapshot-id JSON ist das Standardausgabeformat. Befehl:

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

Ergebnis:

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

So löschen Sie einen Cluster-Snapshot-Satz

Im folgenden Beispiel für batch-delete-cluster-snapshots wird ein Satz manueller Cluster-Snapshots gelöscht.

aws redshift batch-delete-cluster-snapshots \
        --identifiers SnapshotIdentifier=mycluster-2019-11-06-14-12 SnapshotIdentifier=mycluster-2019-11-06-14-20

Ausgabe:

{
    "Resources": [
        "mycluster-2019-11-06-14-12",
        "mycluster-2019-11-06-14-20"
    ]
}

Weitere Informationen finden Sie unter Amazon-Redshift-Snapshots im Verwaltungshandbuch für Amazon Redshift Cluster.

So ändern Sie einen Satz von Cluster-Snapshots

Im folgenden Beispiel für batch-modify-cluster-snapshots werden die Einstellungen für einen Satz von Cluster-Snapshots geändert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Amazon-Redshift-Snapshots im Verwaltungshandbuch für Amazon Redshift Cluster.

So brechen Sie die Größenänderung eines Clusters ab

Im folgenden Beispiel für cancel-resize wird eine klassische Größenänderungsoperation für einen Cluster abgebrochen.

aws redshift cancel-resize \
    --cluster-identifier mycluster

Ausgabe:

{
    "TargetNodeType": "dc2.large",
    "TargetNumberOfNodes": 2,
    "TargetClusterType": "multi-node",
    "Status": "CANCELLING",
    "ResizeType": "ClassicResize",
    "TargetEncryptionType": "NONE"
}

Weitere Informationen finden Sie unter Größenanpassung von Clustern in Amazon Redshift im Clusterverwaltungshandbuch für Amazon Redshift.

Das VersionsThis Beispiel Get a Description of All Cluster gibt eine Beschreibung aller Clusterversionen zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift copy-cluster-snapshot --source-snapshot-identifier cm:examplecluster-2013-01-22-19-27-58 --target-snapshot-identifier my-saved-snapshot-copy

Ergebnis:

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

Das GroupThis Beispiel „Cluster-Parameter erstellen“ erstellt eine neue Cluster-Parametergruppe.Command:

aws redshift create-cluster-parameter-group --parameter-group-name myclusterparametergroup --parameter-group-family redshift-1.0 --description "My first cluster parameter group"

Ergebnis:

{
   "ClusterParameterGroup": {
      "ParameterGroupFamily": "redshift-1.0",
      "Description": "My first cluster parameter group",
      "ParameterGroupName": "myclusterparametergroup"
   },
   "ResponseMetadata": {
      "RequestId": "739448f0-64cc-11e2-8f7d-3b939af52818"
   }
}

Durch das Erstellen eines GroupThis Beispiels für Clustersicherheit wird eine neue Clustersicherheitsgruppe erstellt. JSON ist das Standardausgabeformat. Befehl:

aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group"

Ergebnis:

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

Sie können dieselben Informationen auch mit der folgenden --output text Option im Textformat abrufen:

--output textOption.Befehl:

Option.Befehl:

aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group" --output text

Ergebnis:

This is my cluster security group   300454760768    mysecuritygroup
a0c0bfab-343a-11e2-95d2-c3dc9fe8ab57

Das SnapshotThis Beispiel „Cluster erstellen“ erstellt einen neuen Cluster-Snapshot. JSON ist das Standardausgabeformat. Befehl:

aws redshift create-cluster-snapshot --cluster-identifier mycluster --snapshot-identifier my-snapshot-id

Ergebnis:

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

Das GroupThis Beispiel „Cluster-Subnetz erstellen“ erstellt eine neue Cluster-Subnetzgruppe. Befehl:

aws redshift create-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup  --description "My subnet group" --subnet-ids subnet-763fdd1c

Ergebnis:

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

Das ParametersThis Beispiel Create a Cluster with Minimal erstellt einen Cluster mit einem minimalen Parametersatz. JSON ist das Standardausgabeformat. Befehl:

aws redshift create-cluster --node-type dw.hs1.xlarge --number-of-nodes 2 --master-username adminuser --master-user-password TopSecret1 --cluster-identifier mycluster

Ergebnis:

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

So erstellen Sie ein Benachrichtigungsabonnement für ein Ereignis

Im folgenden Beispiel für create-event-subscription wird ein Benachrichtigungsabonnement für ein Ereignis erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

Um ein HSM-Client-Zertifikat zu erstellen

Im folgenden Beispiel für create-hsm-client-certificate wird ein HSM-Client-Zertifikat generiert, das ein Cluster verwenden kann, um eine Verbindung zu einem HSM herzustellen.

aws redshift create-hsm-client-certificate \
    --hsm-client-certificate-identifier myhsmclientcert

Ausgabe:

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

Weitere Informationen finden Sie unter Referenz für API-Berechtigungen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So erstellen Sie eine HSM-Konfiguration

Im folgenden Beispiel für create-hsm-configuration wird die angegebene HSM-Konfiguration erstellt, die Informationen enthält, die ein Cluster benötigt, um Datenbank-Verschlüsselungsschlüssel in einem Hardware-Sicherheitsmodul (HSM) zu speichern und zu verwenden.

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

Ausgabe:

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

So erstellen Sie eine Kopiergenehmigung für Snapshots

Im folgenden create-snapshot-copy-grant Beispiel wird ein Snapshot-Kopierzuschuss erstellt und kopierte Snapshots in einer AWS Zielregion verschlüsselt.

aws redshift create-snapshot-copy-grant \
    --snapshot-copy-grant-name mysnapshotcopygrantname

Ausgabe:

{
    "SnapshotCopyGrant": {
        "SnapshotCopyGrantName": "mysnapshotcopygrantname",
        "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
        "Tags": []
    }
}

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So erstellen Sie einen Snapshot-Zeitplan

Im folgenden Beispiel für create-snapshot-schedule wird ein Snapshot-Zeitplan mit der angegebenen Beschreibung und einer Intervallrate von 12 Stunden erstellt.

aws redshift create-snapshot-schedule \
    --schedule-definitions "rate(12 hours)" \
    --schedule-identifier mysnapshotschedule \
    --schedule-description "My schedule description"

Ausgabe:

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

Weitere Informationen finden Sie unter Zeitpläne für automatisierte Snapshots im Verwaltungshandbuch für Amazon Redshift Cluster.

So erstellen Sie Tags für einen Cluster

Im folgenden create-tags Beispiel wird das angegebene key/value Tag-Paar dem angegebenen Cluster hinzugefügt.

aws redshift create-tags \
    --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
    --tags "Key"="mytags","Value"="tag1"

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Markieren von Ressourcen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

Das GroupThis Beispiel „Einen Cluster-Parameter löschen“ löscht eine Cluster-Parametergruppe.Command:

aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup

Beim Löschen eines GroupThis Clustersicherheitsbeispiels wird eine Cluster-Sicherheitsgruppe gelöscht.Befehl:

aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup

Das SnapshotThis Beispiel zum Löschen eines Clusters löscht einen Cluster-Snapshot.Command:

aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id

Das GroupThis Beispiel „Ein Cluster-Subnetz löschen“ löscht eine Cluster-Subnetzgruppe. Befehl:

aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup

Ergebnis:

{
   "ResponseMetadata": {
      "RequestId": "253fbffd-6993-11e2-bc3a-47431073908a"
   }
}

Das SnapshotThis Beispiel „Cluster ohne endgültigen Cluster löschen“ löscht einen Cluster und erzwingt das Löschen von Daten, sodass kein endgültiger Cluster-Snapshot erstellt wird.Befehl:

aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot

Das SnapshotThis Beispiel „Cluster löschen, einen finalen Cluster zulassen“ löscht einen Cluster, gibt aber einen endgültigen Cluster-Snapshot an.Befehl:

aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot

So löschen Sie ein Ereignisabonnement

Im folgenden Beispiel für delete-event-subscription wird das angegebene Benachrichtigungsabonnement für ein Ereignis gelöscht.

aws redshift delete-event-subscription \
    --subscription-name mysubscription

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So löschen Sie ein HSM-Clientzertifikat

Im folgenden Beispiel für delete-hsm-client-certificate wird ein HSM-Clientzertifikat gelöscht.

aws redshift delete-hsm-client-certificate \
    --hsm-client-certificate-identifier myhsmclientcert

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Referenz für API-Berechtigungen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So löschen Sie eine HSM-Konfiguration

Im folgenden delete-hsm-configuration Beispiel wird die angegebene HSM-Konfiguration aus dem aktuellen AWS Konto gelöscht.

aws redshift delete-hsm-configuration /
    --hsm-configuration-identifier myhsmconnection

Dieser Befehl erzeugt keine Ausgabe.

So löschen Sie eine geplante Aktion

Der folgende delete-scheduled-action-Befehl löscht die angegebene geplante Aktion.

aws redshift delete-scheduled-action \
    --scheduled-action-name myscheduledaction

Dieser Befehl erzeugt keine Ausgabe.

So löschen Sie eine Erteilung zum Kopieren von Snapshots

Im folgenden Beispiel für delete-snapshot-copy-grant wird die angegebene Erteilung zum Kopieren von Snapshots gelöscht.

aws redshift delete-snapshot-copy-grant \
    --snapshot-copy-grant-name mysnapshotcopygrantname

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So löschen Sie den Snapshot-Zeitplan

Im folgenden Beispiel für delete-snapshot-schedule wird der angegebene Snapshot-Zeitplan gelöscht. Sie müssen die Cluster-Zuordnung aufheben, bevor Sie den Zeitplan löschen können.

aws redshift delete-snapshot-schedule \
    --schedule-identifier mysnapshotschedule

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Zeitpläne für automatisierte Snapshots im Verwaltungshandbuch für Amazon Redshift Cluster.

So löschen Sie Tags aus einem Cluster

Im folgenden Beispiel für delete-tags werden die Tags mit den angegebenen Schlüsselnamen aus dem angegebenen Cluster gelöscht.

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

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Markieren von Ressourcen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

Um die Attribute eines AWS Kontos zu beschreiben

Im folgenden describe-account-attributes Beispiel werden die Attribute angezeigt, die dem anrufenden AWS Konto zugeordnet sind.

aws redshift describe-account-attributes

Ausgabe:

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

So beschreiben Sie DB-Revisionen für einen Cluster

Im folgenden Beispiel für describe-cluster-db-revisions werden die Details eines Arrays von ClusterDbRevision-Objekten für den angegebenen Cluster angezeigt.

aws redshift describe-cluster-db-revisions \
    --cluster-identifier mycluster

Ausgabe:

{
    "ClusterDbRevisions": [
        {
            "ClusterIdentifier": "mycluster",
            "CurrentDatabaseRevision": "11420",
            "DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z",
            "RevisionTargets": []
        }
    ]
}

Das GroupsThis Beispiel „Beschreibung aller Clusterparameter abrufen“ gibt eine Beschreibung aller Cluster-Parametergruppen für das Konto mit Spaltenüberschriften zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-parameter-groups

Ergebnis:

{
   "ParameterGroups": [
      {
         "ParameterGroupFamily": "redshift-1.0",
         "Description": "My first cluster parameter group",
         "ParameterGroupName": "myclusterparametergroup"
      } ],
   "ResponseMetadata": {
      "RequestId": "8ceb8f6f-64cc-11e2-bea9-49e0ce183f07"
   }
}

Sie können dieselben Informationen auch mit der folgenden --output text Option im Textformat abrufen:

--output textOption.Befehl:

Option.Befehl:

aws redshift describe-cluster-parameter-groups --output text

Ergebnis:

redshift-1.0        My first cluster parameter group        myclusterparametergroup
RESPONSEMETADATA    9e665a36-64cc-11e2-8f7d-3b939af52818

Das GroupThis Beispiel „Parameter für einen angegebenen Clusterparameter abrufen“ ruft die Parameter für die benannte Parametergruppe ab. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup

Ergebnis:

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

Sie können dieselben Informationen auch mit der folgenden --output text Option im Textformat abrufen:

--output textOption.Befehl:

Option.Befehl:

aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup --output text

Ergebnis:

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

Das GroupsThis Beispiel Get a Description of All Cluster Security gibt eine Beschreibung aller Clustersicherheitsgruppen für das Konto zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-security-groups

Ergebnis:

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

Das SnapshotsThis Beispiel Get a Description of All Cluster gibt eine Beschreibung aller Cluster-Snapshots für das Konto zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-snapshots

Ergebnis:

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

Das GroupsThis Beispiel Get a Description of All Cluster Subnet gibt eine Beschreibung aller Cluster-Subnetzgruppen zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-subnet-groups

Ergebnis:

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

So beschreiben Sie Cluster-Tracks

Im folgenden Beispiel für describe-cluster-tracks werden Details zu den verfügbaren Wartungspfaden angezeigt.

aws redshift describe-cluster-tracks \
    --maintenance-track-name current

Ausgabe:

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

Weitere Informationen finden Sie unter Auswählen der Cluster-Wartungspfade im Clusterverwaltungshandbuch für Amazon Redshift.

Das VersionsThis Beispiel Get a Description of All Cluster gibt eine Beschreibung aller Clusterversionen zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-versions

Ergebnis:

{
   "ClusterVersions": [
      {
      "ClusterVersion": "1.0",
      "Description": "Initial release",
      "ClusterParameterGroupFamily": "redshift-1.0"
      } ],
   "ResponseMetadata": {
      "RequestId": "16a53de3-64cc-11e2-bec0-17624ad140dd"
   }
}

Das ClustersThis Beispiel „Get a Description of All“ gibt eine Beschreibung aller Cluster für das Konto zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-clusters

Ergebnis:

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

Sie können dieselben Informationen auch mit der folgenden --output text Option im Textformat abrufen:

--output textOption.Befehl:

Option.Befehl:

aws redshift describe-clusters --output text

Ergebnis:

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

Das ParametersThis Beispiel „Beschreibung des Standard-Clusters abrufen“ gibt eine Beschreibung der Standard-Clusterparameter für die redshift-1.0 Familie zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-default-cluster-parameters --parameter-group-family redshift-1.0

Ergebnis:

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

Führen Sie den describe-cluster-parameter-groups-Befehl aus, um eine Liste der gültigen Parametergruppenfamilien anzuzeigen.

describe-cluster-parameter-groups-Befehl.

Befehl.

So beschreiben Sie Ereigniskategorien für einen Cluster

Im folgenden Beispiel für describe-event-categories werden Details zu den Ereigniskategorien für einen Cluster angezeigt.

aws redshift describe-event-categories \
    --source-type cluster

Ausgabe:

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

So beschreiben Sie Ereignisabonnements

Im folgenden Beispiel für describe-event-subscriptions werden Ereignisbenachrichtigungsabonnements für das angegebene Abonnement angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

Beschreiben aller EreignisseDieses Beispiel gibt alle Ereignisse zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-events

Ergebnis:

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

Sie können dieselben Informationen auch mit der folgenden --output text Option im Textformat abrufen:

--output textOption.Befehl:

Option.Befehl:

aws redshift describe-events --output text

Ergebnis:

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

So beschreiben Sie HSM-Clientzertifikate

Im folgenden Beispiel für describe-hsm-client-certificates werden die Details für das angegebene HSM-Clientzertifikat angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Referenz für API-Berechtigungen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So beschreiben Sie HSM-Konfigurationen

Im folgenden describe-hsm-configurations Beispiel werden Details zu den verfügbaren HSM-Konfigurationen für das anrufende AWS Konto angezeigt.

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

Ausgabe:

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

So beschreiben Sie den Protokollierungsstatus für einen Cluster

Im folgenden Beispiel für describe-logging-status wird angezeigt, ob Informationen wie Abfragen und Verbindungsversuche für einen Cluster protokolliert werden.

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

Ausgabe:

{
    "LoggingEnabled": false
}

Weitere Informationen finden Sie unter Datenbank-Auditprotokollierung im Verwaltungshandbuch für Amazon Redshift Cluster.

So beschreiben Sie Knotenkonfigurationsoptionen

Im folgenden Beispiel für describe-node-configuration-options werden die Eigenschaften möglicher Knotenkonfigurationen wie Knotentyp, Anzahl der Knoten und Festplattenbelegung für den angegebenen Cluster-Snapshot angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Kaufen reservierter Amazon-Redshift-Knoten im Verwaltungshandbuch für Amazon Redshift Cluster.

Das OptionsThis Beispiel Describing All Orderable Cluster gibt Beschreibungen aller bestellbaren Cluster-Optionen zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-orderable-cluster-options

Ergebnis:

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

Sie können dieselben Informationen auch mit der folgenden --output text Option im Textformat abrufen:

--output textOption.Befehl:

Option.Befehl:

aws redshift describe-orderable-cluster-options --output text

Ergebnis:

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

Das OfferingsThis Beispiel Describe Reserved Node zeigt alle Angebote für reservierte Knoten, die käuflich erworben werden können.Command:

aws redshift describe-reserved-node-offerings

Ergebnis:

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

Wenn Sie ein Angebot für reservierte Knoten erwerben möchten, können Sie purchase-reserved-node-offering mit einem gültigen Kennwort anrufen. ReservedNodeOfferingId

purchase-reserved-node-offeringmit einem gültigen ReservedNodeOfferingId.

unter Verwendung eines gültigen ReservedNodeOfferingId.

ReservedNodeOfferingId.

.

Das NodesThis Beispiel Describe Reserved zeigt ein Angebot für reservierte Knoten, das gekauft wurde. Befehl:

aws redshift describe-reserved-nodes

Ergebnis:

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

Das ResizeThis Beschreibungsbeispiel beschreibt die letzte Größenänderung eines Clusters. Die Anfrage betraf 3 Knoten des Typs dw.hs1.8xlarge.Command:

aws redshift describe-resize --cluster-identifier mycluster

Ergebnis:

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

So beschreiben Sie geplante Aktionen

Im folgenden Beispiel für describe-scheduled-actions werden Details zu allen derzeit geplanten Aktionen angezeigt.

aws redshift describe-scheduled-actions

Ausgabe:

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

So beschreiben Sie Erteilungen zum Kopieren von Snapshots

Im folgenden Beispiel für describe-snapshot-copy-grants werden die Details für die angegebene Erteilung zum Kopieren von Snapshots angezeigt.

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

Ausgabe:

{
    "SnapshotCopyGrants": [
        {
            "SnapshotCopyGrantName": "mysnapshotcopygrantname",
            "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
            "Tags": []
        }
    ]
}

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So beschreiben Sie Snapshot-Zeitpläne

Im folgenden Beispiel für describe-snapshot-schedules werden die Details für den angegebenen Cluster-Snapshot-Zeitplan angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Zeitpläne für automatisierte Snapshots im Verwaltungshandbuch für Amazon Redshift Cluster.

So beschreiben Sie den Speicher

Im folgenden Beispiel für describe-storage werden Details zum Backup-Speicher und zu den vorläufigen Speichergrößen für das Konto angezeigt.

aws redshift describe-storage

Ausgabe:

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

Weitere Informationen finden Sie unter Verwalten der Snapshot-Speicherung im Verwaltungshandbuch für Amazon Redshift Cluster.

So beschreiben Sie den Status von Anfragen zur Tabellenwiederherstellung aus einem Cluster-Snapshot

Im folgenden Beispiel für describe-table-restore-status werden Details zu Anfragen zur Tabellenwiederherstellung angezeigt, die für den angegebenen Cluster gestellt wurden.

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

Ausgabe:

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

Weitere Informationen zu diesen Konfigurationen finden Sie unter Wiederherstellen einer Tabelle aus einem Snapshot im Verwaltungshandbuch für Amazon Redshift Cluster.

So beschreiben Sie Tags

Im folgenden Beispiel für describe-tags werden die Ressourcen angezeigt, die der angegebene Cluster den angegebenen Tag-Namen und Werten zugeordnet hat.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Markieren von Ressourcen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So deaktivieren Sie Snapshot-Kopien für einen Cluster

Im folgenden Beispiel für disable-snapshot-copy wird das automatische Kopieren eines Snapshots für den angegebenen Cluster deaktiviert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Kopieren von Snapshots in eine andere AWS Region im Amazon Redshift Cluster Management Guide.

So aktivieren Sie das Kopieren von Snapshots für einen Cluster

Das folgende enable-snapshot-copy-Beispiel aktiviert das automatische Kopieren eines Snapshots für den angegebenen Cluster.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Kopieren von Snapshots in eine andere AWS Region im Amazon Redshift Cluster Management Guide.

Um Cluster-Anmeldeinformationen für ein AWS Konto abzurufen

Im folgenden Beispiel für get-cluster-credentials werden temporäre Anmeldeinformationen abgerufen, die den Zugriff auf eine Amazon-Redshift-Datenbank ermöglichen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen von IAM-Datenbank-Anmeldeinformationen mithilfe der Amazon-Redshift-CLI oder -API im Verwaltungshandbuch für Amazon Redshift Cluster.

So erhalten Sie Angebote für den Austausch reservierter Knoten

Im folgenden Beispiel für get-reserved-node-exchange-offerings wird ein Array von DC2-ReservedNodeOfferings abgerufen, das dem angegebenen reservierten Knoten von DC1 entspricht.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Upgrading Reserved Nodes with the AWS CLI im Amazon Redshift Cluster Management Guide.

So ändern Sie die IAM-Rolle für einen Cluster

Im folgenden modify-cluster-iam-roles Beispiel wird die angegebene AWS IAM-Rolle aus dem angegebenen Cluster entfernt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwenden von identitätsbasierten Richtlinien (IAM-Richtlinien) für Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So ändern Sie die Cluster-Wartung

Im folgenden Beispiel für modify-cluster-maintenance wird die Wartung des angegebenen Clusters um 30 Tage verschoben.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Cluster-Verwaltung im Verwaltungshandbuch für Amazon Redshift Cluster.

So ändern Sie Parameter in einer Parametergruppe

Im folgenden Beispiel modify-cluster-parameter-group wird der wlm_json_configuration-Parameter für die Workload-Verwaltung geändert. Es werden die Parameter aus einer Datei akzeptiert, die den unten gezeigten JSON-Inhalt enthält.

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

Inhalt von modify_pg.json:

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

Ausgabe:

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

So ändern Sie den Cluster-Snapshot-Zeitplan

Im folgenden Beispiel für modify-cluster-snapshot-schedule wird der angegebene Snapshot-Zeitplan aus dem angegebenen Cluster entfernt.

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

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Zeitpläne für automatisierte Snapshots im Verwaltungshandbuch für Amazon Redshift Cluster.

So ändern Sie den Cluster-Snapshot

Im folgenden Beispiel für modify-cluster-snapshot wird die Einstellung für den manuellen Aufbewahrungszeitraum für den angegebenen Cluster-Snapshot auf den Wert von 10 Tagen festgelegt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Amazon-Redshift-Snapshots im Verwaltungshandbuch für Amazon Redshift Cluster.

Das GroupThis Beispiel „Subnetze in einem Cluster-Subnetz ändern“ zeigt, wie die Liste der Subnetze in einer Cache-Subnetzgruppe geändert wird. JSON ist das Standardausgabeformat. Befehl:

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

Ergebnis:

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

Die Zuordnung einer Sicherheitsgruppe zu einem ClusterThis Beispiel zeigt, wie eine Cluster-Sicherheitsgruppe mit dem angegebenen Cluster verknüpft wird.Command:

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

Das Wartungsfenster ändern für ClusterThis zeigt, wie das bevorzugte wöchentliche Wartungsfenster für einen Cluster so geändert werden kann, dass es mindestens vier Stunden dauert und sonntags um 23:15 Uhr beginnt und montags um 3:15 Uhr endet. Befehl:

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

Das Master-Passwort ändern Das ClusterThis Beispiel zeigt, wie das Master-Passwort für einen Cluster geändert wird. Befehl:

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

So ändern Sie ein Ereignisabonnement

Im folgenden Beispiel für modify-event-subscription wird das angegebene Abonnement für Ereignisbenachrichtigungen deaktiviert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.

So ändern Sie eine geplante Aktion

Im folgenden Beispiel für modify-scheduled-action wird der angegebenen vorhandenen geplanten Aktion eine Beschreibung hinzugefügt.

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

Ausgabe:

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

So ändern Sie den Aufbewahrungszeitraums für Snapshot-Kopien

Im folgenden modify-snapshot-copy-retention-period Beispiel wird die Anzahl der Tage geändert, für die Snapshots für den angegebenen Cluster in der AWS Zielregion aufbewahrt werden, nachdem sie aus der AWS Quellregion kopiert wurden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Format von Snapshot-Zeitplänen im Verwaltungshandbuch für Amazon Redshift Cluster.

So ändern Sie den Snapshot-Zeitplan

Im folgenden Beispiel für modify-snapshot-schedule wird die Rate des angegebenen Snapshot-Zeitplans auf alle 10 Stunden geändert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Format von Snapshot-Zeitplänen im Verwaltungshandbuch für Amazon Redshift Cluster.

Das NodeThis Beispiel Purchase a Reserved zeigt, wie Sie ein Angebot für reservierte Knoten erwerben. reserved-node-offering-id wird durch Aufrufen von describe-reserved-node-offerings erhalten. Befehl:

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

Ergebnis:

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

Ein ClusterThis Beispiel für einen Neustart startet einen Cluster neu. JSON ist das Standardausgabeformat. Befehl:

aws redshift reboot-cluster --cluster-identifier mycluster

Ergebnis:

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

Das GroupThis Beispiel „Parameter in einem Parameter zurücksetzen“ zeigt, wie alle Parameter in einer Parametergruppe zurückgesetzt werden. Befehl:

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

So passen Sie die Größe eines Clusters

Im folgenden Beispiel für resize-cluster wird die Größe des angegebenen Clusters geändert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Größenanpassung eines Clusters im Verwaltungshandbuch für Amazon Redshift Cluster.

Einen Cluster anhand eines SnapshotThis Beispiels wiederherstellen stellt einen Cluster aus einem Snapshot wiederher.Command:

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

Ergebnis:

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

So stellen Sie einen Cluster mithilfe eines Snapshots wieder her

Im folgenden Beispiel für restore-table-from-cluster-snapshot wird aus der angegebenen Tabelle im angegebenen Cluster-Snapshot eine neue Tabelle erstellt.

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

Ausgabe:

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

Weitere Informationen zu diesen Konfigurationen finden Sie unter Wiederherstellen einer Tabelle aus einem Snapshot im Verwaltungshandbuch für Amazon Redshift Cluster.

Revoke Access from an EC2 Security GroupThis example widerruft den Zugriff auf eine benannte EC2 Amazon-Sicherheitsgruppe.Befehl:

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

Zugriff auf einen CIDR-Bereich widerrufenIn diesem Beispiel wird der Zugriff auf einen CIDR-Bereich widerrufen.Befehl:

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

Die Autorisierung eines AWS Kontos zur Wiederherstellung widerrufen Ein SnapshotThis Beispiel widerruft die Autorisierung des AWS Kontos 444455556666 zur Wiederherstellung des Snapshotsmy-snapshot-id. JSON ist das Standardausgabeformat. Befehl:

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

Ergebnis:

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

So rotieren Sie die Verschlüsselungscodes für einen Cluster

Im folgenden Beispiel für rotate-encryption-key wird der Verschlüsselungsschlüssel für den angegebenen Cluster rotiert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Verwaltungshandbuch für Amazon Redshift Cluster.