Amazon-RDS-Beispiele unter Verwendung von AWS CLI - AWS Command Line Interface
Aktionen

Amazon-RDS-Beispiele unter Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie das AWS Command Line Interface mit Amazon RDS nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie add-option-to-option-group verwendet wird.

AWS CLI

So fügen Sie eine Option zu einer Optionsgruppe hinzu

Im folgenden Beispiel für add-option-to-option-group wird eine Option zu einer angegebenen Optionsgruppe hinzugefügt.

aws rds add-option-to-option-group \
    --option-group-name myoptiongroup \
    --options OptionName=OEM,Port=5500,DBSecurityGroupMemberships=default \
    --apply-immediately

Ausgabe:

{
    "OptionGroup": {
        "OptionGroupName": "myoptiongroup",
        "OptionGroupDescription": "Test Option Group",
        "EngineName": "oracle-ee",
        "MajorEngineVersion": "12.1",
        "Options": [
            {
                "OptionName": "Timezone",
                "OptionDescription": "Change time zone",
                "Persistent": true,
                "Permanent": false,
                "OptionSettings": [
                    {
                        "Name": "TIME_ZONE",
                        "Value": "Australia/Sydney",
                        "DefaultValue": "UTC",
                        "Description": "Specifies the timezone the user wants to change the system time to",
                        "ApplyType": "DYNAMIC",
                        "DataType": "STRING",
                        "AllowedValues": "Africa/Cairo,Africa/Casablanca,Africa/Harare,Africa/Lagos,Africa/Luanda,Africa/Monrovia,Africa/Nairobi,Africa/Tripoli,Africa/Windhoek,America/Araguaina,America/Argentina/Buenos_Aires,America/Asuncion,America/Bogota,America/Caracas,America/Chicago,America/Chihuahua,America/Cuiaba,America/Denver,America/Detroit,America/Fortaleza,America/Godthab,America/Guatemala,America/Halifax,America/Lima,America/Los_Angeles,America/Manaus,America/Matamoros,America/Mexico_City,America/Monterrey,America/Montevideo,America/New_York,America/Phoenix,America/Santiago,America/Sao_Paulo,America/Tijuana,America/Toronto,Asia/Amman,Asia/Ashgabat,Asia/Baghdad,Asia/Baku,Asia/Bangkok,Asia/Beirut,Asia/Calcutta,Asia/Damascus,Asia/Dhaka,Asia/Hong_Kong,Asia/Irkutsk,Asia/Jakarta,Asia/Jerusalem,Asia/Kabul,Asia/Karachi,Asia/Kathmandu,Asia/Kolkata,Asia/Krasnoyarsk,Asia/Magadan,Asia/Manila,Asia/Muscat,Asia/Novosibirsk,Asia/Rangoon,Asia/Riyadh,Asia/Seoul,Asia/Shanghai,Asia/Singapore,Asia/Taipei,Asia/Tehran,Asia/Tokyo,Asia/Ulaanbaatar,Asia/Vladivostok,Asia/Yakutsk,Asia/Yerevan,Atlantic/Azores,Atlantic/Cape_Verde,Australia/Adelaide,Australia/Brisbane,Australia/Darwin,Australia/Eucla,Australia/Hobart,Australia/Lord_Howe,Australia/Perth,Australia/Sydney,Brazil/DeNoronha,Brazil/East,Canada/Newfoundland,Canada/Saskatchewan,Etc/GMT-3,Europe/Amsterdam,Europe/Athens,Europe/Berlin,Europe/Dublin,Europe/Helsinki,Europe/Kaliningrad,Europe/London,Europe/Madrid,Europe/Moscow,Europe/Paris,Europe/Prague,Europe/Rome,Europe/Sarajevo,Pacific/Apia,Pacific/Auckland,Pacific/Chatham,Pacific/Fiji,Pacific/Guam,Pacific/Honolulu,Pacific/Kiritimati,Pacific/Marquesas,Pacific/Samoa,Pacific/Tongatapu,Pacific/Wake,US/Alaska,US/Central,US/East-Indiana,US/Eastern,US/Pacific,UTC",
                        "IsModifiable": true,
                        "IsCollection": false
                    }
                ],
                "DBSecurityGroupMemberships": [],
                "VpcSecurityGroupMemberships": []
            },
            {
                "OptionName": "OEM",
                "OptionDescription": "Oracle 12c EM Express",
                "Persistent": false,
                "Permanent": false,
                "Port": 5500,
                "OptionSettings": [],
                "DBSecurityGroupMemberships": [
                    {
                        "DBSecurityGroupName": "default",
                        "Status": "authorized"
                    }
                ],
                "VpcSecurityGroupMemberships": []
            }
        ],
        "AllowsVpcAndNonVpcInstanceMemberships": false,
        "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup"
    }
}

Weitere Informationen finden Sie unter Hinzufügen einer Option zu einer Optionsgruppe im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie add-role-to-db-cluster verwendet wird.

AWS CLI

So ordnen Sie eine AWS-Identity and Access Management (IAM)-Rolle einem DB-Cluster zu

Im folgenden Beispiel für add-role-to-db-cluster wird eine Rolle einem DB-Cluster zugeordnet.

aws rds add-role-to-db-cluster \
    --db-cluster-identifier mydbcluster \
    --role-arn arn:aws:iam::123456789012:role/RDSLoadFromS3

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Zuweisen einer IAM-Rolle zu einem Amazon-Aurora-MySQL DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie add-role-to-db-instance verwendet wird.

AWS CLI

So ordnen Sie eine AWS-Identity and Access Management (IAM)-Rolle einer DB-Instance zu

Im folgenden Beispiel für add-role-to-db-instance wird die Rolle zu einer Oracle-DB-Instance mit dem Namen test-instance hinzugefügt.

aws rds add-role-to-db-instance \
    --db-instance-identifier test-instance \
    --feature-name S3_INTEGRATION \
    --role-arn arn:aws:iam::111122223333:role/rds-s3-integration-role

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Voraussetzungen für die Amazon-RDS-Oracle-Integration mit Amazon S3 im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie add-source-identifier-to-subscription verwendet wird.

AWS CLI

So fügen Sie einem Abonnement eine Quell-ID hinzu

Im folgenden Beispiel für add-source-identifier wird eine weitere Quell-ID zu einem vorhandenen Abonnement hinzugefügt.

aws rds add-source-identifier-to-subscription \
    --subscription-name my-instance-events \
    --source-identifier test-instance-repl

Ausgabe:

{
    "EventSubscription": {
        "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
        "CustSubscriptionId": "my-instance-events",
        "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
        "Enabled": false,
        "Status": "modifying",
        "EventCategoriesList": [
            "backup",
            "recovery"
        ],
        "CustomerAwsId": "123456789012",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
        "SourceType": "db-instance",
        "SourceIdsList": [
            "test-instance",
            "test-instance-repl"
        ]
    }
}

Das folgende Codebeispiel zeigt, wie add-tags-to-resource verwendet wird.

AWS CLI

So fügen Sie einer Ressource Tags hinzu

Im folgenden Beispiel für add-tags-to-resource werden einer RDS-Datenbank Tags hinzugefügt.

aws rds add-tags-to-resource \
    --resource-name arn:aws:rds:us-east-1:123456789012:db:database-mysql \
    --tags "[{\"Key\": \"Name\",\"Value\": \"MyDatabase\"},{\"Key\": \"Environment\",\"Value\": \"test\"}]"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Hinzufügen von Tags zu Amazon-EKS-Ressourcen im Entwicklerhandbuch zu Amazon EKS.

Das folgende Codebeispiel zeigt, wie apply-pending-maintenance-action verwendet wird.

AWS CLI

So führen Sie ausstehende Wartungsaktionen durch

Im folgenden Beispiel für apply-pending-maintenance-action werden anstehende Wartungsaktionen für ein DB-Cluster angewendet.

aws rds apply-pending-maintenance-action \
    --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster \
    --apply-action system-update \
    --opt-in-type immediate

Ausgabe:

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster",
        "PendingMaintenanceActionDetails": [
            {
                "Action": "system-update",
                "OptInStatus": "immediate",
                "CurrentApplyDate": "2021-01-23T01:07:36.100Z",
                "Description": "Upgrade to Aurora PostgreSQL 3.3.2"
            }
        ]
    }
}

Weitere Informationen finden Sie unter Wartung einer DB-Instance im Benutzerhandbuch zu Amazon RDS und unter Wartung eines Amazon-Aurora-DB-Clusters im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie authorize-db-security-group-ingress verwendet wird.

AWS CLI

So ordnen Sie eine AWS-Identity and Access Management (IAM)-Rolle einer DB-Instance zu

Im folgenden Beispiel für authorize-db-security-group-ingress wird die Standardsicherheitsgruppe mit einer Eingangsregel für den CIDR-IP-Bereich 192.0.2.0/24 konfiguriert.

aws rds authorize-db-security-group-ingress \
    --db-security-group-name default \
    --cidrip 192.0.2.0/24

Ausgabe:

{
    "DBSecurityGroup": {
        "OwnerId": "123456789012",
        "DBSecurityGroupName": "default",
        "DBSecurityGroupDescription": "default",
        "EC2SecurityGroups": [],
        "IPRanges": [
            {
                "Status": "authorizing",
                "CIDRIP": "192.0.2.0/24"
            }
        ],
        "DBSecurityGroupArn": "arn:aws:rds:us-east-1:111122223333:secgrp:default"
    }
}

Weitere Informationen finden Sie unter Autorisieren des Netzwerkzugriffs auf eine DB-Sicherheitsgruppe von einem IP-Bereich aus im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie backtrack-db-cluster verwendet wird.

AWS CLI

Rückverfolgen eines Aurora-DB-Clusters

Im folgenden Beispiel für backtrack-db-cluster wird eine Rückverfolgung des DB-Clusters auf den 19. März 2018 um 10:00 Uhr durchgeführt.

aws rds backtrack-db-cluster --db-cluster-identifier sample-cluster --backtrack-to 2018-03-19T10:00:00+00:00

Dieser Befehl gibt einen JSON-Block aus, der die Änderung an der RDS-Ressource bestätigt.

Das folgende Codebeispiel zeigt, wie cancel-export-task verwendet wird.

AWS CLI

So exportieren Sie einen Snapshot nach Amazon S3

Im folgenden Beispiel für cancel-export-task wird eine laufende Exportaufgabe abgebrochen, bei der ein Snapshot nach Amazon S3 exportiert wird.

aws rds cancel-export-task \
    --export-task-identifier my-s3-export-1

Ausgabe:

{
    "ExportTaskIdentifier": "my-s3-export-1",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:snapshot:publisher-final-snapshot",
    "SnapshotTime": "2019-03-24T20:01:09.815Z",
    "S3Bucket": "amzn-s3-demo-bucket",
    "S3Prefix": "",
    "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/export-snap-S3-role",
    "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/abcd0000-7bfd-4594-af38-aabbccddeeff",
    "Status": "CANCELING",
    "PercentProgress": 0,
    "TotalExtractedDataInGB": 0
}

Weitere Informationen finden Sie unter Abbrechen einer Snapshot-Exportaufgabe im Benutzerhandbuch zu Amazon RDS oder unter Abbrechen einer Snapshot-Exportaufgabe im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie copy-db-cluster-parameter-group verwendet wird.

AWS CLI

So kopieren Sie eine DB-Cluster-Parametergruppe

Im folgenden Beispiel für copy-db-cluster-parameter-group wird eine Kopie einer DB-Cluster-Parametergruppe erstellt.

aws rds copy-db-cluster-parameter-group \
    --source-db-cluster-parameter-group-identifier mydbclusterpg \
    --target-db-cluster-parameter-group-identifier mydbclusterpgcopy \
    --target-db-cluster-parameter-group-description "Copy of mydbclusterpg parameter group"

Ausgabe:

{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterpgcopy",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy",
        "DBParameterGroupFamily": "aurora-mysql5.7",
        "Description": "Copy of mydbclusterpg parameter group"
    }
}

Weitere Informationen finden Sie unter Kopieren einer DB-Cluster-Parametergruppe im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie copy-db-cluster-snapshot verwendet wird.

AWS CLI

So kopieren Sie einen DB-Cluster-Snapshot

Im folgenden Beispiel für copy-db-cluster-snapshot wird eine Kopie eines DB-Cluster-Snapshots einschließlich seiner Tags erstellt.

aws rds copy-db-cluster-snapshot \
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:myaurora-2019-06-04-09-16
    --target-db-cluster-snapshot-identifier myclustersnapshotcopy \
    --copy-tags

Ausgabe:

{
    "DBClusterSnapshot": {
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1e"
        ],
        "DBClusterSnapshotIdentifier": "myclustersnapshotcopy",
        "DBClusterIdentifier": "myaurora",
        "SnapshotCreateTime": "2019-06-04T09:16:42.649Z",
        "Engine": "aurora-mysql",
        "AllocatedStorage": 0,
        "Status": "available",
        "Port": 0,
        "VpcId": "vpc-6594f31c",
        "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
        "MasterUsername": "myadmin",
        "EngineVersion": "5.7.mysql_aurora.2.04.2",
        "LicenseModel": "aurora-mysql",
        "SnapshotType": "manual",
        "PercentProgress": 100,
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:myclustersnapshotcopy",
        "IAMDatabaseAuthenticationEnabled": false
    }
}

Weitere Informationen finden Sie unter Kopieren eines Snapshots im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie copy-db-parameter-group verwendet wird.

AWS CLI

So kopieren Sie eine DB-Cluster-Parametergruppe

Im folgenden Beispiel für copy-db-parameter-group wird eine Kopie einer DB-Parametergruppe erstellt.

aws rds copy-db-parameter-group \
    --source-db-parameter-group-identifier mydbpg \
    --target-db-parameter-group-identifier mydbpgcopy \
    --target-db-parameter-group-description "Copy of mydbpg parameter group"

Ausgabe:

{
    "DBParameterGroup": {
        "DBParameterGroupName": "mydbpgcopy",
        "DBParameterGroupArn": "arn:aws:rds:us-east-1:814387698303:pg:mydbpgcopy",
        "DBParameterGroupFamily": "mysql5.7",
        "Description": "Copy of mydbpg parameter group"
    }
}

Weitere Informationen finden Sie unter Kopieren einer DB-Parametergruppe im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie copy-db-snapshot verwendet wird.

AWS CLI

So kopieren Sie einen DB-Snapshot

Im folgenden Beispiel für copy-db-snapshot wird eine Kopie eines DB-Snapshots erstellt.

aws rds copy-db-snapshot \
    --source-db-snapshot-identifier rds:database-mysql-2019-06-06-08-38
    --target-db-snapshot-identifier mydbsnapshotcopy

Ausgabe:

{
    "DBSnapshot": {
        "VpcId": "vpc-6594f31c",
        "Status": "creating",
        "Encrypted": true,
        "SourceDBSnapshotIdentifier": "arn:aws:rds:us-east-1:123456789012:snapshot:rds:database-mysql-2019-06-06-08-38",
        "MasterUsername": "admin",
        "Iops": 1000,
        "Port": 3306,
        "LicenseModel": "general-public-license",
        "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshotcopy",
        "EngineVersion": "5.6.40",
        "OptionGroupName": "default:mysql-5-6",
        "ProcessorFeatures": [],
        "Engine": "mysql",
        "StorageType": "io1",
        "DbiResourceId": "db-ZI7UJ5BLKMBYFGX7FDENCKADC4",
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
        "SnapshotType": "manual",
        "IAMDatabaseAuthenticationEnabled": false,
        "SourceRegion": "us-east-1",
        "DBInstanceIdentifier": "database-mysql",
        "InstanceCreateTime": "2019-04-30T15:45:53.663Z",
        "AvailabilityZone": "us-east-1f",
        "PercentProgress": 0,
        "AllocatedStorage": 100,
        "DBSnapshotIdentifier": "mydbsnapshotcopy"
    }
}

Weitere Informationen finden Sie unter Kopieren eines Snapshots im Benutzerhandbuch zu Amazon RDS.

  • API-Details finden Sie unter CopyDbSnapshot in der AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie copy-option-group verwendet wird.

AWS CLI

So kopieren Sie eine Optionsgruppe

Im folgenden Beispiel für copy-option-group wird eine Kopie einer Optionsgruppe erstellt.

aws rds copy-option-group \
    --source-option-group-identifier myoptiongroup \
    --target-option-group-identifier new-option-group \
    --target-option-group-description "My option group copy"

Ausgabe:

{
    "OptionGroup": {
        "Options": [],
        "OptionGroupName": "new-option-group",
        "MajorEngineVersion": "11.2",
        "OptionGroupDescription": "My option group copy",
        "AllowsVpcAndNonVpcInstanceMemberships": true,
        "EngineName": "oracle-ee",
        "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:new-option-group"
    }
}

Weitere Informationen finden Sie unter Kopie einer Optionsgruppe erstellen im Benutzerhandbuch zu Amazon RDS.

  • API-Details finden Sie unter CopyOptionGroup in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-blue-green-deployment verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie eine Blau/Grün-Bereitstellung für eine DB-Instance von RDS für MySQL

Im folgenden Beispiel für create-blue-green-deployment wird eine Blau/Grün-Bereitstellung für eine MySQL-DB-Instance erstellt.

aws rds create-blue-green-deployment \
    --blue-green-deployment-name bgd-cli-test-instance \
    --source arn:aws:rds:us-east-1:123456789012:db:my-db-instance \
    --target-engine-version 8.0 \
    --target-db-parameter-group-name mysql-80-group

Ausgabe:

{
    "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
        "BlueGreenDeploymentName": "bgd-cli-test-instance",
        "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
        "SwitchoverDetails": [
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3"
            }
        ],
        "Tasks": [
            {
                "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                "Status": "PENDING"
            },
            {
                "Name": "DB_ENGINE_VERSION_UPGRADE",
                "Status": "PENDING"
            },
            {
                "Name": "CONFIGURE_BACKUPS",
                "Status": "PENDING"
            },
            {
                "Name": "CREATING_TOPOLOGY_OF_SOURCE",
                "Status": "PENDING"
            }
        ],
        "Status": "PROVISIONING",
        "CreateTime": "2022-02-25T21:18:51.183000+00:00"
    }
}

Weitere Informationen finden Sie unter Erstellen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So erstellen Sie eine Blau/Grün-Bereitstellung für einen Aurora-MySQL-DB-Cluster

Im folgenden Beispiel für create-blue-green-deployment wird eine Blau/Grün-Bereitstellung für ein MySQL-DB-Cluster erstellt.

aws rds create-blue-green-deployment \
    --blue-green-deployment-name my-blue-green-deployment \
    --source arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster \
    --target-engine-version 8.0 \
    --target-db-cluster-parameter-group-name ams-80-binlog-enabled \
    --target-db-parameter-group-name mysql-80-cluster-group

Ausgabe:

{
      "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
        "BlueGreenDeploymentName": "my-blue-green-deployment",
        "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
        "SwitchoverDetails": [
          {
            "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
            "Status": "PROVISIONING"
          },
          {
            "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
            "Status": "PROVISIONING"
          },
          {
            "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
            "Status": "PROVISIONING"
          },
          {
            "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
            "Status": "PROVISIONING"
          },
          {
            "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
            "Status": "PROVISIONING"
          },
          {
            "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
            "Status": "PROVISIONING"
          }
        ],
        "Tasks": [
          {
            "Name": "CREATING_READ_REPLICA_OF_SOURCE",
            "Status": "PENDING"
          },
          {
            "Name": "DB_ENGINE_VERSION_UPGRADE",
            "Status": "PENDING"
          },
          {
            "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
            "Status": "PENDING"
          },
          {
            "Name": "CREATE_CUSTOM_ENDPOINTS",
            "Status": "PENDING"
          }
        ],
        "Status": "PROVISIONING",
        "CreateTime": "2022-02-25T21:12:00.288000+00:00"
      }
}

Weitere Informationen finden Sie unter Erstellen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie create-db-cluster-endpoint verwendet wird.

AWS CLI

So erstellen Sie einen benutzerdefinierten DB-Cluster-Endpunkt

Im folgenden Beispiel für create-db-cluster-endpoint wird ein benutzerdefinierter DB-Cluster-Endpunkt erstellt und dem angegebenen Aurora-DB-Cluster zugeordnet.

aws rds create-db-cluster-endpoint \
    --db-cluster-endpoint-identifier mycustomendpoint \
    --endpoint-type reader \
    --db-cluster-identifier mydbcluster \
    --static-members dbinstance1 dbinstance2

Ausgabe:

{
    "DBClusterEndpointIdentifier": "mycustomendpoint",
    "DBClusterIdentifier": "mydbcluster",
    "DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE",
    "Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com",
    "Status": "creating",
    "EndpointType": "CUSTOM",
    "CustomEndpointType": "READER",
    "StaticMembers": [
        "dbinstance1",
        "dbinstance2"
    ],
    "ExcludedMembers": [],
    "DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint"
}

Weitere Informationen finden Sie unter Verbindungsmanagement in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie create-db-cluster-parameter-group verwendet wird.

AWS CLI

So erstellen Sie eine DB-Cluster-Parametergruppe

Im folgenden Beispiel für create-db-cluster-parameter-group wird eine DB-Cluster-Parametergruppe erstellt.

aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family aurora5.6 \
    --description "My new cluster parameter group"

Ausgabe:

{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterparametergroup",
        "DBParameterGroupFamily": "aurora5.6",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
    }
}

Weitere Informationen finden Sie unter Erstellen einer DB-Cluster-Parametergruppe im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie create-db-cluster-snapshot verwendet wird.

AWS CLI

So erstellen Sie einen DB-Cluster-Snapshot

Im folgenden Beispiel für create-db-cluster-snapshot wird DB-Cluster--Snapshot erstellt.

aws rds create-db-cluster-snapshot \
    --db-cluster-identifier mydbcluster \
    --db-cluster-snapshot-identifier mydbclustersnapshot

Ausgabe:

{
    "DBClusterSnapshot": {
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1e"
        ],
        "DBClusterSnapshotIdentifier": "mydbclustersnapshot",
        "DBClusterIdentifier": "mydbcluster",
        "SnapshotCreateTime": "2019-06-18T21:21:00.469Z",
        "Engine": "aurora-mysql",
        "AllocatedStorage": 1,
        "Status": "creating",
        "Port": 0,
        "VpcId": "vpc-6594f31c",
        "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
        "MasterUsername": "myadmin",
        "EngineVersion": "5.7.mysql_aurora.2.04.2",
        "LicenseModel": "aurora-mysql",
        "SnapshotType": "manual",
        "PercentProgress": 0,
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:mydbclustersnapshot",
        "IAMDatabaseAuthenticationEnabled": false
    }
}

Weitere Informationen finden Sie unter Erstellen eines DB-Cluster-Snapshots im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie create-db-cluster verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie einen MySQL 5.7-kompatiblen DB-Cluster

Im folgenden Beispiel für create-db-cluster wird ein MySQL 5.7-kompatibles DB-Cluster unter Verwendung der Standard-Engine-Version erstellt. Ersetzen Sie das Beispielpasswort secret99 durch ein sicheres Passwort. Wenn Sie die Konsole für das Erstellen eines DB-Clusters verwenden, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihr DB-Cluster. Wenn Sie jedoch die AWS-CLI für das Erstellen eines DB-Clusters verwenden, müssen Sie die Writer-DB-Instance explizit für Ihr DB-Cluster mithilfe des CLI-Befehls create-db-instance AWS erstellen.

aws rds create-db-cluster \
    --db-cluster-identifier sample-cluster \
    --engine aurora-mysql \
    --engine-version 5.7 \
    --master-username admin \
    --master-user-password secret99 \
    --db-subnet-group-name default \
    --vpc-security-group-ids sg-0b9130572daf3dc16

Ausgabe:

{
    "DBCluster": {
        "DBSubnetGroup": "default",
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-0b9130572daf3dc16",
                "Status": "active"
            }
        ],
        "AllocatedStorage": 1,
        "AssociatedRoles": [],
        "PreferredBackupWindow": "09:12-09:42",
        "ClusterCreateTime": "2023-02-27T23:21:33.048Z",
        "DeletionProtection": false,
        "IAMDatabaseAuthenticationEnabled": false,
        "ReadReplicaIdentifiers": [],
        "EngineMode": "provisioned",
        "Engine": "aurora-mysql",
        "StorageEncrypted": false,
        "MultiAZ": false,
        "PreferredMaintenanceWindow": "mon:04:31-mon:05:01",
        "HttpEndpointEnabled": false,
        "BackupRetentionPeriod": 1,
        "DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE",
        "DBClusterIdentifier": "sample-cluster",
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1e"
        ],
        "MasterUsername": "master",
        "EngineVersion": "5.7.mysql_aurora.2.11.1",
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
        "DBClusterMembers": [],
        "Port": 3306,
        "Status": "creating",
        "Endpoint": "sample-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
        "DBClusterParameterGroup": "default.aurora-mysql5.7",
        "HostedZoneId": "Z2R2ITUGPM61AM",
        "ReaderEndpoint": "sample-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
        "CopyTagsToSnapshot": false
    }
}

Beispiel 2: So erstellen Sie ein PostgreSQL-kompatibles DB-Cluster

Im folgenden Beispiel für create-db-cluster wird ein PostgreSQL-kompatibles DB-Cluster unter Verwendung der Standard-Engine-Version erstellt. Ersetzen Sie das Beispielpasswort secret99 durch ein sicheres Passwort. Wenn Sie die Konsole für das Erstellen eines DB-Clusters verwenden, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihr DB-Cluster. Wenn Sie jedoch die AWS-CLI für das Erstellen eines DB-Clusters verwenden, müssen Sie die Writer-DB-Instance explizit für Ihr DB-Cluster mithilfe des CLI-Befehls create-db-instance AWS erstellen.

aws rds create-db-cluster \
    --db-cluster-identifier sample-pg-cluster \
    --engine aurora-postgresql \
    --master-username master \
    --master-user-password secret99 \
    --db-subnet-group-name default \
    --vpc-security-group-ids sg-0b9130572daf3dc16

Ausgabe:

{
    "DBCluster": {
        "Endpoint": "sample-pg-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
        "HttpEndpointEnabled": false,
        "DBClusterMembers": [],
        "EngineMode": "provisioned",
        "CopyTagsToSnapshot": false,
        "HostedZoneId": "Z2R2ITUGPM61AM",
        "IAMDatabaseAuthenticationEnabled": false,
        "AllocatedStorage": 1,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-0b9130572daf3dc16",
                "Status": "active"
            }
        ],
        "DeletionProtection": false,
        "StorageEncrypted": false,
        "BackupRetentionPeriod": 1,
        "PreferredBackupWindow": "09:56-10:26",
        "ClusterCreateTime": "2023-02-27T23:26:08.371Z",
        "DBClusterParameterGroup": "default.aurora-postgresql13",
        "EngineVersion": "13.7",
        "Engine": "aurora-postgresql",
        "Status": "creating",
        "DBClusterIdentifier": "sample-pg-cluster",
        "MultiAZ": false,
        "Port": 5432,
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-pg-cluster",
        "AssociatedRoles": [],
        "DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE",
        "PreferredMaintenanceWindow": "wed:03:33-wed:04:03",
        "ReaderEndpoint": "sample-pg-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
        "MasterUsername": "master",
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1c"
        ],
        "ReadReplicaIdentifiers": [],
        "DBSubnetGroup": "default"
    }
}

Weitere Informationen finden Sie unter Erstellen eines Amazon-Aurora-DB-Clusters im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter CreateDbCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-db-instance-read-replica verwendet wird.

AWS CLI

So erstellen Sie ein DB-Instance-Lesereplikat

In diesem Beispiel wird ein Lesereplikat einer vorhandenen DB-Instance namens test-instance erstellt. Das Lesereplikat heißt test-instance-repl.

aws rds create-db-instance-read-replica \
    --db-instance-identifier test-instance-repl \
    --source-db-instance-identifier test-instance

Ausgabe:

{
    "DBInstance": {
        "IAMDatabaseAuthenticationEnabled": false,
        "MonitoringInterval": 0,
        "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl",
        "ReadReplicaSourceDBInstanceIdentifier": "test-instance",
        "DBInstanceIdentifier": "test-instance-repl",
        ...some output truncated...
    }
}

Das folgende Codebeispiel zeigt, wie create-db-instance verwendet wird.

AWS CLI

So erstellen Sie eine DB-Instance

Im folgenden Beispiel für create-db-instance werden die zum Starten einer neuen DB-Instance erforderlichen Optionen verwendet.

aws rds create-db-instance \
    --db-instance-identifier test-mysql-instance \
    --db-instance-class db.t3.micro \
    --engine mysql \
    --master-username admin \
    --master-user-password secret99 \
    --allocated-storage 20

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "test-mysql-instance",
        "DBInstanceClass": "db.t3.micro",
        "Engine": "mysql",
        "DBInstanceStatus": "creating",
        "MasterUsername": "admin",
        "AllocatedStorage": 20,
        "PreferredBackupWindow": "12:55-13:25",
        "BackupRetentionPeriod": 1,
        "DBSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-12345abc",
                "Status": "active"
            }
        ],
        "DBParameterGroups": [
            {
                "DBParameterGroupName": "default.mysql5.7",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-2ff2ff2f",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2c"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2d"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sun:08:07-sun:08:37",
        "PendingModifiedValues": {
            "MasterUserPassword": "****"
        },
        "MultiAZ": false,
        "EngineVersion": "5.7.22",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "general-public-license",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "default:mysql-5-7",
                "Status": "in-sync"
            }
        ],
        "PubliclyAccessible": true,
        "StorageType": "gp2",
        "DbInstancePort": 0,
        "StorageEncrypted": false,
        "DbiResourceId": "db-5555EXAMPLE44444444EXAMPLE",
        "CACertificateIdentifier": "rds-ca-2019",
        "DomainMemberships": [],
        "CopyTagsToSnapshot": false,
        "MonitoringInterval": 0,
        "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:test-mysql-instance",
        "IAMDatabaseAuthenticationEnabled": false,
        "PerformanceInsightsEnabled": false,
        "DeletionProtection": false,
        "AssociatedRoles": []
    }
}

Weitere Informationen finden Sie unter Erstellen einer Amazon-RDS-DB-Instance im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie create-db-parameter-group verwendet wird.

AWS CLI

So erstellen Sie eine DB-Parametergruppe

Im folgenden Beispiel für create-db-parameter-group wird eine DB-Parametergruppe erstellt.

aws rds create-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family MySQL5.6 \
    --description "My new parameter group"

Ausgabe:

{
    "DBParameterGroup": {
        "DBParameterGroupName": "mydbparametergroup",
        "DBParameterGroupFamily": "mysql5.6",
        "Description": "My new parameter group",
        "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:mydbparametergroup"
    }
}

Weitere Informationen finden Sie unter Erstellen einer DB-Parametergruppe im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie create-db-proxy-endpoint verwendet wird.

AWS CLI

So erstellen Sie einen DB-Proxy-Endpunkt für eine RDS-Datenbank

Im folgenden Beispiel für create-db-proxy-endpoint wird ein DB-Proxy-Endpunkt erstellt.

aws rds create-db-proxy-endpoint \
    --db-proxy-name proxyExample \
    --db-proxy-endpoint-name "proxyep1" \
    --vpc-subnet-ids subnetgroup1 subnetgroup2

Ausgabe:

{
"DBProxyEndpoint": {
        "DBProxyEndpointName": "proxyep1",
        "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
        "DBProxyName": "proxyExample",
        "Status": "creating",
        "VpcId": "vpc-1234567",
        "VpcSecurityGroupIds": [
            "sg-1234",
            "sg-5678"
        ],
        "VpcSubnetIds": [
            "subnetgroup1",
            "subnetgroup2"
        ],
        "Endpoint": "proxyep1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
        "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
        "TargetRole": "READ_WRITE",
        "IsDefault": false
    }
}

Weitere Informationen finden Sie unter Erstellen eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon RDS und Erstellen eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie create-db-proxy verwendet wird.

AWS CLI

So erstellen Sie einen DB-Proxy für eine RDS-Datenbank

Im folgenden Beispiel für create-db-proxy wird ein DB-Proxy erstellt.

aws rds create-db-proxy \
    --db-proxy-name proxyExample \
    --engine-family MYSQL \
    --auth Description="proxydescription1",AuthScheme="SECRETS",SecretArn="arn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f",IAMAuth="DISABLED",ClientPasswordAuthType="MYSQL_NATIVE_PASSWORD" \
    --role-arn arn:aws:iam::123456789123:role/ProxyRole \
    --vpc-subnet-ids subnetgroup1 subnetgroup2

Ausgabe:

{
"DBProxy": {
        "DBProxyName": "proxyExample",
        "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
        "EngineFamily": "MYSQL",
        "VpcId": "vpc-1234567",
        "VpcSecuritytGroupIds": [
            "sg-1234",
            "sg-5678",
            "sg-9101"
        ],
        "VpcSubnetIds": [
            "subnetgroup1",
            "subnetgroup2"
        ],
        "Auth": "[
            {
                "Description": "proxydescription1",
                "AuthScheme": "SECRETS",
                "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e",
                "IAMAuth": "DISABLED"
            }
        ]",
        "RoleArn": "arn:aws:iam::12345678912:role/ProxyRole",
        "Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
        "RequireTLS": false,
        "IdleClientTimeout": 1800,
        "DebuggingLogging": false,
        "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
        "UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
    }
}

Weitere Informationen finden Sie unter Erstellen eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Erstellen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter CreateDbProxy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-db-security-group verwendet wird.

AWS CLI

So erstellen Sie eine Amazon-RDS-DB-Sicherheitsgruppe

Der folgende create-db-security-group-Befehl erstellt eine neue Amazon-RDS-DB-Sicherheitsgruppe:

aws rds create-db-security-group --db-security-group-name mysecgroup --db-security-group-description "My Test Security Group"

Im Beispiel heißt die neue DB-Sicherheitsgruppe mysecgroup und hat eine Beschreibung.

Ausgabe:

{
    "DBSecurityGroup": {
        "OwnerId": "123456789012",
        "DBSecurityGroupName": "mysecgroup",
        "DBSecurityGroupDescription": "My Test Security Group",
        "VpcId": "vpc-a1b2c3d4",
        "EC2SecurityGroups": [],
        "IPRanges": [],
        "DBSecurityGroupArn": "arn:aws:rds:us-west-2:123456789012:secgrp:mysecgroup"
    }
}

Das folgende Codebeispiel zeigt, wie create-db-shard-group verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie ein primäres Aurora PostgreSQL-DB-Cluster

Im folgenden Beispiel für create-db-cluster wird ein primäres Aurora PostgreSQL SQL-DB-Cluster erstellt, das mit Aurora Serverless v2 und Aurora Limitless Database kompatibel ist.

aws rds create-db-cluster \
    --db-cluster-identifier my-sv2-cluster \
    --engine aurora-postgresql \
    --engine-version 15.2-limitless \
    --storage-type aurora-iopt1 \
    --serverless-v2-scaling-configuration MinCapacity=2,MaxCapacity=16 \
    --enable-limitless-database \
    --master-username myuser \
    --master-user-password mypassword \
    --enable-cloudwatch-logs-exports postgresql

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-east-2b",
            "us-east-2c",
            "us-east-2a"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "my-sv2-cluster",
        "DBClusterParameterGroup": "default.aurora-postgresql15",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "my-sv2-cluster.cluster-cekycexample.us-east-2.rds.amazonaws.com",
        "ReaderEndpoint": "my-sv2-cluster.cluster-ro-cekycexample.us-east-2.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-postgresql",
        "EngineVersion": "15.2-limitless",
        "Port": 5432,
        "MasterUsername": "myuser",
        "PreferredBackupWindow": "06:05-06:35",
        "PreferredMaintenanceWindow": "mon:08:25-mon:08:55",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z2XHWR1EXAMPLE",
        "StorageEncrypted": false,
        "DbClusterResourceId": "cluster-XYEDT6ML6FHIXH4Q2J1EXAMPLE",
        "DBClusterArn": "arn:aws:rds:us-east-2:123456789012:cluster:my-sv2-cluster",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "ClusterCreateTime": "2024-02-19T16:24:07.771000+00:00",
        "EnabledCloudwatchLogsExports": [
            "postgresql"
        ],
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": false,
        "CrossAccountClone": false,
        "DomainMemberships": [],
        "TagList": [],
        "StorageType": "aurora-iopt1",
        "AutoMinorVersionUpgrade": true,
        "ServerlessV2ScalingConfiguration": {
            "MinCapacity": 2.0,
            "MaxCapacity": 16.0
        },
        "NetworkType": "IPV4",
        "IOOptimizedNextAllowedModificationTime": "2024-03-21T16:24:07.781000+00:00",
        "LimitlessDatabase": {
            "Status": "not-in-use",
            "MinRequiredACU": 96.0
        }
    }
}

Beispiel 2: So erstellen Sie die primäre (Writer-) DB-Instance

Im folgenden Beispiel für create-db-instance wird eine primäre (Writer-) DB-Instance mit Aurora Serverless v2 erstellt. Wenn Sie die Konsole für das Erstellen eines DB-Clusters verwenden, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihr DB-Cluster. Wenn Sie jedoch die AWS-CLI für das Erstellen eines DB-Clusters verwenden, müssen Sie die Writer-DB-Instance explizit für Ihr DB-Cluster mithilfe des CLI-Befehls create-db-instance AWS erstellen.

aws rds create-db-instance \
    --db-instance-identifier my-sv2-instance \
    --db-cluster-identifier my-sv2-cluster \
    --engine aurora-postgresql \
    --db-instance-class db.serverless

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "my-sv2-instance",
        "DBInstanceClass": "db.serverless",
        "Engine": "aurora-postgresql",
        "DBInstanceStatus": "creating",
        "MasterUsername": "myuser",
        "AllocatedStorage": 1,
        "PreferredBackupWindow": "06:05-06:35",
        "BackupRetentionPeriod": 1,
        "DBSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "DBParameterGroups": [
            {
                "DBParameterGroupName": "default.aurora-postgresql15",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-########",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-2c"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-2a"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-2b"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "fri:09:01-fri:09:31",
        "PendingModifiedValues": {
            "PendingCloudwatchLogsExports": {
                "LogTypesToEnable": [
                    "postgresql"
                ]
            }
        },
        "MultiAZ": false,
        "EngineVersion": "15.2-limitless",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "postgresql-license",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "default:aurora-postgresql-15",
                "Status": "in-sync"
            }
        ],
        "PubliclyAccessible": false,
        "StorageType": "aurora-iopt1",
        "DbInstancePort": 0,
        "DBClusterIdentifier": "my-sv2-cluster",
        "StorageEncrypted": false,
        "DbiResourceId": "db-BIQTE3B3K3RM7M74SK5EXAMPLE",
        "CACertificateIdentifier": "rds-ca-rsa2048-g1",
        "DomainMemberships": [],
        "CopyTagsToSnapshot": false,
        "MonitoringInterval": 0,
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:us-east-2:123456789012:db:my-sv2-instance",
        "IAMDatabaseAuthenticationEnabled": false,
        "PerformanceInsightsEnabled": false,
        "DeletionProtection": false,
        "AssociatedRoles": [],
        "TagList": [],
        "CustomerOwnedIpEnabled": false,
        "BackupTarget": "region",
        "NetworkType": "IPV4",
        "StorageThroughput": 0,
        "CertificateDetails": {
            "CAIdentifier": "rds-ca-rsa2048-g1"
        },
        "DedicatedLogVolume": false
    }
}

Beispiel 3: So erstellen Sie die DB-Shard-Gruppe

Im folgenden Beispiel für create-db-shard-group wird eine DB-Shard-Gruppe in Ihrem primären DB-Cluster mit Aurora-PostgreSQL erstellt.

aws rds create-db-shard-group \
    --db-shard-group-identifier my-db-shard-group \
    --db-cluster-identifier my-sv2-cluster \
    --max-acu 768

Ausgabe:

{
    "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
    "DBShardGroupIdentifier": "my-db-shard-group",
    "DBClusterIdentifier": "my-sv2-cluster",
    "MaxACU": 768.0,
    "ComputeRedundancy": 0,
    "Status": "creating",
    "PubliclyAccessible": false,
    "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}

Weitere Informationen finden Sie unter Verwenden von Amazon Aurora Serverless v2 im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie create-db-snapshot verwendet wird.

AWS CLI

So erstellen Sie einen DB-Snapshot

Im folgenden Beispiel für create-db-snapshot wird ein Upgrade für einen DB-Snapshot ausgeführt.

aws rds create-db-snapshot \
    --db-instance-identifier database-mysql \
    --db-snapshot-identifier mydbsnapshot

Ausgabe:

{
    "DBSnapshot": {
        "DBSnapshotIdentifier": "mydbsnapshot",
        "DBInstanceIdentifier": "database-mysql",
        "Engine": "mysql",
        "AllocatedStorage": 100,
        "Status": "creating",
        "Port": 3306,
        "AvailabilityZone": "us-east-1b",
        "VpcId": "vpc-6594f31c",
        "InstanceCreateTime": "2019-04-30T15:45:53.663Z",
        "MasterUsername": "admin",
        "EngineVersion": "5.6.40",
        "LicenseModel": "general-public-license",
        "SnapshotType": "manual",
        "Iops": 1000,
        "OptionGroupName": "default:mysql-5-6",
        "PercentProgress": 0,
        "StorageType": "io1",
        "Encrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
        "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot",
        "IAMDatabaseAuthenticationEnabled": false,
        "ProcessorFeatures": [],
        "DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE"
    }
}

Weitere Informationen finden Sie unter Erstellen eines DB-Snapshots im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie create-db-subnet-group verwendet wird.

AWS CLI

Erstellen einer DB-Sicherheitsgruppe

Im folgenden Beispiel für create-db-subnet-group wird unter Verwendung vorhandener Subnetze eine DB-Subnetzgruppe namens mysubnetgroup erstellt.

aws rds create-db-subnet-group \
    --db-subnet-group-name mysubnetgroup \
    --db-subnet-group-description "test DB subnet group" \
    --subnet-ids '["subnet-0a1dc4e1a6f123456","subnet-070dd7ecb3aaaaaaa","subnet-00f5b198bc0abcdef"]'

Ausgabe:

{
    "DBSubnetGroup": {
        "DBSubnetGroupName": "mysubnetgroup",
        "DBSubnetGroupDescription": "test DB subnet group",
        "VpcId": "vpc-0f08e7610a1b2c3d4",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-070dd7ecb3aaaaaaa",
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2b"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-00f5b198bc0abcdef",
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2d"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-0a1dc4e1a6f123456",
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2b"
                },
                "SubnetStatus": "Active"
            }
        ],
        "DBSubnetGroupArn": "arn:aws:rds:us-west-2:0123456789012:subgrp:mysubnetgroup"
    }
}

Weitere Informationen finden Sie unter Erstellen einer DB-Instance in einer VPC im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie create-event-subscription verwendet wird.

AWS CLI

So erstellen Sie ein Ereignisabonnement

Im folgenden Beispiel für create-event-subscription wird ein Abonnement für Backup- und Wiederherstellungsereignisse in DB-Instances im aktuellen AWS-Konto erstellt. Benachrichtigungen werden an ein von --sns-topic-arn vorgegebenes Thema des Amazon Simple Notification Service gesendet.

aws rds create-event-subscription \
    --subscription-name my-instance-events \
    --source-type db-instance \
    --event-categories '["backup","recovery"]' \
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:interesting-events

Ausgabe:

{
    "EventSubscription": {
        "Status": "creating",
        "CustSubscriptionId": "my-instance-events",
        "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
        "EventCategoriesList": [
            "backup",
            "recovery"
        ],
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
        "CustomerAwsId": "123456789012",
        "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
        "SourceType": "db-instance",
        "Enabled": true
    }
}

Das folgende Codebeispiel zeigt, wie create-global-cluster verwendet wird.

AWS CLI

So erstellen Sie einen globalen DB-Cluster

Im folgenden Beispiel für create-global-cluster wird ein neuer Aurora MySQL-kompatibler globaler DB-Cluster erstellt.

aws rds create-global-cluster \
    --global-cluster-identifier myglobalcluster \
    --engine aurora-mysql

Ausgabe:

{
    "GlobalCluster": {
        "GlobalClusterIdentifier": "myglobalcluster",
        "GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
        "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
        "Status": "available",
        "Engine": "aurora-mysql",
        "EngineVersion": "5.7.mysql_aurora.2.07.2",
        "StorageEncrypted": false,
        "DeletionProtection": false,
        "GlobalClusterMembers": []
    }
}

Weitere Informationen finden Sie unter Erstellen einer Aurora Global Database im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie create-option-group verwendet wird.

AWS CLI

So erstellen Sie eine Amazon-RDS-Optionsgruppe

Der folgende create-option-group-Befehl erstellt eine neue Amazon-RDS-Optionsgruppe für Oracle Enterprise Edition Version 11.2`, is named ``MyOptionGroup und enthält eine Beschreibung.

aws rds create-option-group \
    --option-group-name MyOptionGroup \
    --engine-name oracle-ee \
    --major-engine-version 11.2 \
    --option-group-description "Oracle Database Manager Database Control"

Ausgabe:

{
    "OptionGroup": {
        "OptionGroupName": "myoptiongroup",
        "OptionGroupDescription": "Oracle Database Manager Database Control",
        "EngineName": "oracle-ee",
        "MajorEngineVersion": "11.2",
        "Options": [],
        "AllowsVpcAndNonVpcInstanceMemberships": true,
        "OptionGroupArn": "arn:aws:rds:us-west-2:123456789012:og:myoptiongroup"
    }
}

Das folgende Codebeispiel zeigt, wie delete-blue-green-deployment verwendet wird.

AWS CLI

Beispiel 1: So löschen Sie Ressourcen in der grünen Umgebung für eine DB-Instance von RDS für MySQL

Im folgenden Beispiel für delete-blue-green-deployment werden die Ressourcen in einer grünen Umgebung für eine DB-Instance von RDS für MySQL-DB gelöscht.

aws rds delete-blue-green-deployment \
    --blue-green-deployment-identifier bgd-v53303651eexfake \
    --delete-target

Ausgabe:

{
    "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
        "BlueGreenDeploymentName": "bgd-cli-test-instance",
        "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
        "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
        "SwitchoverDetails": [
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-j382ha",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ejv4ao",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-vlpz3t",
                "Status": "AVAILABLE"
            }
        ],
        "Tasks": [
            {
                "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                "Status": "COMPLETED"
            },
            {
                "Name": "DB_ENGINE_VERSION_UPGRADE",
                "Status": "COMPLETED"
            },
            {
                "Name": "CONFIGURE_BACKUPS",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATING_TOPOLOGY_OF_SOURCE",
                "Status": "COMPLETED"
            }
        ],
        "Status": "DELETING",
        "CreateTime": "2022-02-25T21:18:51.183000+00:00",
        "DeleteTime": "2022-02-25T22:25:31.331000+00:00"
    }
}

Weitere Informationen finden Sie unter Löschen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So löschen Sie Ressourcen in einer grünen Umgebung für einen Aurora MySQL-DB-Cluster

Im folgenden Beispiel für delete-blue-green-deployment werden die Ressourcen in einer grünen Umgebung für einen Aurora MySQL-DB-Cluster gelöscht.

aws rds delete-blue-green-deployment \
    --blue-green-deployment-identifier bgd-wi89nwzglccsfake \
    --delete-target

Ausgabe:

{
    "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
        "BlueGreenDeploymentName": "my-blue-green-deployment",
        "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
        "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
        "SwitchoverDetails": [
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg",
                "Status": "AVAILABLE"
            }
        ],
        "Tasks": [
            {
                "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                "Status": "COMPLETED"
            },
            {
                "Name": "DB_ENGINE_VERSION_UPGRADE",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATE_CUSTOM_ENDPOINTS",
                "Status": "COMPLETED"
            }
        ],
        "Status": "DELETING",
        "CreateTime": "2022-02-25T21:12:00.288000+00:00",
        "DeleteTime": "2022-02-25T22:29:11.336000+00:00"
    }
}

Weitere Informationen finden Sie unter Löschen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie delete-db-cluster-endpoint verwendet wird.

AWS CLI

So löschen Sie einen benutzerdefinierten DB-Cluster-Endpunkt

Im folgenden Beispiel für delete-db-cluster-endpoint wird der angegebene benutzerdefinierte DB-Cluster-Endpunkt gelöscht.

aws rds delete-db-cluster-endpoint \
    --db-cluster-endpoint-identifier mycustomendpoint

Ausgabe:

{
    "DBClusterEndpointIdentifier": "mycustomendpoint",
    "DBClusterIdentifier": "mydbcluster",
    "DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE",
    "Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com",
    "Status": "deleting",
    "EndpointType": "CUSTOM",
    "CustomEndpointType": "READER",
    "StaticMembers": [
        "dbinstance1",
        "dbinstance2",
        "dbinstance3"
    ],
    "ExcludedMembers": [],
    "DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint"
}

Weitere Informationen finden Sie unter Verbindungsmanagement in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie delete-db-cluster-parameter-group verwendet wird.

AWS CLI

So löschen Sie eine DB-Cluster-Parametergruppe

Im folgenden Beispiel für delete-db-cluster-parameter-group wird die angegebene DB-Cluster-Parametergruppe gelöscht.

aws rds delete-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie delete-db-cluster-snapshot verwendet wird.

AWS CLI

So löschen Sie einen DB-Cluster-Snapshot

Im folgenden Beispiel für delete-db-cluster-snapshot wird der angegebene Cluster-Snapshot gelöscht.

aws rds delete-db-cluster-snapshot \
    --db-cluster-snapshot-identifier mydbclustersnapshot

Ausgabe:

{
    "DBClusterSnapshot": {
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1e"
        ],
        "DBClusterSnapshotIdentifier": "mydbclustersnapshot",
        "DBClusterIdentifier": "mydbcluster",
        "SnapshotCreateTime": "2019-06-18T21:21:00.469Z",
        "Engine": "aurora-mysql",
        "AllocatedStorage": 0,
        "Status": "available",
        "Port": 0,
        "VpcId": "vpc-6594f31c",
        "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
        "MasterUsername": "myadmin",
        "EngineVersion": "5.7.mysql_aurora.2.04.2",
        "LicenseModel": "aurora-mysql",
        "SnapshotType": "manual",
        "PercentProgress": 100,
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:mydbclustersnapshot",
        "IAMDatabaseAuthenticationEnabled": false
    }
}

Weitere Informationen finden Sie unter Löschen eines Snapshots im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie delete-db-cluster verwendet wird.

AWS CLI

Beispiel 1: So löschen Sie eine DB-Instance in einem DB-Cluster

Im folgenden Beispiel für delete-db-instance wird die letzte DB-Instance in einem DB-Cluster gelöscht. Sie können einen DB-Cluster nicht löschen, wenn er DB-Instances enthält, die sich nicht im Status Löschvorgang läuft befinden. Sie können keinen endgültigen Snapshot erstellen, während Sie eine DB-Instance in einem DB-Cluster löschen.

aws rds delete-db-instance \
    --db-instance-identifier database-3

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "database-3",
        "DBInstanceClass": "db.r4.large",
        "Engine": "aurora-postgresql",
        "DBInstanceStatus": "deleting",

    ...output omitted...

    }
}

Weitere Informationen finden Sie unter Löschen einer DB-Instance in einem Aurora DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Beispiel 2: So löschen Sie einen DB-Cluster

Im folgenden Beispiel für delete-db-cluster wird der DB-Cluster namens mycluster gelöscht, und es wird ein letzter Snapshot mit dem Namen mycluster-final-snapshot erstellt. Der Status des DB-Clusters ist verfügbar, während der Snapshot erstellt wird. Verwenden Sie den describe-db-clusters-CLI-Befehl, um den Fortschritt des Löschvorgangs zu verfolgen.

aws rds delete-db-cluster \
    --db-cluster-identifier mycluster \
    --no-skip-final-snapshot \
    --final-db-snapshot-identifier mycluster-final-snapshot

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 20,
        "AvailabilityZones": [
            "eu-central-1b",
            "eu-central-1c",
            "eu-central-1a"
        ],
        "BackupRetentionPeriod": 7,
        "DBClusterIdentifier": "mycluster",
        "DBClusterParameterGroup": "default.aurora-postgresql10",
        "DBSubnetGroup": "default-vpc-aa11bb22",
        "Status": "available",

    ...output omitted...

    }
}

Weitere Informationen finden Sie unter Aurora-Cluster mit einer einzelnen DB-Instance im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter DeleteDbCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-db-instance-automated-backup verwendet wird.

AWS CLI

So löschen Sie ein repliziertes automatisiertes Backup aus einer Region

Im folgenden Beispiel für delete-db-instance-automated-backup wird der automatisierte Backup mit dem angegebenen Amazon-Ressourcennamen (ARN) gelöscht.

aws rds delete-db-instance-automated-backup \
    --db-instance-automated-backups-arn "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"

Ausgabe:

{
    "DBInstanceAutomatedBackup": {
        "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
        "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
        "Region": "us-east-1",
        "DBInstanceIdentifier": "new-orcl-db",
        "RestoreWindow": {},
        "AllocatedStorage": 20,
        "Status": "deleting",
        "Port": 1521,
        "AvailabilityZone": "us-east-1b",
        "VpcId": "vpc-########",
        "InstanceCreateTime": "2020-12-04T15:28:31Z",
        "MasterUsername": "admin",
        "Engine": "oracle-se2",
        "EngineVersion": "12.1.0.2.v21",
        "LicenseModel": "bring-your-own-license",
        "OptionGroupName": "default:oracle-se2-12-1",
        "Encrypted": false,
        "StorageType": "gp2",
        "IAMDatabaseAuthenticationEnabled": false,
        "BackupRetentionPeriod": 7,
        "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
    }
}

Weitere Informationen finden Sie unter Löschen von replizierten Backups im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie delete-db-instance verwendet wird.

AWS CLI

So löschen Sie eine DB-Instance

Im folgenden Beispiel für delete-db-instance wird die angegebene DB-Instance gelöscht, nachdem der letzte DB-Snapshot test-instance-final-snap erstellt wurde.

aws rds delete-db-instance \
    --db-instance-identifier test-instance \
    --final-db-snapshot-identifier test-instance-final-snap

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "test-instance",
        "DBInstanceStatus": "deleting",
        ...some output truncated...
    }
}

Das folgende Codebeispiel zeigt, wie delete-db-parameter-group verwendet wird.

AWS CLI

So löschen Sie eine DB-Parametergruppe

Im folgenden Beispiel für command wird eine DB-Parametergruppe gelöscht.

aws rds delete-db-parameter-group \
    --db-parameter-group-name mydbparametergroup

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie delete-db-proxy-endpoint verwendet wird.

AWS CLI

So löschen Sie einen DB-Proxy-Endpunkt für eine RDS-Datenbank

Im folgenden Beispiel für delete-db-proxy-endpoint wird ein DB-Proxy-Endpunkt für die Zieldatenbank gelöscht.

aws rds delete-db-proxy-endpoint \
    --db-proxy-endpoint-name proxyEP1

Ausgabe:

{
"DBProxyEndpoint":
    {
        "DBProxyEndpointName": "proxyEP1",
        "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
        "DBProxyName": "proxyExample",
        "Status": "deleting",
        "VpcId": "vpc-1234567",
        "VpcSecurityGroupIds": [
            "sg-1234",
            "sg-5678"
        ],
        "VpcSubnetIds": [
            "subnetgroup1",
            "subnetgroup2"
        ],
        "Endpoint": "proxyEP1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
        "CreatedDate": "2023-04-13T01:49:38.568000+00:00",
        "TargetRole": "READ_ONLY",
        "IsDefault": false
    }
}

Weitere Informationen finden Sie unter Löschen eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon RDS und Löschen eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie delete-db-proxy verwendet wird.

AWS CLI

So löschen Sie einen DB-Proxy für eine RDS-Datenbank

Im folgenden Beispiel für delete-db-proxy wird ein DB-Proxy gelöscht.

aws rds delete-db-proxy \
    --db-proxy-name proxyExample

Ausgabe:

{
        "DBProxy":
        {
            "DBProxyName": "proxyExample",
            "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
            "Status": "deleting",
            "EngineFamily": "PostgreSQL",
            "VpcId": "vpc-1234567",
            "VpcSecurityGroupIds": [
                "sg-1234",
                "sg-5678"
            ],
            "VpcSubnetIds": [
                "subnetgroup1",
                "subnetgroup2"
            ],
            "Auth": "[
                {
                "Description": "proxydescription`"
                "AuthScheme": "SECRETS",
                "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e",
                "IAMAuth": "DISABLED"
                } ],
            "RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole",
            "Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
            "RequireTLS": false,
            "IdleClientTimeout": 1800,
            "DebuggingLogging": false,
        "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
        "UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
    }
}

Weitere Informationen finden Sie unter Löschen eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Löschen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter DeleteDbProxy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-db-security-group verwendet wird.

AWS CLI

So löschen Sie eine DB-Sicherheitsgruppe

Im folgenden Beispiel für delete-db-security-group wird DB-Sicherheitsgruppe namens mysecuritygroup gelöscht.

aws rds delete-db-security-group \
    --db-security-group-name mysecuritygroup

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit DB-Sicherheitsgruppen (EC2-Classic-Plattform) im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie delete-db-shard-group verwendet wird.

AWS CLI

Beispiel 1: So wird das Löschen einer DB-Shard-Gruppe erfolglos sein

Im folgenden Beispiel für delete-db-shard-group sehen Sie den Fehler, der angezeigt wird, wenn Sie versuchen, eine DB-Shard-Gruppe zu löschen, bevor Sie alle Ihre Datenbanken und Schemas gelöscht haben.

aws rds delete-db-shard-group \
    --db-shard-group-identifier limitless-test-shard-grp

Ausgabe:

An error occurred (InvalidDBShardGroupState) when calling the DeleteDBShardGroup operation: Unable to delete the DB shard group limitless-test-db-shard-group.
Delete all of your Limitless Database databases and schemas, then try again.

Beispiel 2: So wird das Löschen einer DB-Shard-Gruppe erfolgreich sein

Im folgenden Beispiel für delete-db-shard-group wird eine DB-Shard-Gruppe gelöscht, nachdem Sie alle Ihre Datenbanken und Schemas, einschließlich des public-Schemas, zuvor gelöscht haben.

aws rds delete-db-shard-group \
    --db-shard-group-identifier limitless-test-shard-grp

Ausgabe:

{
    "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
    "DBShardGroupIdentifier": "limitless-test-shard-grp",
    "DBClusterIdentifier": "limitless-test-cluster",
    "MaxACU": 768.0,
    "ComputeRedundancy": 0,
    "Status": "deleting",
    "PubliclyAccessible": true,
    "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}

Weitere Informationen finden Sie unter Löschen von Aurora-DB-Clustern und -DB-Instances im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie delete-db-snapshot verwendet wird.

AWS CLI

So löschen Sie einen DB-Snapshot

Im folgenden Beispiel für delete-db-snapshot wird der angegebene DB-Snapshot gelöscht.

aws rds delete-db-snapshot \
    --db-snapshot-identifier mydbsnapshot

Ausgabe:

{
    "DBSnapshot": {
        "DBSnapshotIdentifier": "mydbsnapshot",
        "DBInstanceIdentifier": "database-mysql",
        "SnapshotCreateTime": "2019-06-18T22:08:40.702Z",
        "Engine": "mysql",
        "AllocatedStorage": 100,
        "Status": "deleted",
        "Port": 3306,
        "AvailabilityZone": "us-east-1b",
        "VpcId": "vpc-6594f31c",
        "InstanceCreateTime": "2019-04-30T15:45:53.663Z",
        "MasterUsername": "admin",
        "EngineVersion": "5.6.40",
        "LicenseModel": "general-public-license",
        "SnapshotType": "manual",
        "Iops": 1000,
        "OptionGroupName": "default:mysql-5-6",
        "PercentProgress": 100,
        "StorageType": "io1",
        "Encrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
        "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot",
        "IAMDatabaseAuthenticationEnabled": false,
        "ProcessorFeatures": [],
        "DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE"
    }
}

Weitere Informationen finden Sie unter Löschen eines Snapshots im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie delete-db-subnet-group verwendet wird.

AWS CLI

So löschen Sie eine DB-Subnetzgruppe

Im folgenden Beispiel für delete-db-subnet-group wird eine DB-Subnetzgruppe namens mysubnetgroup gelöscht.

aws rds delete-db-subnet-group --db-subnet-group-name mysubnetgroup

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit einer DB-Instance in einer VPC im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie delete-event-subscription verwendet wird.

AWS CLI

So löschen Sie ein Ereignisabonnement

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

aws rds delete-event-subscription --subscription-name my-instance-events

Ausgabe:

{
    "EventSubscription": {
        "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
        "CustomerAwsId": "123456789012",
        "Enabled": false,
        "SourceIdsList": [
            "test-instance"
        ],
        "SourceType": "db-instance",
        "EventCategoriesList": [
            "backup",
            "recovery"
        ],
        "SubscriptionCreationTime": "2018-07-31 23:22:01.893",
        "CustSubscriptionId": "my-instance-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
        "Status": "deleting"
    }
}

Das folgende Codebeispiel zeigt, wie delete-global-cluster verwendet wird.

AWS CLI

So löschen Sie einen globalen DB-Cluster

Im folgenden Beispiel für delete-global-cluster wird ein Aurora MySQL-kompatibler globaler DB-Cluster gelöscht. Die Ausgabe zeigt den Cluster, den Sie löschen, aber nachfolgende describe-global-clusters-Befehle führen diesen DB-Cluster nicht mehr auf.

aws rds delete-global-cluster \
    --global-cluster-identifier myglobalcluster

Ausgabe:

{
    "GlobalCluster": {
        "GlobalClusterIdentifier": "myglobalcluster",
        "GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
        "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
        "Status": "available",
        "Engine": "aurora-mysql",
        "EngineVersion": "5.7.mysql_aurora.2.07.2",
        "StorageEncrypted": false,
        "DeletionProtection": false,
        "GlobalClusterMembers": []
    }
}

Weitere Informationen finden Sie unter Löschen einer Aurora Global Database im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie delete-option-group verwendet wird.

AWS CLI

So löschen Sie eine Optionsgruppe

Im folgenden Beispiel für delete-option-group wird die angegebene Optionsgruppe gelöscht.

aws rds delete-option-group \
    --option-group-name myoptiongroup

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen einer Optionsgruppe im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie deregister-db-proxy-targets verwendet wird.

AWS CLI

So heben Sie die Registrierung eines DB-Proxyziels bei einer Datenbank-Zielgruppe auf

Im folgenden Beispiel für deregister-db-proxy-targets wird die Zuordnung zwischen dem Proxy proxyExample und seinem Ziel entfernt.

aws rds deregister-db-proxy-targets \
    --db-proxy-name proxyExample \
    --db-instance-identifiers database-1

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Löschen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-account-attributes verwendet wird.

AWS CLI

So beschreiben Sie Kontoattribute

Im folgenden Beispiel für describe-account-attributes werden die Attribute für das aktuelle AWS-Konto abgerufen.

aws rds describe-account-attributes

Ausgabe:

{
    "AccountQuotas": [
        {
            "Max": 40,
            "Used": 4,
            "AccountQuotaName": "DBInstances"
        },
        {
            "Max": 40,
            "Used": 0,
            "AccountQuotaName": "ReservedDBInstances"
        },
        {
            "Max": 100000,
            "Used": 40,
            "AccountQuotaName": "AllocatedStorage"
        },
        {
            "Max": 25,
            "Used": 0,
            "AccountQuotaName": "DBSecurityGroups"
        },
        {
            "Max": 20,
            "Used": 0,
            "AccountQuotaName": "AuthorizationsPerDBSecurityGroup"
        },
        {
            "Max": 50,
            "Used": 1,
            "AccountQuotaName": "DBParameterGroups"
        },
        {
            "Max": 100,
            "Used": 3,
            "AccountQuotaName": "ManualSnapshots"
        },
        {
            "Max": 20,
            "Used": 0,
            "AccountQuotaName": "EventSubscriptions"
        },
        {
            "Max": 50,
            "Used": 1,
            "AccountQuotaName": "DBSubnetGroups"
        },
        {
            "Max": 20,
            "Used": 1,
            "AccountQuotaName": "OptionGroups"
        },
        {
            "Max": 20,
            "Used": 6,
            "AccountQuotaName": "SubnetsPerDBSubnetGroup"
        },
        {
            "Max": 5,
            "Used": 0,
            "AccountQuotaName": "ReadReplicasPerMaster"
        },
        {
            "Max": 40,
            "Used": 1,
            "AccountQuotaName": "DBClusters"
        },
        {
            "Max": 50,
            "Used": 0,
            "AccountQuotaName": "DBClusterParameterGroups"
        },
        {
            "Max": 5,
            "Used": 0,
            "AccountQuotaName": "DBClusterRoles"
        }
    ]
}

Das folgende Codebeispiel zeigt, wie describe-blue-green-deployments verwendet wird.

AWS CLI

Beispiel 1: So beschreiben Sie eine blaue/grüne Bereitstellung einer RDS-DB-Instance nach Abschluss der Erstellung

Im folgenden Beispiel für describe-blue-green-deployment werden die Details einer Blau/Grün-Bereitstellung nach Abschluss der Erstellung abgerufen.

aws rds describe-blue-green-deployments \
    --blue-green-deployment-identifier bgd-v53303651eexfake

Ausgabe:

{
    "BlueGreenDeployments": [
        {
            "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
            "BlueGreenDeploymentName": "bgd-cli-test-instance",
            "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
            "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
            "SwitchoverDetails": [
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-j382ha",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ejv4ao",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-vlpz3t",
                    "Status": "AVAILABLE"
                }
            ],
            "Tasks": [
                {
                    "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "DB_ENGINE_VERSION_UPGRADE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CONFIGURE_BACKUPS",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATING_TOPOLOGY_OF_SOURCE",
                    "Status": "COMPLETED"
                }
            ],
            "Status": "AVAILABLE",
            "CreateTime": "2022-02-25T21:18:51.183000+00:00"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So beschreiben Sie eine Blau/Grün-Bereitstellung für einen Aurora-MySQL-DB-Cluster

Im folgenden Beispiel für describe-blue-green-deployment werden die Details für eine Blau/Grün-Bereitstellung abgerufen.

aws rds describe-blue-green-deployments \
    --blue-green-deployment-identifier bgd-wi89nwzglccsfake

Ausgabe:

{
    "BlueGreenDeployments": [
        {
            "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
            "BlueGreenDeploymentName": "my-blue-green-deployment",
            "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
            "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
            "SwitchoverDetails": [
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg",
                    "Status": "AVAILABLE"
                }
            ],
            "Tasks": [
                {
                    "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "DB_ENGINE_VERSION_UPGRADE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATE_CUSTOM_ENDPOINTS",
                    "Status": "COMPLETED"
                }
            ],
            "Status": "AVAILABLE",
            "CreateTime": "2022-02-25T21:12:00.288000+00:00"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon Aurora.

Beispiel 3: So beschreiben Sie eine Blau/Grün-Bereitstellung für einen Aurora-MySQL-DB-Cluster nach der Umstellung

Im folgenden Beispiel für describe-blue-green-deployment werden die Details zu einer Blau/Grün-Bereitstellung abgerufen, nachdem die grüne Umgebung zur Produktionsumgebung heraufgestuft wurde.

aws rds describe-blue-green-deployments \
    --blue-green-deployment-identifier bgd-wi89nwzglccsfake

Ausgabe:

{
    "BlueGreenDeployments": [
        {
            "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
            "BlueGreenDeploymentName": "my-blue-green-deployment",
            "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1",
            "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
            "SwitchoverDetails": [
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
                    "Status": "SWITCHOVER_COMPLETED"
                }
            ],
            "Tasks": [
                {
                    "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "DB_ENGINE_VERSION_UPGRADE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATE_CUSTOM_ENDPOINTS",
                    "Status": "COMPLETED"
                }
            ],
            "Status": "SWITCHOVER_COMPLETED",
            "CreateTime": "2022-02-25T22:38:49.522000+00:00"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon Aurora.

Beispiel 4: So beschreiben Sie eine kombinierte Blau/Grün-Bereitstellung

Im folgenden Beispiel für describe-blue-green-deployment werden die Details einer kombinierten Blau/Grün-Bereitstellung abgerufen.

aws rds describe-blue-green-deployments

Ausgabe:

{
    "BlueGreenDeployments": [
        {
            "BlueGreenDeploymentIdentifier": "bgd-wi89nwzgfakelccs",
            "BlueGreenDeploymentName": "my-blue-green-deployment",
            "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
            "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
            "SwitchoverDetails": [
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq",
                    "Status": "AVAILABLE"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg",
                    "Status": "AVAILABLE"
                }
            ],
            "Tasks": [
                {
                    "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "DB_ENGINE_VERSION_UPGRADE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATE_CUSTOM_ENDPOINTS",
                    "Status": "COMPLETED"
                }
            ],
            "Status": "AVAILABLE",
            "CreateTime": "2022-02-25T21:12:00.288000+00:00"
        },
        {
            "BlueGreenDeploymentIdentifier": "bgd-v5330365fake1eex",
            "BlueGreenDeploymentName": "bgd-cli-test-instance",
            "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-old1",
            "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
            "SwitchoverDetails": [
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
                    "Status": "SWITCHOVER_COMPLETED"
                },
                {
                    "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-old1",
                    "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
                    "Status": "SWITCHOVER_COMPLETED"
                }
            ],
            "Tasks": [
                {
                    "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "DB_ENGINE_VERSION_UPGRADE",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CONFIGURE_BACKUPS",
                    "Status": "COMPLETED"
                },
                {
                    "Name": "CREATING_TOPOLOGY_OF_SOURCE",
                    "Status": "COMPLETED"
                }
            ],
            "Status": "SWITCHOVER_COMPLETED",
            "CreateTime": "2022-02-25T22:33:22.225000+00:00"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon RDS und Anzeigen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-certificates verwendet wird.

AWS CLI

So beschreiben Sie Zertifikate

Im folgenden Beispiel für describe-certificates werden die Details des Zertifikats abgerufen, das der Standardregion des Benutzers zugeordnet ist.

aws rds describe-certificates

Ausgabe:

{
    "Certificates": [
        {
            "CertificateIdentifier": "rds-ca-ecc384-g1",
            "CertificateType": "CA",
            "Thumbprint": "2ee3dcc06e50192559b13929e73484354f23387d",
            "ValidFrom": "2021-05-24T22:06:59+00:00",
            "ValidTill": "2121-05-24T23:06:59+00:00",
            "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-ecc384-g1",
            "CustomerOverride": false
        },
        {
            "CertificateIdentifier": "rds-ca-rsa4096-g1",
            "CertificateType": "CA",
            "Thumbprint": "19da4f2af579a8ae1f6a0fa77aa5befd874b4cab",
            "ValidFrom": "2021-05-24T22:03:20+00:00",
            "ValidTill": "2121-05-24T23:03:20+00:00",
            "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-rsa4096-g1",
            "CustomerOverride": false
        },
        {
            "CertificateIdentifier": "rds-ca-rsa2048-g1",
            "CertificateType": "CA",
            "Thumbprint": "7c40cb42714b6fdb2b296f9bbd0e8bb364436a76",
            "ValidFrom": "2021-05-24T21:59:00+00:00",
            "ValidTill": "2061-05-24T22:59:00+00:00",
            "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-rsa2048-g1",
            "CustomerOverride": true,
            "CustomerOverrideValidTill": "2061-05-24T22:59:00+00:00"
        },
        {
            "CertificateIdentifier": "rds-ca-2019",
            "CertificateType": "CA",
            "Thumbprint": "d40ddb29e3750dffa671c3140bbf5f478d1c8096",
            "ValidFrom": "2019-08-22T17:08:50+00:00",
            "ValidTill": "2024-08-22T17:08:50+00:00",
            "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-2019",
            "CustomerOverride": false
        }
    ],
    "DefaultCertificateForNewLaunches": "rds-ca-rsa2048-g1"
}

Weitere Informationen finden Sie unter Verwenden von SSL/TLS für die Verschlüsselung einer Verbindung zu einer DB-Instance im Benutzerhandbuch zu Amazon RDS und Verwenden von SSL/TLS für die Verschlüsselung einer Verbindung zu einem DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-cluster-backtracks verwendet wird.

AWS CLI

So beschreiben Sie Rückverfolgungen für einen DB-Cluster

Im folgenden Beispiel für describe-db-cluster-backtracks werden Details zum angegebenen DB-Cluster abgerufen.

aws rds describe-db-cluster-backtracks \
    --db-cluster-identifier mydbcluster

Ausgabe:

{
    "DBClusterBacktracks": [
        {
            "DBClusterIdentifier": "mydbcluster",
            "BacktrackIdentifier": "2f5f5294-0dd2-44c9-9f50-EXAMPLE",
            "BacktrackTo": "2021-02-12T04:59:22Z",
            "BacktrackedFrom": "2021-02-12T14:37:31.640Z",
            "BacktrackRequestCreationTime": "2021-02-12T14:36:18.819Z",
            "Status": "COMPLETED"
        },
        {
            "DBClusterIdentifier": "mydbcluster",
            "BacktrackIdentifier": "3c7a6421-af2a-4ea3-ae95-EXAMPLE",
            "BacktrackTo": "2021-02-11T22:53:46Z",
            "BacktrackedFrom": "2021-02-12T00:09:27.006Z",
            "BacktrackRequestCreationTime": "2021-02-12T00:07:53.487Z",
            "Status": "COMPLETED"
        }
    ]
}

Weitere Informationen finden Sie unter Rückverfolgen eines Aurora-DB-Clusters im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-cluster-endpoints verwendet wird.

AWS CLI

Beispiel 1: So beschreiben Sie DB-Cluster-Endpunkte

Im folgenden Beispiel für describe-db-cluster-endpoints werden Details für Ihre DB-Cluster-Endpunkte abgerufen. Die gängigsten Arten von Aurora-Clustern haben zwei Endpunkte. Ein Endpunkt hat den Typ WRITER. Sie können diesen Endpunkt für alle SQL-Anweisungen verwenden. Der andere Endpunkt hat den Typ READER. Sie können diesen Endpunkt nur für SELECT- und andere schreibgeschützte SQL-Anweisungen verwenden.

aws rds describe-db-cluster-endpoints

Ausgabe:

{
    "DBClusterEndpoints": [
        {
            "DBClusterIdentifier": "my-database-1",
            "Endpoint": "my-database-1.cluster-cnpexample.us-east-1.rds.amazonaws.com",
            "Status": "creating",
            "EndpointType": "WRITER"
        },
        {
            "DBClusterIdentifier": "my-database-1",
            "Endpoint": "my-database-1.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
            "Status": "creating",
            "EndpointType": "READER"
        },
        {
            "DBClusterIdentifier": "mydbcluster",
            "Endpoint": "mydbcluster.cluster-cnpexamle.us-east-1.rds.amazonaws.com",
            "Status": "available",
            "EndpointType": "WRITER"
        },
        {
            "DBClusterIdentifier": "mydbcluster",
            "Endpoint": "mydbcluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
            "Status": "available",
            "EndpointType": "READER"
        }
    ]
}

Beispiel 2: So beschreiben Sie DB-Cluster-Endpunkte eines einzelnen DB-Clusters

Im folgenden Beispiel für describe-db-cluster-endpoints werden Details für die DB-Cluster-Endpunkte eines einzelnen angegebenen DB-Clusters abgerufen. Aurora Serverless-Cluster haben nur einen einzigen Endpunkt des Typs WRITER.

aws rds describe-db-cluster-endpoints \
    --db-cluster-identifier serverless-cluster

Ausgabe:

{
    "DBClusterEndpoints": [
        {
            "Status": "available",
            "Endpoint": "serverless-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
            "DBClusterIdentifier": "serverless-cluster",
            "EndpointType": "WRITER"
        }
    ]
}

Weitere Informationen finden Sie unter Verbindungsmanagement in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-cluster-parameter-groups verwendet wird.

AWS CLI

So beschreiben Sie DB-Cluster-Parametergruppen

Im folgenden Beispiel für describe-db-cluster-parameter-groups werden Details zu Ihren DB-Parametergruppen abgerufen.

aws rds describe-db-cluster-parameter-groups

Ausgabe:

{
    "DBClusterParameterGroups": [
        {
            "DBClusterParameterGroupName": "default.aurora-mysql5.7",
            "DBParameterGroupFamily": "aurora-mysql5.7",
            "Description": "Default cluster parameter group for aurora-mysql5.7",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-mysql5.7"
        },
        {
            "DBClusterParameterGroupName": "default.aurora-postgresql9.6",
            "DBParameterGroupFamily": "aurora-postgresql9.6",
            "Description": "Default cluster parameter group for aurora-postgresql9.6",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-postgresql9.6"
        },
        {
            "DBClusterParameterGroupName": "default.aurora5.6",
            "DBParameterGroupFamily": "aurora5.6",
            "Description": "Default cluster parameter group for aurora5.6",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6"
        },
        {
            "DBClusterParameterGroupName": "mydbclusterpg",
            "DBParameterGroupFamily": "aurora-mysql5.7",
            "Description": "My DB cluster parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpg"
        },
        {
            "DBClusterParameterGroupName": "mydbclusterpgcopy",
            "DBParameterGroupFamily": "aurora-mysql5.7",
            "Description": "Copy of mydbclusterpg parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy"
        }
    ]
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-cluster-parameters verwendet wird.

AWS CLI

Beispiel 1: So beschreiben Sie die Parameter in einer DB-Parametergruppe

Im folgenden Beispiel für describe-db-cluster-parameters werden Details zu den Parametern in einer DB-Clusterparametergruppe abgerufen.

aws rds describe-db-cluster-parameters \
    --db-cluster-parameter-group-name mydbclusterpg

Ausgabe:

{
    "Parameters": [
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        {
            "ParameterName": "aurora_lab_mode",
            "ParameterValue": "0",
            "Description": "Enables new features in the Aurora engine.",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        ...some output truncated...
    ]
}

Beispiel 2: So listen Sie nur die Parameternamen in einer DB-Clusterparametergruppe auf

Im folgenden Beispiel für describe-db-cluster-parameters werden nur die Namen der Parameter in einer DB-Clusterparametergruppe abgerufen.

aws rds describe-db-cluster-parameters \
    --db-cluster-parameter-group-name default.aurora-mysql5.7 \
    --query 'Parameters[].{ParameterName:ParameterName}'

Ausgabe:

[
    {
        "ParameterName": "allow-suspicious-udfs"
    },
    {
        "ParameterName": "aurora_binlog_read_buffer_size"
    },
    {
        "ParameterName": "aurora_binlog_replication_max_yield_seconds"
    },
    {
        "ParameterName": "aurora_binlog_use_large_read_buffer"
    },
    {
        "ParameterName": "aurora_lab_mode"
    },

    ...some output truncated...
    }
]

Beispiel 3: So beschreiben Sie nur die änderbaren Parameter in einer DB-Clusterparametergruppe

Im folgenden Beispiel für describe-db-cluster-parameters werden nur die Namen der Parameter in einer DB-Clusterparametergruppe abgerufen, die geändert werden können.

aws rds describe-db-cluster-parameters \
    --db-cluster-parameter-group-name default.aurora-mysql5.7 \
    --query 'Parameters[].{ParameterName:ParameterName,IsModifiable:IsModifiable} | [?IsModifiable == `true`]'

Ausgabe:

[
    {
        "ParameterName": "aurora_binlog_read_buffer_size",
        "IsModifiable": true
    },
    {
        "ParameterName": "aurora_binlog_replication_max_yield_seconds",
        "IsModifiable": true
    },
    {
        "ParameterName": "aurora_binlog_use_large_read_buffer",
        "IsModifiable": true
    },
    {
        "ParameterName": "aurora_lab_mode",
        "IsModifiable": true
    },

    ...some output truncated...
    }
]

Beispiel 4: So beschreiben Sie nur die änderbaren booleschen Parameter in einer DB-Clusterparametergruppe

Im folgenden Beispiel für describe-db-cluster-parameters werden nur die Namen der Parameter in einer DB-Clusterparametergruppe abgerufen, die geändert werden können und einen booleschen Datentyp haben.

aws rds describe-db-cluster-parameters \
    --db-cluster-parameter-group-name default.aurora-mysql5.7 \
    --query 'Parameters[].{ParameterName:ParameterName,DataType:DataType,IsModifiable:IsModifiable} | [?DataType == `boolean`] | [?IsModifiable == `true`]'

Ausgabe:

[
    {
        "DataType": "boolean",
        "ParameterName": "aurora_binlog_use_large_read_buffer",
        "IsModifiable": true
    },
    {
        "DataType": "boolean",
        "ParameterName": "aurora_lab_mode",
        "IsModifiable": true
    },
    {
        "DataType": "boolean",
        "ParameterName": "autocommit",
        "IsModifiable": true
    },
    {
        "DataType": "boolean",
        "ParameterName": "automatic_sp_privileges",
        "IsModifiable": true
    },
    ...some output truncated...
    }
]

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-cluster-snapshot-attributes verwendet wird.

AWS CLI

So beschreiben Sie die Attributnamen und Werte für einen DB-Cluster-Snapshot

Im folgenden Beispiel für describe-db-cluster-snapshot-attributes werden Details zu den Attributnamen und Werten für den angegebenen DB-Cluster-Snapshot abgerufen.

aws rds describe-db-cluster-snapshot-attributes \
    --db-cluster-snapshot-identifier myclustersnapshot

Ausgabe:

{
    "DBClusterSnapshotAttributesResult": {
        "DBClusterSnapshotIdentifier": "myclustersnapshot",
        "DBClusterSnapshotAttributes": [
            {
                "AttributeName": "restore",
                "AttributeValues": [
                    "123456789012"
                ]
            }
        ]
    }
}

Weitere Informationen finden Sie unter Freigeben eines DB-Cluster-Snapshots im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-cluster-snapshots verwendet wird.

AWS CLI

So beschreiben Sie einen DB-Cluster-Snapshot für einen DB-Cluster

Im folgenden Beispiel für describe-db-cluster-snapshots werden die Details für die DB-Cluster-Snapshots für den angegebenen DB-Cluster abgerufen.

aws rds describe-db-cluster-snapshots \
    --db-cluster-identifier mydbcluster

Ausgabe:

{
    "DBClusterSnapshots": [
        {
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1e"
            ],
            "DBClusterSnapshotIdentifier": "myclustersnapshotcopy",
            "DBClusterIdentifier": "mydbcluster",
            "SnapshotCreateTime": "2019-06-04T09:16:42.649Z",
            "Engine": "aurora-mysql",
            "AllocatedStorage": 0,
            "Status": "available",
            "Port": 0,
            "VpcId": "vpc-6594f31c",
            "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
            "MasterUsername": "myadmin",
            "EngineVersion": "5.7.mysql_aurora.2.04.2",
            "LicenseModel": "aurora-mysql",
            "SnapshotType": "manual",
            "PercentProgress": 100,
            "StorageEncrypted": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
            "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:814387698303:cluster-snapshot:myclustersnapshotcopy",
            "IAMDatabaseAuthenticationEnabled": false
        },
        {
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1e"
            ],
            "DBClusterSnapshotIdentifier": "rds:mydbcluster-2019-06-20-09-16",
            "DBClusterIdentifier": "mydbcluster",
            "SnapshotCreateTime": "2019-06-20T09:16:26.569Z",
            "Engine": "aurora-mysql",
            "AllocatedStorage": 0,
            "Status": "available",
            "Port": 0,
            "VpcId": "vpc-6594f31c",
            "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
            "MasterUsername": "myadmin",
            "EngineVersion": "5.7.mysql_aurora.2.04.2",
            "LicenseModel": "aurora-mysql",
            "SnapshotType": "automated",
            "PercentProgress": 100,
            "StorageEncrypted": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:814387698303:key/AKIAIOSFODNN7EXAMPLE",
            "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:mydbcluster-2019-06-20-09-16",
            "IAMDatabaseAuthenticationEnabled": false
        }
    ]
}

Weitere Informationen finden Sie unter Erstellen eines DB-Cluster-Snapshots im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-clusters verwendet wird.

AWS CLI

Beispiel 1: So beschreiben Sie einen DB-Cluster

Im folgenden Beispiel für describe-db-clusters werden Details zum angegebenen DB-Cluster abgerufen.

aws rds describe-db-clusters \
    --db-cluster-identifier mydbcluster

Ausgabe:

{
    "DBClusters": [
        {
            "AllocatedStorage": 1,
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1e"
            ],
            "BackupRetentionPeriod": 1,
            "DatabaseName": "mydbcluster",
            "DBClusterIdentifier": "mydbcluster",
            "DBClusterParameterGroup": "default.aurora-mysql5.7",
            "DBSubnetGroup": "default",
            "Status": "available",
            "EarliestRestorableTime": "2019-06-19T09:16:28.210Z",
            "Endpoint": "mydbcluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
            "ReaderEndpoint": "mydbcluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
            "MultiAZ": true,
            "Engine": "aurora-mysql",
            "EngineVersion": "5.7.mysql_aurora.2.04.2",
            "LatestRestorableTime": "2019-06-20T22:38:14.908Z",
            "Port": 3306,
            "MasterUsername": "myadmin",
            "PreferredBackupWindow": "09:09-09:39",
            "PreferredMaintenanceWindow": "sat:04:09-sat:04:39",
            "ReadReplicaIdentifiers": [],
            "DBClusterMembers": [
                {
                    "DBInstanceIdentifier": "dbinstance3",
                    "IsClusterWriter": false,
                    "DBClusterParameterGroupStatus": "in-sync",
                    "PromotionTier": 1
                },
                {
                    "DBInstanceIdentifier": "dbinstance1",
                    "IsClusterWriter": false,
                    "DBClusterParameterGroupStatus": "in-sync",
                    "PromotionTier": 1
                },
                {
                    "DBInstanceIdentifier": "dbinstance2",
                    "IsClusterWriter": false,
                    "DBClusterParameterGroupStatus": "in-sync",
                    "PromotionTier": 1
                },
                {
                    "DBInstanceIdentifier": "mydbcluster",
                    "IsClusterWriter": false,
                    "DBClusterParameterGroupStatus": "in-sync",
                    "PromotionTier": 1
                },
                {
                    "DBInstanceIdentifier": "mydbcluster-us-east-1b",
                    "IsClusterWriter": false,
                    "DBClusterParameterGroupStatus": "in-sync",
                    "PromotionTier": 1
                },
                {
                    "DBInstanceIdentifier": "mydbcluster",
                    "IsClusterWriter": true,
                    "DBClusterParameterGroupStatus": "in-sync",
                    "PromotionTier": 1
                }
            ],
            "VpcSecurityGroups": [
                {
                    "VpcSecurityGroupId": "sg-0b9130572daf3dc16",
                    "Status": "active"
                }
            ],
            "HostedZoneId": "Z2R2ITUGPM61AM",
            "StorageEncrypted": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:814387698303:key/AKIAIOSFODNN7EXAMPLE",
            "DbClusterResourceId": "cluster-AKIAIOSFODNN7EXAMPLE",
            "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster",
            "AssociatedRoles": [],
            "IAMDatabaseAuthenticationEnabled": false,
            "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
            "EngineMode": "provisioned",
            "DeletionProtection": false,
            "HttpEndpointEnabled": false
        }
    ]
}

Beispiel 2: So listen Sie bestimmte Attribute aller DB-Cluster auf

Im folgenden Beispiel für describe-db-clusters werden nur DBClusterIdentifier und Endpoint sowie ReaderEndpoint-Attribute all Ihrer DB-Cluster in der aktuellen AWS-Region abgerufen.

aws rds describe-db-clusters \
    --query 'DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Endpoint:Endpoint,ReaderEndpoint:ReaderEndpoint}'

Ausgabe:

[
    {
        "Endpoint": "cluster-57-2020-05-01-2270.cluster-cnpexample.us-east-1.rds.amazonaws.com",
        "ReaderEndpoint": "cluster-57-2020-05-01-2270.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
        "DBClusterIdentifier": "cluster-57-2020-05-01-2270"
    },
    {
        "Endpoint": "cluster-57-2020-05-01-4615.cluster-cnpexample.us-east-1.rds.amazonaws.com",
        "ReaderEndpoint": "cluster-57-2020-05-01-4615.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
        "DBClusterIdentifier": "cluster-57-2020-05-01-4615"
    },
    {
        "Endpoint": "pg2-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
        "ReaderEndpoint": "pg2-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
        "DBClusterIdentifier": "pg2-cluster"
    },
    ...output omitted...
    }
]

Beispiel 3: So listen Sie DB-Cluster mit einem bestimmten Attribut auf

Im folgenden Beispiel für describe-db-clusters werden nur die DBClusterIdentifier- und Engine-Attribute Ihrer DB-Cluster abgerufen, die die aurora-postgresql-Engine verwenden.

aws rds describe-db-clusters \
    --query 'DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Engine:Engine} | [?Engine == `aurora-postgresql`]'

Ausgabe:

[
    {
        "Engine": "aurora-postgresql",
        "DBClusterIdentifier": "pg2-cluster"
    }
]

Weitere Informationen finden Sie unter Amazon-Aurora-DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-engine-versions verwendet wird.

AWS CLI

So beschreiben Sie die DB-Engine-Versionen für die MySQL-DB-Engine

Im folgenden Beispiel für describe-db-engine-versions werden Details zu den jeweiligen DB-Engine-Versionen für die angegebene DB-Engine angezeigt.

aws rds describe-db-engine-versions \
    --engine mysql

Ausgabe:

{
    "DBEngineVersions": [
        {
            "Engine": "mysql",
            "EngineVersion": "5.5.46",
            "DBParameterGroupFamily": "mysql5.5",
            "DBEngineDescription": "MySQL Community Edition",
            "DBEngineVersionDescription": "MySQL 5.5.46",
            "ValidUpgradeTarget": [
                {
                    "Engine": "mysql",
                    "EngineVersion": "5.5.53",
                    "Description": "MySQL 5.5.53",
                    "AutoUpgrade": false,
                    "IsMajorVersionUpgrade": false
                },
                {
                    "Engine": "mysql",
                    "EngineVersion": "5.5.54",
                    "Description": "MySQL 5.5.54",
                    "AutoUpgrade": false,
                    "IsMajorVersionUpgrade": false
                },
                {
                    "Engine": "mysql",
                    "EngineVersion": "5.5.57",
                    "Description": "MySQL 5.5.57",
                    "AutoUpgrade": false,
                    "IsMajorVersionUpgrade": false
                },
                ...some output truncated...
            ]
        }

Weitere Informationen finden Sie unter Was ist Amazon Relational Database Service (Amazon RDS)? im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-db-instance-automated-backups verwendet wird.

AWS CLI

So beschreiben Sie automatisierte Backups für eine DB-Instance

Im folgenden Beispiel für describe-db-instance-automated-backups werden die Details der automatisierten Backups für die angegebene DB-Instance angezeigt. Dazu gehören replizierte automatisierte Backups in anderen AWS-Regionen.

aws rds describe-db-instance-automated-backups \
    --db-instance-identifier new-orcl-db

Ausgabe:

{
    "DBInstanceAutomatedBackups": [
        {
            "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
            "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
            "Region": "us-east-1",
            "DBInstanceIdentifier": "new-orcl-db",
            "RestoreWindow": {
                "EarliestTime": "2020-12-07T21:05:20.939Z",
                "LatestTime": "2020-12-07T21:05:20.939Z"
            },
            "AllocatedStorage": 20,
            "Status": "replicating",
            "Port": 1521,
            "InstanceCreateTime": "2020-12-04T15:28:31Z",
            "MasterUsername": "admin",
            "Engine": "oracle-se2",
            "EngineVersion": "12.1.0.2.v21",
            "LicenseModel": "bring-your-own-license",
            "OptionGroupName": "default:oracle-se2-12-1",
            "Encrypted": false,
            "StorageType": "gp2",
            "IAMDatabaseAuthenticationEnabled": false,
            "BackupRetentionPeriod": 14,
            "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
        }
    ]
}

Weitere Informationen finden Sie unter Suchen nach Informationen über replizierte Backups im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-db-instances verwendet wird.

AWS CLI

So beschreiben Sie eine DB-Instance

Im folgenden Beispiel für describe-db-instances werden Details zur angegebenen DB-Instance abgerufen.

aws rds describe-db-instances \
    --db-instance-identifier mydbinstancecf

Ausgabe:

{
    "DBInstances": [
        {
            "DBInstanceIdentifier": "mydbinstancecf",
            "DBInstanceClass": "db.t3.small",
            "Engine": "mysql",
            "DBInstanceStatus": "available",
            "MasterUsername": "masterawsuser",
            "Endpoint": {
                "Address": "mydbinstancecf.abcexample.us-east-1.rds.amazonaws.com",
                "Port": 3306,
                "HostedZoneId": "Z2R2ITUGPM61AM"
            },
            ...some output truncated...
        }
    ]
}

Das folgende Codebeispiel zeigt, wie describe-db-log-files verwendet wird.

AWS CLI

So beschreiben Sie die Protokolldateien für eine DB-Instance

Im folgenden Beispiel für describe-db-log-files werden Details zu den Protokolldateien für die angegebene DB-Instance abgerufen.

aws rds describe-db-log-files -\
    -db-instance-identifier test-instance

Ausgabe:

{
    "DescribeDBLogFiles": [
        {
            "Size": 0,
            "LastWritten": 1533060000000,
            "LogFileName": "error/mysql-error-running.log"
        },
        {
            "Size": 2683,
            "LastWritten": 1532994300000,
            "LogFileName": "error/mysql-error-running.log.0"
        },
        {
            "Size": 107,
            "LastWritten": 1533057300000,
            "LogFileName": "error/mysql-error-running.log.18"
        },
        {
            "Size": 13105,
            "LastWritten": 1532991000000,
            "LogFileName": "error/mysql-error-running.log.23"
        },
        {
            "Size": 0,
            "LastWritten": 1533061200000,
            "LogFileName": "error/mysql-error.log"
        },
        {
            "Size": 3519,
            "LastWritten": 1532989252000,
            "LogFileName": "mysqlUpgrade"
        }
    ]
}

Das folgende Codebeispiel zeigt, wie describe-db-parameter-groups verwendet wird.

AWS CLI

So beschreiben Sie Ihre DB-Parametergruppe

Im folgenden Beispiel für describe-db-parameter-groups werden Details zu Ihren DB-Parametergruppen abgerufen.

aws rds describe-db-parameter-groups

Ausgabe:

{
    "DBParameterGroups": [
        {
            "DBParameterGroupName": "default.aurora-mysql5.7",
            "DBParameterGroupFamily": "aurora-mysql5.7",
            "Description": "Default parameter group for aurora-mysql5.7",
            "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora-mysql5.7"
        },
        {
            "DBParameterGroupName": "default.aurora-postgresql9.6",
            "DBParameterGroupFamily": "aurora-postgresql9.6",
            "Description": "Default parameter group for aurora-postgresql9.6",
            "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora-postgresql9.6"
        },
        {
            "DBParameterGroupName": "default.aurora5.6",
            "DBParameterGroupFamily": "aurora5.6",
            "Description": "Default parameter group for aurora5.6",
            "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora5.6"
        },
        {
            "DBParameterGroupName": "default.mariadb10.1",
            "DBParameterGroupFamily": "mariadb10.1",
            "Description": "Default parameter group for mariadb10.1",
            "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.mariadb10.1"
        },
        ...some output truncated...
    ]
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-db-parameters verwendet wird.

AWS CLI

So beschreiben Sie die Parameter in einer DB-Parametergruppe

Im folgenden Beispiel für describe-db-parameters werden die Details der angegebenen DB-Parametergruppe abgerufen.

aws rds describe-db-parameters \
    --db-parameter-group-name mydbpg

Ausgabe:

{
    "Parameters": [
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot"
        },
        {
            "ParameterName": "auto_generate_certs",
            "Description": "Controls whether the server autogenerates SSL key and certificate files in the data directory, if they do not already exist.",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot"
        },
        ...some output truncated...
    ]
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-db-proxies verwendet wird.

AWS CLI

So beschreiben Sie einen DB-Proxy für eine RDS-Datenbank

Im folgenden Beispiel für describe-db-proxies werden Informationen zu DB-Proxys abgerufen.

aws rds describe-db-proxies

Ausgabe:

{
    "DBProxies": [
        {
            "DBProxyName": "proxyExample1",
            "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
            "Status": "available",
            "EngineFamily": "PostgreSQL",
            "VpcId": "vpc-1234567",
            "VpcSecurityGroupIds": [
                "sg-1234"
            ],
            "VpcSubnetIds": [
                "subnetgroup1",
                "subnetgroup2"
            ],
            "Auth": "[
                {
                    "Description": "proxydescription1"
                    "AuthScheme": "SECRETS",
                    "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f",
                    "IAMAuth": "DISABLED"
                }
            ]",
            "RoleArn": "arn:aws:iam::12345678912??:role/ProxyPostgreSQLRole",
            "Endpoint": "proxyExample1.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
            "RequireTLS": false,
            "IdleClientTimeout": 1800,
            "DebuggingLogging": false,
            "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
            "UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
        },
        {
            "DBProxyName": "proxyExample2",
            "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-1234a12b23456c1ab",
            "Status": "available",
            "EngineFamily": "PostgreSQL",
            "VpcId": "sg-1234567",
            "VpcSecurityGroupIds": [
                "sg-1234"
            ],
            "VpcSubnetIds": [
                "subnetgroup1",
                "subnetgroup2"
            ],
            "Auth": "[
                {
                    "Description": "proxydescription2"
                    "AuthScheme": "SECRETS",
                    "SecretArn": "aarn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f",
                    "IAMAuth": "DISABLED"
                }
            ]",
            "RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole",
            "Endpoint": "proxyExample2.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
            "RequireTLS": false,
            "IdleClientTimeout": 1800,
            "DebuggingLogging": false,
            "CreatedDate": "2022-01-05T16:19:33.452000+00:00",
            "UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Anzeigen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-proxy-endpoints verwendet wird.

AWS CLI

So beschreiben Sie einen DB-Proxy-Endpunkt

Im folgenden Beispiel für describe-db-proxy-endpoints werden Informationen über DB-Proxy-Endpunkte zurückgegeben.

aws rds describe-db-proxy-endpoints

Ausgabe:

{
    "DBProxyEndpoints": [
        {
            "DBProxyEndpointName": "proxyEndpoint1",
            "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
            "DBProxyName": "proxyExample",
            "Status": "available",
            "VpcId": "vpc-1234567",
            "VpcSecurityGroupIds": [
                "sg-1234"
            ],
            "VpcSubnetIds": [
                "subnetgroup1",
                "subnetgroup2"
            ],
            "Endpoint": "proxyEndpoint1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
            "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
            "TargetRole": "READ_WRITE",
            "IsDefault": false
        },
        {
            "DBProxyEndpointName": "proxyEndpoint2",
            "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-4567a01b12345c0ab",
            "DBProxyName": "proxyExample2",
            "Status": "available",
            "VpcId": "vpc1234567",
            "VpcSecurityGroupIds": [
                "sg-5678"
            ],
            "VpcSubnetIds": [
                "subnetgroup1",
                "subnetgroup2"
            ],
            "Endpoint": "proxyEndpoint2.endpoint.proxy-cd1ef2klmnop.us-east-1.rds.amazonaws.com",
            "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
            "TargetRole": "READ_WRITE",
            "IsDefault": false
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon RDS und Anzeigen eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-proxy-target-groups verwendet wird.

AWS CLI

So beschreiben Sie einen DB-Proxy-Endpunkt

Im folgenden Beispiel für describe-db-proxy-target-groups werden Informationen zu DB-Proxy-Zielgruppen zurückgegeben.

aws rds describe-db-proxy-target-groups \
    --db-proxy-name proxyExample

Ausgabe:

{
"TargetGroups":
    {
        "DBProxyName": "proxyExample",
        "TargetGroupName": "default",
        "TargetGroupArn": "arn:aws:rds:us-east-1:123456789012:target-group:prx-tg-0123a01b12345c0ab",
        "IsDefault": true,
        "Status": "available",
        "ConnectionPoolConfig": {
            "MaxConnectionsPercent": 100,
            "MaxIdleConnectionsPercent": 50,
            "ConnectionBorrowTimeout": 120,
            "SessionPinningFilters": []
        },
        "CreatedDate": "2023-05-02T18:41:19.495000+00:00",
        "UpdatedDate": "2023-05-02T18:41:21.762000+00:00"
    }
}

Weitere Informationen finden Sie unter Anzeigen eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Anzeigen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-proxy-targets verwendet wird.

AWS CLI

So beschreiben Sie DB-Proxyziele

Im folgenden Beispiel für describe-db-proxy-targets werden Informationen zu DB-Proxyzielen zurückgegeben.

aws rds describe-db-proxy-targets \
    --db-proxy-name proxyExample

Ausgabe:

{
    "Targets": [
        {
            "Endpoint": "database1.ab0cd1efghij.us-east-1.rds.amazonaws.com",
            "TrackedClusterId": "database1",
            "RdsResourceId": "database1-instance-1",
            "Port": 3306,
            "Type": "RDS_INSTANCE",
            "Role": "READ_WRITE",
            "TargetHealth": {
                "State": "UNAVAILABLE",
                "Reason": "PENDING_PROXY_CAPACITY",
                "Description": "DBProxy Target is waiting for proxy to scale to desired capacity"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Anzeigen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-recommendations verwendet wird.

AWS CLI

Beispiel 1: So listen Sie alle DB-Empfehlungen auf

Im folgenden Beispiel für describe-db-recommendations werden alle DB-Empfehlungen in Ihrem AWS-Konto aufgelistet.

aws rds describe-db-recommendations

Ausgabe:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::old_minor_version",
            "Severity": "informational",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.292000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "**[resource-name]** is not running the latest minor DB engine version",
            "Recommendation": "Upgrade to latest engine version",
            "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Operation": "modifyDbInstance",
                    "Parameters": [
                        {
                            "Key": "EngineVersion",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "DBInstanceIdentifier",
                            "Value": "database-1"
                        }
                    ],
                    "ApplyModes": [
                        "immediately",
                        "next-maintenance-window"
                    ],
                    "Status": "ready",
                    "ContextAttributes": [
                        {
                            "Key": "Recommended value",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "Current engine version",
                            "Value": "5.7.42"
                        }
                    ]
                }
            ],
            "Category": "security",
            "Source": "RDS",
            "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
            "TypeRecommendation": "Upgrade to latest engine version",
            "Impact": "Reduced database performance and data security at risk",
            "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
            "Links": [
                {
                    "Text": "Upgrading an RDS DB instance engine version",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon RDS und Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon Aurora.

Beispiel 2: So listen Sie DB-Empfehlungen mit hohem Schweregrad auf

Im folgenden Beispiel für describe-db-recommendations werden DB-Empfehlungen mit hohem Schweregrad in Ihrem AWS-Konto aufgelistet.

aws rds describe-db-recommendations \
    --filters Name=severity,Values=high

Ausgabe:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::rds_extended_support",
            "Severity": "high",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.392000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "Your databases will be auto-enrolled to RDS Extended Support on February 29",
            "Recommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges",
            "Description": "Your PostgreSQL 11 and MySQL 5.7 databases will be automatically enrolled into RDS Extended Support on February 29, 2024. To avoid the increase in charges due to RDS Extended Support, we recommend upgrading your databases to a newer major engine version before February 29, 2024.\nTo learn more about the RDS Extended Support pricing, refer to the pricing page.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Parameters": [],
                    "ApplyModes": [
                        "manual"
                    ],
                    "Status": "ready",
                    "ContextAttributes": []
                }
            ],
            "Category": "cost optimization",
            "Source": "RDS",
            "TypeDetection": "Your database will be auto-enrolled to RDS Extended Support on February 29",
            "TypeRecommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges",
            "Impact": "Increase in charges due to RDS Extended Support",
            "AdditionalInfo": "With Amazon RDS Extended Support, you can continue running your database on a major engine version past the RDS end of standard support date for an additional cost. This paid feature gives you more time to upgrade to a supported major engine version.\nDuring Extended Support, Amazon RDS will supply critical CVE patches and bug fixes.",
            "Links": [
                {
                    "Text": "Amazon RDS Extended Support pricing for RDS for MySQL",
                    "Url": "https://aws.amazon.com/rds/mysql/pricing/"
                },
                {
                    "Text": "Amazon RDS Extended Support for RDS for MySQL and PostgreSQL databases",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html"
                },
                {
                    "Text": "Amazon RDS Extended Support pricing for Amazon Aurora PostgreSQL",
                    "Url": "https://aws.amazon.com/rds/aurora/pricing/"
                },
                {
                    "Text": "Amazon RDS Extended Support for Aurora PostgreSQL databases",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/extended-support.html"
                },
                {
                    "Text": "Amazon RDS Extended Support pricing for RDS for PostgreSQL",
                    "Url": "https://aws.amazon.com/rds/postgresql/pricing/"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon RDS und Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon Aurora.

Beispiel 3: So listen Sie DB-Empfehlungen für eine angegebene DB-Instance auf

Im folgenden Beispiel für describe-db-recommendations werden alle DB-Empfehlungen für eine angegebene DB-Instance aufgelistet.

aws rds describe-db-recommendations \
    --filters Name=dbi-resource-id,Values=database-1

Ausgabe:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::old_minor_version",
            "Severity": "informational",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.292000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "**[resource-name]** is not running the latest minor DB engine version",
            "Recommendation": "Upgrade to latest engine version",
            "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Operation": "modifyDbInstance",
                    "Parameters": [
                        {
                            "Key": "EngineVersion",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "DBInstanceIdentifier",
                            "Value": "database-1"
                        }
                    ],
                    "ApplyModes": [
                        "immediately",
                        "next-maintenance-window"
                    ],
                    "Status": "ready",
                    "ContextAttributes": [
                        {
                            "Key": "Recommended value",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "Current engine version",
                            "Value": "5.7.42"
                        }
                    ]
                }
            ],
            "Category": "security",
            "Source": "RDS",
            "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
            "TypeRecommendation": "Upgrade to latest engine version",
            "Impact": "Reduced database performance and data security at risk",
            "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
            "Links": [
                {
                    "Text": "Upgrading an RDS DB instance engine version",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon RDS und Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon Aurora.

Beispiel 4: So listen Sie alle aktiven DB-Empfehlungen auf

Im folgenden Beispiel für describe-db-recommendations werden alle aktiven DB-Empfehlungen in Ihrem AWS-Konto aufgelistet.

aws rds describe-db-recommendations \
    --filters Name=status,Values=active

Ausgabe:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::old_minor_version",
            "Severity": "informational",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.292000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "**[resource-name]** is not running the latest minor DB engine version",
            "Recommendation": "Upgrade to latest engine version",
            "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Operation": "modifyDbInstance",
                    "Parameters": [
                        {
                            "Key": "EngineVersion",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "DBInstanceIdentifier",
                            "Value": "database-1"
                        }
                    ],
                    "ApplyModes": [
                        "immediately",
                        "next-maintenance-window"
                    ],
                    "Status": "ready",
                    "ContextAttributes": [
                        {
                            "Key": "Recommended value",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "Current engine version",
                            "Value": "5.7.42"
                        }
                    ]
                }
            ],
            "Category": "security",
            "Source": "RDS",
            "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
            "TypeRecommendation": "Upgrade to latest engine version",
            "Impact": "Reduced database performance and data security at risk",
            "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
            "Links": [
                {
                    "Text": "Upgrading an RDS DB instance engine version",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon RDS und Anzeigen und Beantworten von Amazon-RDS-Empfehlungen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-security-groups verwendet wird.

AWS CLI

So listen Sie DB-Sicherheitsgruppen auf

Im folgenden Beispiel für describe-db-security-groups werden DB-Sicherheitsgruppen aufgelistet.

aws rds describe-db-security-groups

Ausgabe:

{
    "DBSecurityGroups": [
        {
            "OwnerId": "123456789012",
            "DBSecurityGroupName": "default",
            "DBSecurityGroupDescription": "default",
            "EC2SecurityGroups": [],
            "IPRanges": [],
            "DBSecurityGroupArn": "arn:aws:rds:us-west-1:111122223333:secgrp:default"
        },
        {
            "OwnerId": "123456789012",
            "DBSecurityGroupName": "mysecgroup",
            "DBSecurityGroupDescription": "My Test Security Group",
            "VpcId": "vpc-1234567f",
            "EC2SecurityGroups": [],
            "IPRanges": [],
            "DBSecurityGroupArn": "arn:aws:rds:us-west-1:111122223333:secgrp:mysecgroup"
        }
    ]
}

Weitere Informationen finden Sie unter Auflistung verfügbarer DB-Sicherheitsgruppen im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-db-shard-groups verwendet wird.

AWS CLI

Beispiel 1: So beschreiben Sie DB-Shard-Gruppen

Im folgenden Beispiel für describe-db-shard-groups werden Details zu Ihren DB-Shard-Gruppen abgerufen.

aws rds describe-db-shard-groups

Ausgabe:

{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
            "DBShardGroupIdentifier": "limitless-test-shard-grp",
            "DBClusterIdentifier": "limitless-test-cluster",
            "MaxACU": 768.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": true,
            "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        },
        {
            "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
            "DBShardGroupIdentifier": "my-db-shard-group",
            "DBClusterIdentifier": "my-sv2-cluster",
            "MaxACU": 768.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Weitere Informationen finden Sie unter Amazon-Aurora-DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-db-snapshot-attributes verwendet wird.

AWS CLI

So beschreiben Sie die Attributnamen und -werte für einen DB-Snapshot

Im folgenden Beispiel für describe-db-snapshot-attributes werden die Attributnamen und -werte für einen DB-Snapshot beschrieben.

aws rds describe-db-snapshot-attributes \
    --db-snapshot-identifier mydbsnapshot

Ausgabe:

{
    "DBSnapshotAttributesResult": {
        "DBSnapshotIdentifier": "mydbsnapshot",
        "DBSnapshotAttributes": [
            {
                "AttributeName": "restore",
                "AttributeValues": [
                    "123456789012",
                    "210987654321"
                ]
            }
        ]
    }
}

Weitere Informationen finden Sie unter Freigeben eines DB-Snapshots im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-db-snapshots verwendet wird.

AWS CLI

Beispiel 1: So beschreiben Sie einen DB-Snapshot für eine DB-Instance

Im folgenden Beispiel für describe-db-snapshots werden die Details eines DB-Snapshots für eine DB-Instance abgerufen.

aws rds describe-db-snapshots \
    --db-snapshot-identifier mydbsnapshot

Ausgabe:

{
    "DBSnapshots": [
        {
            "DBSnapshotIdentifier": "mydbsnapshot",
            "DBInstanceIdentifier": "mysqldb",
            "SnapshotCreateTime": "2018-02-08T22:28:08.598Z",
            "Engine": "mysql",
            "AllocatedStorage": 20,
            "Status": "available",
            "Port": 3306,
            "AvailabilityZone": "us-east-1f",
            "VpcId": "vpc-6594f31c",
            "InstanceCreateTime": "2018-02-08T22:24:55.973Z",
            "MasterUsername": "mysqladmin",
            "EngineVersion": "5.6.37",
            "LicenseModel": "general-public-license",
            "SnapshotType": "manual",
            "OptionGroupName": "default:mysql-5-6",
            "PercentProgress": 100,
            "StorageType": "gp2",
            "Encrypted": false,
            "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot",
            "IAMDatabaseAuthenticationEnabled": false,
            "ProcessorFeatures": [],
            "DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE"
        }
    ]
}

Weitere Informationen finden Sie unter Erstellen eines DB-Snapshots im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So ermitteln Sie die Anzahl der manuell erstellten Snapshots

Im folgenden Beispiel für describe-db-snapshots wird der Operator length in der Option --query verwendet, um die Anzahl der manuellen Snapshots zurückzugeben, die in einer bestimmten AWS-Region erstellt wurden.

aws rds describe-db-snapshots \
    --snapshot-type manual \
    --query "length(*[].{DBSnapshots:SnapshotType})" \
    --region eu-central-1

Ausgabe:

35

Weitere Informationen finden Sie unter Erstellen eines DB-Snapshots im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-db-subnet-groups verwendet wird.

AWS CLI

So beschreiben Sie eine DB-Subnetzgruppe

Im folgenden Beispiel für describe-db-subnet-groups werden die Details der angegebenen DB-Subnetzgruppe abgerufen.

aws rds describe-db-subnet-groups

Ausgabe:

{
    "DBSubnetGroups": [
        {
            "DBSubnetGroupName": "mydbsubnetgroup",
            "DBSubnetGroupDescription": "My DB Subnet Group",
            "VpcId": "vpc-971c12ee",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-d8c8e7f4",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-718fdc7d",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1f"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-cbc8e7e7",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-0ccde220",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                }
            ],
            "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123456789012:subgrp:mydbsubnetgroup"
        }
    ]
}

Weitere Informationen zur Amazon Virtual Private Cloud VPCs und Amazon RDS finden Sie im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-engine-default-cluster-parameters verwendet wird.

AWS CLI

So beschreiben Sie die Standard-Engine- und Systemparameterinformationen für die Aurora-Datenbank-Engine

Im folgenden Beispiel für describe-engine-default-cluster-parameters werden die Details der Standard-Engine und die Systemparameterinformationen für Aurora-DB-Cluster mit MySQL 5.7-Kompatibilität abgerufen.

aws rds describe-engine-default-cluster-parameters \
    --db-parameter-group-family aurora-mysql5.7

Ausgabe:

{
    "EngineDefaults": {
        "Parameters": [
            {
                "ParameterName": "aurora_load_from_s3_role",
                "Description": "IAM role ARN used to load data from AWS S3",
                "Source": "engine-default",
                "ApplyType": "dynamic",
                "DataType": "string",
                "IsModifiable": true,
                "SupportedEngineModes": [
                    "provisioned"
                ]
            },
            ...some output truncated...
        ]
    }
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-engine-default-parameters verwendet wird.

AWS CLI

So beschreiben Sie die Standard-Engine- und Systemparameterinformationen für die Datenbank-Engine

Im folgenden Beispiel für describe-engine-default-parameters werden Details für die Standard-Engine- und Systemparameterinformationen für MySQL 5.7 DB-Instances abgerufen.

aws rds describe-engine-default-parameters \
    --db-parameter-group-family mysql5.7

Ausgabe:

{
    "EngineDefaults": {
        "Parameters": [
            {
                "ParameterName": "allow-suspicious-udfs",
                "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
                "Source": "engine-default",
                "ApplyType": "static",
                "DataType": "boolean",
                "AllowedValues": "0,1",
                "IsModifiable": false
            },
            ...some output truncated...
        ]
    }
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-event-categories verwendet wird.

AWS CLI

So beschreiben Sie Ereigniskategorien

Im folgenden Beispiel für describe-event-categories werden Details zu den Ereigniskategorien für alle verfügbaren Ereignisquellen abgerufen.

aws rds describe-event-categories

Ausgabe:

{
    "EventCategoriesMapList": [
        {
            "SourceType": "db-instance",
            "EventCategories": [
                "deletion",
                "read replica",
                "failover",
                "restoration",
                "maintenance",
                "low storage",
                "configuration change",
                "backup",
                "creation",
                "availability",
                "recovery",
                "failure",
                "backtrack",
                "notification"
            ]
        },
        {
            "SourceType": "db-security-group",
            "EventCategories": [
                "configuration change",
                "failure"
            ]
        },
        {
            "SourceType": "db-parameter-group",
            "EventCategories": [
                "configuration change"
            ]
        },
        {
            "SourceType": "db-snapshot",
            "EventCategories": [
                "deletion",
                "creation",
                "restoration",
                "notification"
            ]
        },
        {
            "SourceType": "db-cluster",
            "EventCategories": [
                "failover",
                "failure",
                "notification"
            ]
        },
        {
            "SourceType": "db-cluster-snapshot",
            "EventCategories": [
                "backup"
            ]
        }
    ]
}

Das folgende Codebeispiel zeigt, wie describe-event-subscriptions verwendet wird.

AWS CLI

So beschreiben Sie Ereignisabonnements

In diesem Beispiel werden alle Amazon-RDS-Ereignisabonnements für das aktuelleAWS-Konto beschrieben.

aws rds describe-event-subscriptions

Ausgabe:

{
    "EventSubscriptionsList": [
        {
            "EventCategoriesList": [
                "backup",
                "recovery"
            ],
            "Enabled": true,
            "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
            "Status": "creating",
            "SourceType": "db-instance",
            "CustomerAwsId": "123456789012",
            "SubscriptionCreationTime": "2018-07-31 23:22:01.893",
            "CustSubscriptionId": "my-instance-events",
            "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events"
        },
        ...some output truncated...
    ]
}

Das folgende Codebeispiel zeigt, wie describe-events verwendet wird.

AWS CLI

So beschreiben Sie Ereignisse

Im folgenden Beispiel für describe-events werden Details zu den Ereignissen abgerufen, die für die angegebene DB-Instance aufgetreten sind.

aws rds describe-events \
    --source-identifier test-instance \
    --source-type db-instance

Ausgabe:

{
    "Events": [
        {
            "SourceType": "db-instance",
            "SourceIdentifier": "test-instance",
            "EventCategories": [
                "backup"
            ],
            "Message": "Backing up DB instance",
            "Date": "2018-07-31T23:09:23.983Z",
            "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance"
        },
        {
            "SourceType": "db-instance",
            "SourceIdentifier": "test-instance",
            "EventCategories": [
                "backup"
            ],
            "Message": "Finished DB Instance backup",
            "Date": "2018-07-31T23:15:13.049Z",
            "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance"
        }
    ]
}

  • API-Details finden Sie unter DescribeEvents in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-export-tasks verwendet wird.

AWS CLI

So beschreiben Sie Snapshot-Exportaufgaben

Im folgenden Beispiel für describe-export-tasks werden Informationen über Snapshot-Exporte nach Amazon S3 zurückgegeben.

aws rds describe-export-tasks

Ausgabe:

{
    "ExportTasks": [
        {
            "ExportTaskIdentifier": "test-snapshot-export",
            "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:test-snapshot",
            "SnapshotTime": "2020-03-02T18:26:28.163Z",
            "TaskStartTime": "2020-03-02T18:57:56.896Z",
            "TaskEndTime": "2020-03-02T19:10:31.985Z",
            "S3Bucket": "amzn-s3-demo-bucket",
            "S3Prefix": "",
            "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
            "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
            "Status": "COMPLETE",
            "PercentProgress": 100,
            "TotalExtractedDataInGB": 0
        },
        {
            "ExportTaskIdentifier": "my-s3-export",
            "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test",
            "SnapshotTime": "2020-03-27T20:48:42.023Z",
            "S3Bucket": "amzn-s3-demo-bucket",
            "S3Prefix": "",
            "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
            "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
            "Status": "STARTING",
            "PercentProgress": 0,
            "TotalExtractedDataInGB": 0
        }
    ]
}

Weitere Informationen finden Sie unter Überwachung von Snapshot-Exporten im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-global-clusters verwendet wird.

AWS CLI

So beschreiben Sie globale DB-Cluster

Im folgenden Beispiel für describe-global-clusters werden globale Aurora-DB-Cluster in der aktuellen AWS-Region aufgelistet.

aws rds describe-global-clusters

Ausgabe:

{
    "GlobalClusters": [
        {
            "GlobalClusterIdentifier": "myglobalcluster",
            "GlobalClusterResourceId": "cluster-f5982077e3b5aabb",
            "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
            "Status": "available",
            "Engine": "aurora-mysql",
            "EngineVersion": "5.7.mysql_aurora.2.07.2",
            "StorageEncrypted": false,
            "DeletionProtection": false,
            "GlobalClusterMembers": []
        }
    ]
}

Weitere Informationen finden Sie unter Verwalten einer Aurora Global Database im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie describe-option-group-options verwendet wird.

AWS CLI

So beschreiben Sie alle verfügbaren Optionen

Im folgenden Beispiel für describe-option-group-options werden zwei Optionen für eine Oracle Database 19c-Instance aufgelistet.

aws rds describe-option-group-options \
    --engine-name oracle-ee \
    --major-engine-version 19 \
    --max-items 2

Ausgabe:

{
    "OptionGroupOptions": [
        {
            "Name": "APEX",
            "Description": "Oracle Application Express Runtime Environment",
            "EngineName": "oracle-ee",
            "MajorEngineVersion": "19",
            "MinimumRequiredMinorEngineVersion": "0.0.0.ru-2019-07.rur-2019-07.r1",
            "PortRequired": false,
            "OptionsDependedOn": [],
            "OptionsConflictsWith": [],
            "Persistent": false,
            "Permanent": false,
            "RequiresAutoMinorEngineVersionUpgrade": false,
            "VpcOnly": false,
            "SupportsOptionVersionDowngrade": false,
            "OptionGroupOptionSettings": [],
            "OptionGroupOptionVersions": [
                {
                    "Version": "19.1.v1",
                    "IsDefault": true
                },
                {
                    "Version": "19.2.v1",
                    "IsDefault": false
                }
            ]
        },
        {
            "Name": "APEX-DEV",
            "Description": "Oracle Application Express Development Environment",
            "EngineName": "oracle-ee",
            "MajorEngineVersion": "19",
            "MinimumRequiredMinorEngineVersion": "0.0.0.ru-2019-07.rur-2019-07.r1",
            "PortRequired": false,
            "OptionsDependedOn": [
                "APEX"
            ],
            "OptionsConflictsWith": [],
            "Persistent": false,
            "Permanent": false,
            "RequiresAutoMinorEngineVersionUpgrade": false,
            "VpcOnly": false,
            "OptionGroupOptionSettings": []
        }
    ],
    "NextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ=="
}

Weitere Informationen finden Sie unter Auflisten der Optionen und Optionseinstellungen für eine Optionsgruppe im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-option-groups verwendet wird.

AWS CLI

So beschreiben Sie die verfügbaren Optionsgruppen

Im folgenden Beispiel für describe-option-groups werden die Optionsgruppen für eine Oracle Database 19c-Instance aufgelistet.

aws rds describe-option-groups \
    --engine-name oracle-ee \
    --major-engine-version 19

Ausgabe:

{
    "OptionGroupsList": [
        {
            "OptionGroupName": "default:oracle-ee-19",
            "OptionGroupDescription": "Default option group for oracle-ee 19",
            "EngineName": "oracle-ee",
            "MajorEngineVersion": "19",
            "Options": [],
            "AllowsVpcAndNonVpcInstanceMemberships": true,
            "OptionGroupArn": "arn:aws:rds:us-west-1:111122223333:og:default:oracle-ee-19"
        }
    ]
}

Weitere Informationen finden Sie unter Auflisten der Optionen und Optionseinstellungen für eine Optionsgruppe im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-orderable-db-instance-options verwendet wird.

AWS CLI

So beschreiben Sie bestellbare DB-Instance-Optionen

Im folgenden Beispiel für describe-orderable-db-instance-options werden Details zu den bestellbaren Optionen für DB-Instances abgerufen, auf denen die MySQL-DB-Engine ausgeführt wird.

aws rds describe-orderable-db-instance-options \
    --engine mysql

Ausgabe:

{
    "OrderableDBInstanceOptions": [
        {
            "MinStorageSize": 5,
            "ReadReplicaCapable": true,
            "MaxStorageSize": 6144,
            "AvailabilityZones": [
                {
                    "Name": "us-east-1a"
                },
                {
                    "Name": "us-east-1b"
                },
                {
                    "Name": "us-east-1c"
                },
                {
                    "Name": "us-east-1d"
                }
            ],
            "SupportsIops": false,
            "AvailableProcessorFeatures": [],
            "MultiAZCapable": true,
            "DBInstanceClass": "db.m1.large",
            "Vpc": true,
            "StorageType": "gp2",
            "LicenseModel": "general-public-license",
            "EngineVersion": "5.5.46",
            "SupportsStorageEncryption": false,
            "SupportsEnhancedMonitoring": true,
            "Engine": "mysql",
            "SupportsIAMDatabaseAuthentication": false,
            "SupportsPerformanceInsights": false
        }
    ]
    ...some output truncated...
}

Das folgende Codebeispiel zeigt, wie describe-pending-maintenance-actions verwendet wird.

AWS CLI

So listen Sie Ressourcen mit mindestens einer ausstehenden Wartungsaktion auf

Im folgenden Beispiel für describe-pending-maintenance-actions werden anstehende Wartungsaktionen für eine DB-Instance aufgelistet.

aws rds describe-pending-maintenance-actions

Ausgabe:

{
    "PendingMaintenanceActions": [
        {
            "ResourceIdentifier": "arn:aws:rds:us-west-2:123456789012:cluster:global-db1-cl1",
            "PendingMaintenanceActionDetails": [
                {
                    "Action": "system-update",
                    "Description": "Upgrade to Aurora PostgreSQL 2.4.2"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter Verwalten einer DB-Instance im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-reserved-db-instances-offerings verwendet wird.

AWS CLI

So beschreiben Sie Reserved-Instance-Angebote

Im folgenden Beispiel für describe-reserved-db-instances-offerings werden Details zu den reservierten DB-Instance-Optionen für oracle abgerufen.

aws rds describe-reserved-db-instances-offerings \
    --product-description oracle

Ausgabe:

{
    "ReservedDBInstancesOfferings": [
        {
            "CurrencyCode": "USD",
            "UsagePrice": 0.0,
            "ProductDescription": "oracle-se2(li)",
            "ReservedDBInstancesOfferingId": "005bdee3-9ef4-4182-aa0c-58ef7cb6c2f8",
            "MultiAZ": true,
            "DBInstanceClass": "db.m4.xlarge",
            "OfferingType": "Partial Upfront",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": 0.594,
                    "RecurringChargeFrequency": "Hourly"
                }
            ],
            "FixedPrice": 4089.0,
            "Duration": 31536000
        },
    ...some output truncated...
}

Das folgende Codebeispiel zeigt, wie describe-reserved-db-instances verwendet wird.

AWS CLI

So beschreiben Sie reservierte DB-Instances

Im folgenden Beispiel für describe-reserved-db-instances werden Details zu allen reservierten DB-Instances im aktuellen AWS-Konto abgerufen.

aws rds describe-reserved-db-instances

Ausgabe:

{
    "ReservedDBInstances": [
        {
            "ReservedDBInstanceId": "myreservedinstance",
            "ReservedDBInstancesOfferingId": "12ab34cd-59af-4b2c-a660-1abcdef23456",
            "DBInstanceClass": "db.t3.micro",
            "StartTime": "2020-06-01T13:44:21.436Z",
            "Duration": 31536000,
            "FixedPrice": 0.0,
            "UsagePrice": 0.0,
            "CurrencyCode": "USD",
            "DBInstanceCount": 1,
            "ProductDescription": "sqlserver-ex(li)",
            "OfferingType": "No Upfront",
            "MultiAZ": false,
            "State": "payment-pending",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": 0.014,
                    "RecurringChargeFrequency": "Hourly"
                }
            ],
            "ReservedDBInstanceArn": "arn:aws:rds:us-west-2:123456789012:ri:myreservedinstance",
            "LeaseId": "a1b2c3d4-6b69-4a59-be89-5e11aa446666"
        }
    ]
}

Weitere Informationen finden Sie unter Reservierte Instances für Amazon RDS im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-source-regions verwendet wird.

AWS CLI

So beschreiben Sie Quellregionen

Im folgenden Beispiel für describe-source-regions werden Details zu allen AWS-Quellregionen abgerufen. Es zeigt auch, dass automatisierte Backups nur von USA West (Oregon) in die AWS-Zielregion USA Ost (N. Virginia) repliziert werden können.

aws rds describe-source-regions \
    --region us-east-1

Ausgabe:

{
    "SourceRegions": [
        {
            "RegionName": "af-south-1",
            "Endpoint": "https://rds.af-south-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": false
        },
        {
            "RegionName": "ap-east-1",
            "Endpoint": "https://rds.ap-east-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": false
        },
        {
            "RegionName": "ap-northeast-1",
            "Endpoint": "https://rds.ap-northeast-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "ap-northeast-2",
            "Endpoint": "https://rds.ap-northeast-2.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "ap-northeast-3",
            "Endpoint": "https://rds.ap-northeast-3.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": false
        },
        {
            "RegionName": "ap-south-1",
            "Endpoint": "https://rds.ap-south-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "ap-southeast-1",
            "Endpoint": "https://rds.ap-southeast-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "ap-southeast-2",
            "Endpoint": "https://rds.ap-southeast-2.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "ap-southeast-3",
            "Endpoint": "https://rds.ap-southeast-3.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": false
        },
        {
            "RegionName": "ca-central-1",
            "Endpoint": "https://rds.ca-central-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "eu-north-1",
            "Endpoint": "https://rds.eu-north-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "eu-south-1",
            "Endpoint": "https://rds.eu-south-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": false
        },
        {
            "RegionName": "eu-west-1",
            "Endpoint": "https://rds.eu-west-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "eu-west-2",
            "Endpoint": "https://rds.eu-west-2.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "eu-west-3",
            "Endpoint": "https://rds.eu-west-3.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "me-central-1",
             "Endpoint": "https://rds.me-central-1.amazonaws.com",
             "Status": "available",
             "SupportsDBInstanceAutomatedBackupsReplication": false
        },
        {
            "RegionName": "me-south-1",
            "Endpoint": "https://rds.me-south-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": false
        },
        {
            "RegionName": "sa-east-1",
            "Endpoint": "https://rds.sa-east-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "us-east-2",
            "Endpoint": "https://rds.us-east-2.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "us-west-1",
            "Endpoint": "https://rds.us-west-1.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        },
        {
            "RegionName": "us-west-2",
           "Endpoint": "https://rds.us-west-2.amazonaws.com",
            "Status": "available",
            "SupportsDBInstanceAutomatedBackupsReplication": true
        }
    ]
}

Weitere Informationen finden Sie unter Suchen nach Informationen über replizierte Backups im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie describe-valid-db-instance-modifications verwendet wird.

AWS CLI

So beschreiben Sie gültige Änderungen für eine DB-Instance

Im folgenden Beispiel für describe-valid-db-instance-modifications werden Details zu den gültigen Änderungen für die angegebene DB-Instance abgerufen.

aws rds describe-valid-db-instance-modifications \
    --db-instance-identifier test-instance

Ausgabe:

{
    "ValidDBInstanceModificationsMessage": {
        "ValidProcessorFeatures": [],
        "Storage": [
            {
                "StorageSize": [
                    {
                        "Step": 1,
                        "To": 20,
                        "From": 20
                    },
                    {
                        "Step": 1,
                        "To": 6144,
                        "From": 22
                    }
                ],
                "ProvisionedIops": [
                    {
                        "Step": 1,
                        "To": 0,
                        "From": 0
                    }
                ],
                "IopsToStorageRatio": [
                    {
                        "To": 0.0,
                        "From": 0.0
                    }
                ],
                "StorageType": "gp2"
            },
            {
                "StorageSize": [
                    {
                        "Step": 1,
                        "To": 6144,
                        "From": 100
                    }
                ],
                "ProvisionedIops": [
                    {
                        "Step": 1,
                        "To": 40000,
                        "From": 1000
                    }
                ],
                "IopsToStorageRatio": [
                    {
                        "To": 50.0,
                        "From": 1.0
                    }
                ],
                "StorageType": "io1"
            },
            {
                "StorageSize": [
                    {
                        "Step": 1,
                        "To": 20,
                        "From": 20
                    },
                    {
                        "Step": 1,
                        "To": 3072,
                        "From": 22
                    }
                ],
                "ProvisionedIops": [
                    {
                        "Step": 1,
                        "To": 0,
                        "From": 0
                    }
                ],
                "IopsToStorageRatio": [
                    {
                        "To": 0.0,
                        "From": 0.0
                    }
                ],
                "StorageType": "magnetic"
            }
        ]
    }
}

Das folgende Codebeispiel zeigt, wie download-db-log-file-portion verwendet wird.

AWS CLI

Beispiel 1: So laden Sie den neuesten Teil einer DB-Protokolldatei herunter

Im folgenden Beispiel für download-db-log-file-portion wird nur der neueste Teil Ihrer Protokolldatei heruntergeladen und in einer lokalen Datei namens tail.txt gespeichert.

aws rds download-db-log-file-portion \
    --db-instance-identifier test-instance \
    --log-file-name log.txt \
    --output text > tail.txt

Die gespeicherte Datei enthält möglicherweise Leerzeilen. Diese erscheinen jeweils am Ende jedes Teils der Protokolldatei während des Downloads.

Beispiel 2: So laden Sie eine komplette DB-Protokolldatei herunter

Im folgenden Beispiel für download-db-log-file-portion wird die komplette Protokolldatei unter Verwendung des --starting-token 0-Parameters heruntergeladen und die Ausgabe in einer lokalen Datei namens full.txt gespeichert.

aws rds download-db-log-file-portion \
    --db-instance-identifier test-instance \
    --log-file-name log.txt \
    --starting-token 0 \
    --output text > full.txt

Die gespeicherte Datei enthält möglicherweise Leerzeilen. Diese erscheinen jeweils am Ende jedes Teils der Protokolldatei während des Downloads.

Das folgende Codebeispiel zeigt, wie generate-auth-token verwendet wird.

AWS CLI

Generieren eines Authentifizierungstokens

Im folgenden Beispiel für generate-db-auth-token wird ein Authentifizierungstoken zur Verwendung mit der IAM-Datenbankauthentifizierung generiert.

aws rds generate-db-auth-token \
    --hostname aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com \
    --port 3306 \
    --region us-east-1 \
    --username jane_doe

Ausgabe:

aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com:3306/?Action=connect&DBUser=jane_doe&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIESZCNJ3OEXAMPLE%2F20180731%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20180731T235209Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=5a8753ebEXAMPLEa2c724e5667797EXAMPLE9d6ec6e3f427191fa41aeEXAMPLE

Das folgende Codebeispiel zeigt, wie generate-db-auth-token verwendet wird.

AWS CLI

So generieren Sie ein Authentifizierungstoken

Im folgenden Beispiel für generate-db-auth-token wird ein IAM-Authentifizierungstoken generiert, um eine Verbindung zu einer Datenbank herzustellen.

aws rds generate-db-auth-token \
    --hostname mydb.123456789012.us-east-1.rds.amazonaws.com \
    --port 3306 \
    --region us-east-1 \
    --username db_user

Ausgabe:

mydb.123456789012.us-east-1.rds.amazonaws.com:3306/?Action=connect&DBUser=db_user&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIEXAMPLE%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20210123T011543Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=88987EXAMPLE1EXAMPLE2EXAMPLE3EXAMPLE4EXAMPLE5EXAMPLE6

Weitere Informationen finden Sie unter Herstellen einer Verbindung zu Ihrer DB-Instance mithilfe der IAM-Authentifizierung im Benutzerhandbuch zu Amazon RDS und Herstellen einer Verbindung zu Ihrem DB-Cluster mithilfe der IAM-Authentifizierung im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie alle Tags in einer Amazon-RDS-Ressource auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags einer DB-Instance aufgelistet.

aws rds list-tags-for-resource \
    --resource-name arn:aws:rds:us-east-1:123456789012:db:orcl1

Ausgabe:

{
    "TagList": [
        {
            "Key": "Environment",
            "Value": "test"
        },
        {
            "Key": "Name",
            "Value": "MyDatabase"
        }
    ]
}

Weitere Informationen finden Sie unter Hinzufügen von Tags zu Amazon-EKS-Ressourcen im Entwicklerhandbuch zu Amazon EKS.

Das folgende Codebeispiel zeigt, wie modify-certificates verwendet wird.

AWS CLI

So überschreiben Sie das standardmäßige SSL/TLS-Zertifikat des Systems für neue DB-Instances vorübergehend

Im folgenden Beispiel für modify-certificates wird das standardmäßige SSL/TLS-Zertifikat des Systems für neue DB-Instances vorübergehend überschrieben.

aws rds modify-certificates \
    --certificate-identifier rds-ca-2019

Ausgabe:

{
    "Certificate": {
        "CertificateIdentifier": "rds-ca-2019",
        "CertificateType": "CA",
        "Thumbprint": "EXAMPLE123456789012",
        "ValidFrom": "2019-09-19T18:16:53Z",
        "ValidTill": "2024-08-22T17:08:50Z",
        "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-2019",
        "CustomerOverride": true,
        "CustomerOverrideValidTill": "2024-08-22T17:08:50Z"
    }
}

Weitere Informationen finden Sie unter Rotieren Ihrer SSL/TLS-Zertifikate im Benutzerhandbuch zu Amazon RDS und Rotieren Ihrer SSL/TLS-Zertifikate im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-current-db-cluster-capacity verwendet wird.

AWS CLI

So skalieren Sie die Kapazität eines Aurora Serverless-DB-Clusters

Im folgenden Beispiel für modify-current-db-cluster-capacity wird die Kapazität eines Aurora Serverless-DB-Clusters auf 8 skaliert.

aws rds modify-current-db-cluster-capacity \
    --db-cluster-identifier mydbcluster \
    --capacity 8

Ausgabe:

{
    "DBClusterIdentifier": "mydbcluster",
    "PendingCapacity": 8,
    "CurrentCapacity": 1,
    "SecondsBeforeTimeout": 300,
    "TimeoutAction": "ForceApplyCapacityChange"
}

Weitere Informationen finden Sie unter Manuelles Skalieren der Kapazität des Aurora Serverless v1-DB-Clusters im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-db-cluster-endpoint verwendet wird.

AWS CLI

So ändern Sie einen benutzerdefinierten DB-Cluster-Endpunkt

Im folgenden Beispiel für modify-db-cluster-endpoint wird der angegebene benutzerdefinierte DB-Cluster-Endpunkt geändert.

aws rds modify-db-cluster-endpoint \
    --db-cluster-endpoint-identifier mycustomendpoint \
    --static-members dbinstance1 dbinstance2 dbinstance3

Ausgabe:

{
    "DBClusterEndpointIdentifier": "mycustomendpoint",
    "DBClusterIdentifier": "mydbcluster",
    "DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE",
    "Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com",
    "Status": "modifying",
    "EndpointType": "CUSTOM",
    "CustomEndpointType": "READER",
    "StaticMembers": [
        "dbinstance1",
        "dbinstance2",
        "dbinstance3"
    ],
    "ExcludedMembers": [],
    "DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint"
}

Weitere Informationen finden Sie unter Verbindungsmanagement in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-db-cluster-parameter-group verwendet wird.

AWS CLI

So ändern Sie Parameter in einer DB-Cluster-Parametergruppe

Im folgenden Beispiel für modify-db-cluster-parameter-group werden die Werte der Parameter in einer DB-Cluster-Parametergruppe geändert.

aws rds modify-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterpg \
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Ausgabe:

{
    "DBClusterParameterGroupName": "mydbclusterpg"
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-db-cluster-snapshot-attribute verwendet wird.

AWS CLI

So ändern Sie das Attribut eines DB-Cluster-Snapshots

Im folgenden Beispiel für modify-db-cluster-snapshot-attribute werden Änderungen am angegebenen Attribut des DB-Cluster-Snapshots vorgenommen.

aws rds modify-db-cluster-snapshot-attribute \
    --db-cluster-snapshot-identifier myclustersnapshot \
    --attribute-name restore \
    --values-to-add 123456789012

Ausgabe:

{
    "DBClusterSnapshotAttributesResult": {
        "DBClusterSnapshotIdentifier": "myclustersnapshot",
        "DBClusterSnapshotAttributes": [
            {
                "AttributeName": "restore",
                "AttributeValues": [
                    "123456789012"
                ]
            }
        ]
    }
}

Weitere Informationen zur Wiederherstellung von Snapshots finden Sie unter Wiederherstellen aus einem DB-Cluster-Snapshot im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-db-cluster verwendet wird.

AWS CLI

Beispiel 2: So ändern Sie einen DB-Cluster

Im folgenden Beispiel für modify-db-cluster wird das Masterbenutzerkennwort für den genannten DB-Cluster namens cluster-2 geändert und die Aufbewahrungsfrist für Backups auf 14 Tage festgelegt. Der Parameter --apply-immediately bewirkt, dass die Änderungen sofort übernommen werden, anstatt auf das nächste Wartungsfenster zu warten.

aws rds modify-db-cluster \
    --db-cluster-identifier cluster-2 \
    --backup-retention-period 14 \
    --master-user-password newpassword99 \
    --apply-immediately

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "eu-central-1b",
            "eu-central-1c",
            "eu-central-1a"
        ],
        "BackupRetentionPeriod": 14,
        "DatabaseName": "",
        "DBClusterIdentifier": "cluster-2",
        "DBClusterParameterGroup": "default.aurora5.6",
        "DBSubnetGroup": "default-vpc-2305ca49",
        "Status": "available",
        "EarliestRestorableTime": "2020-06-03T02:07:29.637Z",
        "Endpoint": "cluster-2.cluster-############.eu-central-1.rds.amazonaws.com",
        "ReaderEndpoint": "cluster-2.cluster-ro-############.eu-central-1.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora",
        "EngineVersion": "5.6.10a",
        "LatestRestorableTime": "2020-06-04T15:11:25.748Z",
        "Port": 3306,
        "MasterUsername": "admin",
        "PreferredBackupWindow": "01:55-02:25",
        "PreferredMaintenanceWindow": "thu:21:14-thu:21:44",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [
            {
                "DBInstanceIdentifier": "cluster-2-instance-1",
                "IsClusterWriter": true,
                "DBClusterParameterGroupStatus": "in-sync",
                "PromotionTier": 1
            }
        ],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-20a5c047",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z1RLNU0EXAMPLE",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:eu-central-1:123456789012:key/d1bd7c8f-5cdb-49ca-8a62-a1b2c3d4e5f6",
        "DbClusterResourceId": "cluster-AGJ7XI77XVIS6FUXHU1EXAMPLE",
        "DBClusterArn": "arn:aws:rds:eu-central-1:123456789012:cluster:cluster-2",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "ClusterCreateTime": "2020-04-03T14:44:02.764Z",
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": true,
        "CrossAccountClone": false,
        "DomainMemberships": []
    }
}

Weitere Informationen finden Sie unter Ändern eines Amazon-Aurora-DB-Clusters im Benutzerhandbuch zu Amazon Aurora.

Beispiel 2: So verknüpfen Sie eine VPC-Sicherheitsgruppe mit einem DB-Cluster

Im folgenden Beispiel für modify-db-instance wird eine bestimmte VPC-Sicherheitsgruppe zugeordnet, und DB-Sicherheitsgruppen werden aus einem DB-Cluster entfernt:

aws rds modify-db-cluster \
    --db-cluster-identifier dbName \
    --vpc-security-group-ids sg-ID

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-west-2c",
            "us-west-2b",
            "us-west-2a"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "dbName",
        "DBClusterParameterGroup": "default.aurora-mysql8.0",
        "DBSubnetGroup": "default",
        "Status": "available",
        "EarliestRestorableTime": "2024-02-15T01:12:13.966000+00:00",
        "Endpoint": "dbName.cluster-abcdefghji.us-west-2.rds.amazonaws.com",
        "ReaderEndpoint": "dbName.cluster-ro-abcdefghji.us-west-2.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-mysql",
        "EngineVersion": "8.0.mysql_aurora.3.04.1",
        "LatestRestorableTime": "2024-02-15T02:25:33.696000+00:00",
        "Port": 3306,
        "MasterUsername": "admin",
        "PreferredBackupWindow": "10:59-11:29",
        "PreferredMaintenanceWindow": "thu:08:54-thu:09:24",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [
            {
                "DBInstanceIdentifier": "dbName-instance-1",
                "IsClusterWriter": true,
                "DBClusterParameterGroupStatus": "in-sync",
                "PromotionTier": 1
            }
        ],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-ID",
                "Status": "active"
            }
        ],
        ...output omitted...
    }
}

Weitere Informationen finden Sie unter Zugriffskontrolle mit Sicherheitsgruppen im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter ModifyDbCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie modify-db-instance verwendet wird.

AWS CLI

Beispiel 1: So ändern Sie eine DB-Instance

Im folgenden Beispiel für modify-db-instance wird eine Options- und Parametergruppe mit einer kompatiblen DB-Instance von Microsoft SQL Server verknüpft. Der Parameter --apply-immediately bewirkt, dass die Options- und Parametergruppen sofort verknüpft werden, anstatt auf das nächste Wartungsfenster zu warten.

aws rds modify-db-instance \
    --db-instance-identifier database-2 \
    --option-group-name test-se-2017 \
    --db-parameter-group-name test-sqlserver-se-2017 \
    --apply-immediately

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "database-2",
        "DBInstanceClass": "db.r4.large",
        "Engine": "sqlserver-se",
        "DBInstanceStatus": "available",

        ...output omitted...

        "DBParameterGroups": [
            {
                "DBParameterGroupName": "test-sqlserver-se-2017",
                "ParameterApplyStatus": "applying"
            }
        ],
        "AvailabilityZone": "us-west-2d",

        ...output omitted...

        "MultiAZ": true,
        "EngineVersion": "14.00.3281.6.v1",
        "AutoMinorVersionUpgrade": false,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "license-included",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "test-se-2017",
                "Status": "pending-apply"
            }
        ],
        "CharacterSetName": "SQL_Latin1_General_CP1_CI_AS",
        "SecondaryAvailabilityZone": "us-west-2c",
        "PubliclyAccessible": true,
        "StorageType": "gp2",

        ...output omitted...

        "DeletionProtection": false,
        "AssociatedRoles": [],
        "MaxAllocatedStorage": 1000
    }
}

Weitere Informationen finden Sie unter Ändern einer Amazon-RDS-DB-Instance im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So verknüpfen Sie eine VPC-Sicherheitsgruppe mit einer DB-Instance

Im folgenden Beispiel für modify-db-instance werden eine bestimmte VPC-Sicherheitsgruppe zugeordnet und DB-Sicherheitsgruppen aus einer DB-Instance entfernt:

aws rds modify-db-instance \
    --db-instance-identifier dbName \
    --vpc-security-group-ids sg-ID

Ausgabe:

{
"DBInstance": {
    "DBInstanceIdentifier": "dbName",
    "DBInstanceClass": "db.t3.micro",
    "Engine": "mysql",
    "DBInstanceStatus": "available",
    "MasterUsername": "admin",
    "Endpoint": {
        "Address": "dbName.abcdefghijk.us-west-2.rds.amazonaws.com",
        "Port": 3306,
        "HostedZoneId": "ABCDEFGHIJK1234"
    },
    "AllocatedStorage": 20,
    "InstanceCreateTime": "2024-02-15T00:37:58.793000+00:00",
    "PreferredBackupWindow": "11:57-12:27",
    "BackupRetentionPeriod": 7,
    "DBSecurityGroups": [],
    "VpcSecurityGroups": [
        {
            "VpcSecurityGroupId": "sg-ID",
            "Status": "active"
        }
    ],
    ... output omitted ...
    "MultiAZ": false,
    "EngineVersion": "8.0.35",
    "AutoMinorVersionUpgrade": true,
    "ReadReplicaDBInstanceIdentifiers": [],
    "LicenseModel": "general-public-license",

    ... output ommited ...
    }
}

Weitere Informationen finden Sie unter Zugriffskontrolle mit Sicherheitsgruppen im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie modify-db-parameter-group verwendet wird.

AWS CLI

So ändern Sie eine DB-Parametergruppe

Im folgenden Beispiel für modify-db-parameter-group wird der Wert des Parameters clr enabled in einer DB-Parametergruppe geändert. Der Parameter --apply-immediately bewirkt, dass die DB-Parametergruppe sofort geändert wird, anstatt auf das nächste Wartungsfenster zu warten.

aws rds modify-db-parameter-group \
    --db-parameter-group-name test-sqlserver-se-2017 \
    --parameters "ParameterName='clr enabled',ParameterValue=1,ApplyMethod=immediate"

Ausgabe:

{
    "DBParameterGroupName": "test-sqlserver-se-2017"
}

Weitere Informationen finden Sie unter Ändern von Parametern in einer DB-Parametergruppe im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie modify-db-proxy-endpoint verwendet wird.

AWS CLI

So ändern Sie einen DB-Proxy-Endpunkt für eine RDS-Datenbank

Im folgenden Beispiel für modify-db-proxy-endpoint wird ein DB-Proxy-Endpunkt proxyEndpoint dahingehend geändert, dass das Lese-Timeout auf 65 Sekunden festgelegt wird.

aws rds modify-db-proxy-endpoint \
    --db-proxy-endpoint-name proxyEndpoint \
    --cli-read-timeout 65

Ausgabe:

{
"DBProxyEndpoint":
    {
        "DBProxyEndpointName": "proxyEndpoint",
        "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
        "DBProxyName": "proxyExample",
        "Status": "available",
        "VpcId": "vpc-1234567",
        "VpcSecurityGroupIds": [
            "sg-1234"
        ],
        "VpcSubnetIds": [
            "subnetgroup1",
            "subnetgroup2"
        ],
        "Endpoint": "proxyEndpoint.endpoint.proxyExample-ab0cd1efghij.us-east-1.rds.amazonaws.com",
        "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
        "TargetRole": "READ_WRITE",
        "IsDefault": "false"
    }
}

Weitere Informationen finden Sie unter Ändern eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon RDS und Ändern eines Proxy-Endpunkts im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-db-proxy-target-group verwendet wird.

AWS CLI

So ändern Sie einen DB-Proxy-Endpunkt

Im folgenden Beispiel für modify-db-proxy-target-group wird eine DB-Proxy-Zielgruppe dahingehend geändert, dass die maximale Anzahl an Verbindungen auf 80 Prozent, und die maximale Anzahl inaktiver Verbindungen auf 10 Prozent festgelegt wird.

aws rds modify-db-proxy-target-group \
    --target-group-name default \
    --db-proxy-name proxyExample \
    --connection-pool-config MaxConnectionsPercent=80,MaxIdleConnectionsPercent=10

Ausgabe:

{
"DBProxyTargetGroup":
    {
        "DBProxyName": "proxyExample",
        "TargetGroupName": "default",
        "TargetGroupArn": "arn:aws:rds:us-east-1:123456789012:target-group:prx-tg-0123a01b12345c0ab",
        "IsDefault": true,
        "Status": "available",
        "ConnectionPoolConfig": {
            "MaxConnectionsPercent": 80,
            "MaxIdleConnectionsPercent": 10,
            "ConnectionBorrowTimeout": 120,
            "SessionPinningFilters": []
        },
        "CreatedDate": "2023-05-02T18:41:19.495000+00:00",
        "UpdatedDate": "2023-05-02T18:41:21.762000+00:00"
    }
}

Weitere Informationen finden Sie unter Ändern eines RDS-Proxy im Benutzerhandbuch zu Amazon RDS und Ändern eines RDS-Proxy im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-db-proxy verwendet wird.

AWS CLI

So ändern Sie einen DB-Proxy für eine RDS-Datenbank

Im folgenden Beispiel für modify-db-proxy wird ein DB-Proxy namens proxyExample so geändert, dass er SSL für seine Verbindungen benötigt.

aws rds modify-db-proxy \
    --db-proxy-name proxyExample \
    --require-tls

Ausgabe:

{
"DBProxy":
    {
        "DBProxyName": "proxyExample",
        "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
        "Status": "modifying"
        "EngineFamily": "PostgreSQL",
        "VpcId": "sg-1234567",
        "VpcSecurityGroupIds": [
            "sg-1234"
        ],
        "VpcSubnetIds": [
            "subnetgroup1",
            "subnetgroup2"
        ],
        "Auth": "[
            {
                "Description": "proxydescription1",
                "AuthScheme": "SECRETS",
                "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e",
                "IAMAuth": "DISABLED"
            }
        ]",
        "RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole",
        "Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
        "RequireTLS": true,
        "IdleClientTimeout": 1800,
        "DebuggingLogging": false,
        "CreatedDate": "2023-04-05T16:09:33.452000+00:00",
        "UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
    }
}

Weitere Informationen finden Sie unter Ändern eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Erstellen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter ModifyDbProxy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie modify-db-shard-group verwendet wird.

AWS CLI

Beispiel 1: So ändern Sie eine DB-Shard-Gruppe

Im folgenden Beispiel für modify-db-shard-group wird die maximale Kapazität einer DB-Shard-Gruppe geändert.

aws rds modify-db-shard-group \
    --db-shard-group-identifier my-db-shard-group \
    --max-acu 1000

Ausgabe:

{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
            "DBShardGroupIdentifier": "my-db-shard-group",
            "DBClusterIdentifier": "my-sv2-cluster",
            "MaxACU": 768.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Weitere Informationen finden Sie unter Amazon-Aurora-DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Beispiel 1: So beschreiben Sie Ihre DB-Shard-Gruppen

Im folgenden Beispiel für describe-db-shard-groups werden Details zu Ihren DB-Shard-Gruppen abgerufen, nachdem Sie den modify-db-shard-group-Befehl ausgeführt haben. Die maximale Kapazität der DB-Shard-Gruppe my-db-shard-group beträgt jetzt 1 000 Aurora-Kapazitätseinheiten (ACUs).

aws rds describe-db-shard-groups

Ausgabe:

{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
            "DBShardGroupIdentifier": "limitless-test-shard-grp",
            "DBClusterIdentifier": "limitless-test-cluster",
            "MaxACU": 768.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": true,
            "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        },
        {
            "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
            "DBShardGroupIdentifier": "my-db-shard-group",
            "DBClusterIdentifier": "my-sv2-cluster",
            "MaxACU": 1000.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Weitere Informationen finden Sie unter Amazon-Aurora-DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie modify-db-snapshot-attribute verwendet wird.

AWS CLI

Beispiel 1: So ermöglichen Sie zwei AWS-Konten die Wiederherstellung eines DB-Snapshots

Im folgenden Beispiel modify-db-snapshot-attribute werden zwei AWS-Konten mit den IDs 111122223333 und 444455556666 die Berechtigung erteilt, den DB-Snapshot namens mydbsnapshot wiederherzustellen.

aws rds modify-db-snapshot-attribute \
    --db-snapshot-identifier mydbsnapshot \
    --attribute-name restore \
    --values-to-add {"111122223333","444455556666"}

Ausgabe:

{
    "DBSnapshotAttributesResult": {
        "DBSnapshotIdentifier": "mydbsnapshot",
        "DBSnapshotAttributes": [
            {
                "AttributeName": "restore",
                "AttributeValues": [
                    "111122223333",
                    "444455556666"
                ]
            }
        ]
    }
}

Weitere Informationen finden Sie unter Freigeben eines Snapshots im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So verhindern Sie, dass ein AWS-Konto einen DB-Snapshot wiederherstellt

Im folgenden Beispiel für modify-db-snapshot-attribute wird einem bestimmten AWS-Konto die Berechtigung zur Wiederherstellung des genannten DB-Snapshots mydbsnapshot entzogen. Wenn dabei ein einzelnes Konto angegeben wird, darf die Konto-ID nicht von Anführungszeichen oder geschweiften Klammern umgeben sein.

aws rds modify-db-snapshot-attribute \
    --db-snapshot-identifier mydbsnapshot \
    --attribute-name restore \
    --values-to-remove 444455556666

Ausgabe:

{
    "DBSnapshotAttributesResult": {
        "DBSnapshotIdentifier": "mydbsnapshot",
        "DBSnapshotAttributes": [
            {
                "AttributeName": "restore",
                "AttributeValues": [
                    "111122223333"
                ]
            }
        ]
    }
}

Weitere Informationen finden Sie unter Freigeben eines Snapshots im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie modify-db-snapshot-attributes verwendet wird.

AWS CLI

So ändern Sie das Attribut eines DB-Snapshots

Im folgenden Beispiel für modify-db-snapshot-attribute wird den zwei AWS-Kontos mit den IDs 111122223333 und 444455556666 die Berechtigung erteilt, den DB-Snapshot namens mydbsnapshot wiederherzustellen.

aws rds modify-db-snapshot-attribute \
    --db-snapshot-identifier mydbsnapshot \
    --attribute-name restore \
    --values-to-add '["111122223333","444455556666"]'

Ausgabe:

{
    "DBSnapshotAttributesResult": {
        "DBSnapshotIdentifier": "mydbsnapshot",
        "DBSnapshotAttributes": [
            {
                "AttributeName": "restore",
                "AttributeValues": [
                    "111122223333",
                    "444455556666"
                ]
            }
        ]
    }
}

Weitere Informationen finden Sie unter Freigeben eines Snapshots im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie modify-db-snapshot verwendet wird.

AWS CLI

So ändern Sie einen DB-Snapshot

Im folgenden Beispiel für modify-db-snapshot wird ein PostgeSQL 10.6-Snapshot namens db5-snapshot-upg-test auf PostgreSQL 11.7 aktualisiert. Die neue DB-Engine-Version wird angezeigt, nachdem das Upgrade des Snapshots abgeschlossen wurde und sein Status verfügbar ist.

aws rds modify-db-snapshot \
    --db-snapshot-identifier db5-snapshot-upg-test \
    --engine-version 11.7

Ausgabe:

{
    "DBSnapshot": {
        "DBSnapshotIdentifier": "db5-snapshot-upg-test",
        "DBInstanceIdentifier": "database-5",
        "SnapshotCreateTime": "2020-03-27T20:49:17.092Z",
        "Engine": "postgres",
        "AllocatedStorage": 20,
        "Status": "upgrading",
        "Port": 5432,
        "AvailabilityZone": "us-west-2a",
        "VpcId": "vpc-2ff27557",
        "InstanceCreateTime": "2020-03-27T19:59:04.735Z",
        "MasterUsername": "postgres",
        "EngineVersion": "10.6",
        "LicenseModel": "postgresql-license",
        "SnapshotType": "manual",
        "OptionGroupName": "default:postgres-11",
        "PercentProgress": 100,
        "StorageType": "gp2",
        "Encrypted": false,
        "DBSnapshotArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-upg-test",
        "IAMDatabaseAuthenticationEnabled": false,
        "ProcessorFeatures": [],
        "DbiResourceId": "db-GJMF75LM42IL6BTFRE4UZJ5YM4"
    }
}

Weitere Informationen finden Sie unter Freigeben eines PostgreSQL-DB-Snapshots im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie modify-db-subnet-group verwendet wird.

AWS CLI

So ändern Sie eine DB-Subnetzgruppe

Im folgenden Beispiel für modify-db-subnet-group wird der DB-Subnetzgruppe namens mysubnetgroup ein Subnetz mit der ID subnet-08e41f9e230222222 hinzugefügt. Damit die vorhandenen Subnetze in der Subnetzgruppe beibehalten werden, geben Sie deren IDs als Werte in der Option --subnet-ids ein. Stellen Sie sicher, dass Subnetze mit mindestens zwei verschiedenen Verfügbarkeitszonen in der DB-Subnetzgruppe vorhanden sind.

aws rds modify-db-subnet-group \
    --db-subnet-group-name mysubnetgroup \
    --subnet-ids '["subnet-0a1dc4e1a6f123456","subnet-070dd7ecb3aaaaaaa","subnet-00f5b198bc0abcdef","subnet-08e41f9e230222222"]'

Ausgabe:

{
    "DBSubnetGroup": {
        "DBSubnetGroupName": "mysubnetgroup",
        "DBSubnetGroupDescription": "test DB subnet group",
        "VpcId": "vpc-0f08e7610a1b2c3d4",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-08e41f9e230222222",
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2a"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-070dd7ecb3aaaaaaa",
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2b"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-00f5b198bc0abcdef",
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2d"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-0a1dc4e1a6f123456",
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2b"
                },
                "SubnetStatus": "Active"
            }
        ],
        "DBSubnetGroupArn": "arn:aws:rds:us-west-2:534026745191:subgrp:mysubnetgroup"
    }
}

Weitere Informationen finden Sie unter Step 2: Erstellen einer DB-Subnetzgruppe im Entwicklerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie modify-event-subscription verwendet wird.

AWS CLI

So ändern Sie ein Ereignisabonnement

Im folgenden Beispiel für modify-event-subscription wird das angegebene Ereignisabonnement deaktiviert, sodass es keine Benachrichtigungen mehr zum angegebenen Amazon Simple Notification Service-Thema veröffentlicht.

aws rds modify-event-subscription \
    --subscription-name my-instance-events \
    --no-enabled

Ausgabe:

{
    "EventSubscription": {
        "EventCategoriesList": [
            "backup",
            "recovery"
        ],
        "CustomerAwsId": "123456789012",
        "SourceType": "db-instance",
        "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
        "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
        "CustSubscriptionId": "my-instance-events",
        "Status": "modifying",
        "Enabled": false
    }
}

Das folgende Codebeispiel zeigt, wie modify-global-cluster verwendet wird.

AWS CLI

So ändern Sie einen globalen DB-Cluster

Im folgenden Beispiel für modify-global-cluster wird der Löschschutz eines Aurora MySQL-kompatibler globalen DB-Clusters aktiviert.

aws rds modify-global-cluster \
    --global-cluster-identifier myglobalcluster \
    --deletion-protection

Ausgabe:

{
    "GlobalCluster": {
        "GlobalClusterIdentifier": "myglobalcluster",
        "GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
        "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
        "Status": "available",
        "Engine": "aurora-mysql",
        "EngineVersion": "5.7.mysql_aurora.2.07.2",
        "StorageEncrypted": false,
        "DeletionProtection": true,
        "GlobalClusterMembers": []
    }
}

Weitere Informationen finden Sie unter Verwalten einer Aurora Global Database im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie promote-read-replica-db-cluster verwendet wird.

AWS CLI

So stufen Sie ein Lesereplikat eines DB-Clusters hoch

Im folgenden Beispiel für promote-read-replica-db-cluster wird das angegebene Lesereplikat zu einem eigenständigen DB-Cluster hochgestuft.

aws rds promote-read-replica-db-cluster \
    --db-cluster-identifier mydbcluster-1

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1c"
        ],
        "BackupRetentionPeriod": 1,
        "DatabaseName": "",
        "DBClusterIdentifier": "mydbcluster-1",
        ...some output truncated...
    }
}

Weitere Informationen finden Sie unter Hochstufen eines Lesereplikats zum DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie promote-read-replica verwendet wird.

AWS CLI

Hochstufen eines Lesereplikats

Im folgenden Beispiel für promote-read-replica wird das angegebene Lesereplikat zu einer eigenständigen DB-Instance hochgestuft.

aws rds promote-read-replica \
    --db-instance-identifier test-instance-repl

Ausgabe:

{
    "DBInstance": {
        "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl",
        "StorageType": "standard",
        "ReadReplicaSourceDBInstanceIdentifier": "test-instance",
        "DBInstanceStatus": "modifying",
        ...some output truncated...
    }
}

Das folgende Codebeispiel zeigt, wie purchase-reserved-db-instance verwendet wird.

AWS CLI

So kaufen Sie ein Angebot für eine reservierte Instance

Im folgenden Beispiel für purchase-reserved-db-instances-offering wird ein reserviertes DB-Instance-Angebot erworben. Die reserved-db-instances-offering-id muss eine gültige Angebots-ID sein, wie sie vom describe-reserved-db-instances-offering-Befehl zurückgegeben wird.

aws rds purchase-reserved-db-instances-offering --reserved-db-instances-offering-id 438012d3-4a52-4cc7-b2e3-8dff72e0e706

Das folgende Codebeispiel zeigt, wie purchase-reserved-db-instances-offerings verwendet wird.

AWS CLI

Beispiel 1: So finden Sie eine reservierte DB-Instance zum Kauf

Im folgenden Beispiel für describe-reserved-db-instances-offerings werden die verfügbaren reservierten MySQL-DB-Instances mit der Instance-Klasse db.t2.micro und einer Dauer von einem Jahr aufgelistet. Die Angebots-ID ist für den Kauf einer reservierten DB-Instance erforderlich.

aws rds describe-reserved-db-instances-offerings \
    --product-description mysql \
    --db-instance-class db.t2.micro \
    --duration 1

Ausgabe:

{
    "ReservedDBInstancesOfferings": [
        {
            "ReservedDBInstancesOfferingId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4",
            "DBInstanceClass": "db.t2.micro",
            "Duration": 31536000,
            "FixedPrice": 51.0,
            "UsagePrice": 0.0,
            "CurrencyCode": "USD",
            "ProductDescription": "mysql",
            "OfferingType": "Partial Upfront",
            "MultiAZ": false,
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": 0.006,
                    "RecurringChargeFrequency": "Hourly"
                }
            ]
        },
    ... some output truncated ...
    ]
}

Weitere Informationen finden Sie unter Reservierte Instances für Amazon RDS im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So kaufen Sie eine reservierte DB-Instance

Das folgende Beispiel für purchase-reserved-db-instances-offering zeigt, wie Sie das reservierte DB-Instance-Angebot aus dem vorherigen Beispiel kaufen können.

aws rds purchase-reserved-db-instances-offering --reserved-db-instances-offering-id 8ba30be1-b9ec-447f-8f23-6114e3f4c7b4

Ausgabe:

{
    "ReservedDBInstance": {
        "ReservedDBInstanceId": "ri-2020-06-29-16-54-57-670",
        "ReservedDBInstancesOfferingId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4",
        "DBInstanceClass": "db.t2.micro",
        "StartTime": "2020-06-29T16:54:57.670Z",
        "Duration": 31536000,
        "FixedPrice": 51.0,
        "UsagePrice": 0.0,
        "CurrencyCode": "USD",
        "DBInstanceCount": 1,
        "ProductDescription": "mysql",
        "OfferingType": "Partial Upfront",
        "MultiAZ": false,
        "State": "payment-pending",
        "RecurringCharges": [
            {
                "RecurringChargeAmount": 0.006,
                "RecurringChargeFrequency": "Hourly"
            }
        ],
        "ReservedDBInstanceArn": "arn:aws:rds:us-west-2:123456789012:ri:ri-2020-06-29-16-54-57-670"
    }
}

Weitere Informationen finden Sie unter Reservierte Instances für Amazon RDS im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie reboot-db-instance verwendet wird.

AWS CLI

Neustarten einer DB-Instance

Im folgenden Beispiel für reboot-db-instance wird die angegebene DB-Instance neu gestartet.

aws rds reboot-db-instance \
    --db-instance-identifier test-mysql-instance

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "test-mysql-instance",
        "DBInstanceClass": "db.t3.micro",
        "Engine": "mysql",
        "DBInstanceStatus": "rebooting",
        "MasterUsername": "admin",
        "Endpoint": {
            "Address": "test-mysql-instance.############.us-west-2.rds.amazonaws.com",
            "Port": 3306,
            "HostedZoneId": "Z1PVIF0EXAMPLE"
        },

    ... output omitted...

    }
}

Weitere Informationen finden Sie unter Neustarten einer DB-Instance im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie reboot-db-shard-group verwendet wird.

AWS CLI

Beispiel 1: So starten Sie eine DB-Shard-Gruppe neu

Im folgenden Beispiel für reboot-db-shard-group wird eine DB-Shard-Gruppe neu gestartet.

aws rds reboot-db-shard-group \
    --db-shard-group-identifier my-db-shard-group

Ausgabe:

{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
            "DBShardGroupIdentifier": "my-db-shard-group",
            "DBClusterIdentifier": "my-sv2-cluster",
            "MaxACU": 1000.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Weitere Informationen finden Sie unter Neustarten eines Amazon Aurora DB-Clusters oder einer Amazon-Aurora-DB-Instance im Benutzerhandbuch zu Amazon Aurora.

Beispiel 1: So beschreiben Sie Ihre DB-Shard-Gruppen

Im folgenden Beispiel für describe-db-shard-groups werden Details zu Ihren DB-Shard-Gruppen abgerufen, nachdem Sie den reboot-db-shard-group-Befehl ausgeführt haben. Die DB-Shard-Gruppe my-db-shard-group wird jetzt neu gestartet.

aws rds describe-db-shard-groups

Ausgabe:

{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
            "DBShardGroupIdentifier": "limitless-test-shard-grp",
            "DBClusterIdentifier": "limitless-test-cluster",
            "MaxACU": 768.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": true,
            "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        },
        {
            "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
            "DBShardGroupIdentifier": "my-db-shard-group",
            "DBClusterIdentifier": "my-sv2-cluster",
            "MaxACU": 1000.0,
            "ComputeRedundancy": 0,
            "Status": "rebooting",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Weitere Informationen finden Sie unter Neustarten eines Amazon Aurora DB-Clusters oder einer Amazon-Aurora-DB-Instance im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie register-db-proxy-targets verwendet wird.

AWS CLI

So registrieren Sie einen DB-Proxy bei einer Datenbank

Im folgenden Beispiel für register-db-proxy-targets wird die Zuordnung zwischen einer Datenbank und einem Proxy hergestellt.

aws rds register-db-proxy-targets \
    --db-proxy-name proxyExample \
    --db-cluster-identifiers database-5

Ausgabe:

{
    "DBProxyTargets": [
        {
            "RdsResourceId": "database-5",
            "Port": 3306,
            "Type": "TRACKED_CLUSTER",
            "TargetHealth": {
                "State": "REGISTERING"
            }
        },
        {
            "Endpoint": "database-5instance-1.ab0cd1efghij.us-east-1.rds.amazonaws.com",
            "RdsResourceId": "database-5",
            "Port": 3306,
            "Type": "RDS_INSTANCE",
            "TargetHealth": {
                "State": "REGISTERING"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Erstellen eines RDS-Proxys im Benutzerhandbuch zu Amazon RDS und Erstellen eines RDS-Proxys im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie remove-from-global-cluster verwendet wird.

AWS CLI

So trennen Sie ein sekundäres Aurora-Cluster von einem globalen Aurora-Datenbank-Cluster

Im folgenden Beispiel für remove-from-global-cluster wird ein sekundärer Aurora-Cluster von einem globalen Aurora-Datenbank-Cluster getrennt. Der Cluster wechselt von einem schreibgeschützten zu einem eigenständigen Cluster mit Lese- und Schreibfunktion.

aws rds remove-from-global-cluster \
    --region us-west-2 \
    --global-cluster-identifier myglobalcluster \
    --db-cluster-identifier arn:aws:rds:us-west-2:123456789012:cluster:DB-1

Ausgabe:

{
    "GlobalCluster": {
        "GlobalClusterIdentifier": "myglobalcluster",
        "GlobalClusterResourceId": "cluster-abc123def456gh",
        "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
        "Status": "available",
        "Engine": "aurora-postgresql",
        "EngineVersion": "10.11",
        "StorageEncrypted": true,
        "DeletionProtection": false,
        "GlobalClusterMembers": [
            {
                "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:js-global-cluster",
                "Readers": [
                    "arn:aws:rds:us-west-2:123456789012:cluster:DB-1"
                ],
                "IsWriter": true
            },
            {
                "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:DB-1",
                "Readers": [],
                "IsWriter": false,
                "GlobalWriteForwardingStatus": "disabled"
            }
        ]
    }
}

Weitere Informationen finden Sie unter Entfernen eines Clusters aus einer Amazon Aurora Global Database im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie remove-option-from-option-group verwendet wird.

AWS CLI

So löschen Sie eine Option aus einer Optionsgruppe

Im folgenden Beispiel für remove-option-from-option-group wird die Option OEM aus myoptiongroup entfernt.

aws rds remove-option-from-option-group \
    --option-group-name myoptiongroup \
    --options OEM \
    --apply-immediately

Ausgabe:

{
    "OptionGroup": {
        "OptionGroupName": "myoptiongroup",
        "OptionGroupDescription": "Test",
        "EngineName": "oracle-ee",
        "MajorEngineVersion": "19",
        "Options": [],
        "AllowsVpcAndNonVpcInstanceMemberships": true,
        "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup"
    }
}

Weitere Informationen finden Sie unter Entfernen einer Option von einer Optionsgruppe im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie remove-role-from-db-cluster verwendet wird.

AWS CLI

So heben Sie die Zuordnung der AWS-Identity and Access Management (IAM)-Rolle zu einem DB-Cluster auf

Im folgenden Beispiel für remove-role-from-db-cluster wird eine Rolle aus einem DB-Cluster entfernt.

aws rds remove-role-from-db-cluster \
    --db-cluster-identifier mydbcluster \
    --role-arn arn:aws:iam::123456789012:role/RDSLoadFromS3

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Zuweisen einer IAM-Rolle zu einem Amazon-Aurora-MySQL DB-Cluster im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie remove-role-from-db-instance verwendet wird.

AWS CLI

So heben Sie die Zuordnung einer AWS-Identity and Access Management (IAM)-Rolle zu einer DB-Instance auf

Im folgenden Beispiel für remove-role-from-db-instance wird die Rolle namens rds-s3-integration-role aus einer Oracle-DB-Instance namens test-instance entfernt.

aws rds remove-role-from-db-instance \
    --db-instance-identifier test-instance \
    --feature-name S3_INTEGRATION \
    --role-arn arn:aws:iam::111122223333:role/rds-s3-integration-role

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Deaktivierung der RDS SQL Server-Integration mit S3 im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie remove-source-identifier-from-subscription verwendet wird.

AWS CLI

So entfernen Sie eine Quell-ID aus einem Abonnement

Im folgenden Beispiel für remove-source-identifier wird die angegebene Quell-ID aus einem vorhandenen Abonnement entfernt.

aws rds remove-source-identifier-from-subscription \
    --subscription-name my-instance-events \
    --source-identifier test-instance-repl

Ausgabe:

{
    "EventSubscription": {
        "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
        "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
        "EventCategoriesList": [
            "backup",
            "recovery"
        ],
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
        "Status": "modifying",
        "CustSubscriptionId": "my-instance-events",
        "CustomerAwsId": "123456789012",
        "SourceIdsList": [
            "test-instance"
        ],
        "SourceType": "db-instance",
        "Enabled": false
    }
}

Das folgende Codebeispiel zeigt, wie remove-tags-from-resource verwendet wird.

AWS CLI

So entfernen Sie Tags von einer Ressource

Im folgenden Beispiel für remove-tags-from-resource werden Tags aus einer Ressource entfernt.

aws rds remove-tags-from-resource \
    --resource-name arn:aws:rds:us-east-1:123456789012:db:mydbinstance \
    --tag-keys Name Environment

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Markieren von Amazon-RDS-Ressourcen im Benutzerhandbuch zu Amazon RDS und Markieren von Amazon-RDS-Ressourcen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie reset-db-cluster-parameter-group verwendet wird.

AWS CLI

Beispiel 1: So setzen Sie alle Parameter auf ihre Standardwerte zurück

Im folgenden Beispiel für reset-db-cluster-parameter-group werden alle Parameterwerte in einer vom Kunden erstellten DB-Cluster-Parametergruppe auf ihre Standardwerte zurückgesetzt.

aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclpg \
    --reset-all-parameters

Ausgabe:

{
    "DBClusterParameterGroupName": "mydbclpg"
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen im Benutzerhandbuch zu Amazon Aurora.

Beispiel 2: So setzen Sie angegebene Parametern auf ihre Standardwerte zurück

Im folgenden Beispiel für reset-db-cluster-parameter-group werden die Parameterwerte bestimmter Parameter in einer vom Kunden erstellten DB-Cluster-Parametergruppe auf ihre Standardwerte zurückgesetzt.

aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclpgy \
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Ausgabe:

{
    "DBClusterParameterGroupName": "mydbclpg"
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie reset-db-parameter-group verwendet wird.

AWS CLI

Beispiel 1: So setzen Sie alle Parameter auf ihre Standardwerte zurück

Im folgenden Beispiel für reset-db-parameter-group werden alle Parameterwerte in einer vom Kunden erstellten DB-Parametergruppe auf ihre Standardwerte zurückgesetzt.

aws rds reset-db-parameter-group \
    --db-parameter-group-name mypg \
    --reset-all-parameters

Ausgabe:

{
    "DBParameterGroupName": "mypg"
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen im Benutzerhandbuch zu Amazon RDS und Arbeiten mit DB-Parametergruppen und DB-Cluster-Parametergruppen im Benutzerhandbuch zu Amazon Aurora.

Beispiel 2: So setzen Sie angegebene Parametern auf ihre Standardwerte zurück

Im folgenden Beispiel für reset-db-parameter-group werden die Parameterwerte bestimmter Parameter in einer vom Kunden erstellten DB-Parametergruppe auf ihre Standardwerte zurückgesetzt.

aws rds reset-db-parameter-group \
    --db-parameter-group-name mypg \
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Ausgabe:

{
    "DBParameterGroupName": "mypg"
}

Weitere Informationen finden Sie unter Arbeiten mit DB-Parametergruppen im Benutzerhandbuch zu Amazon RDS und Arbeiten mit DB-Parametergruppen und DB-Cluster-Parametergruppen im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie restore-db-cluster-from-s3 verwendet wird.

AWS CLI

So stellen Sie ein Amazon-Aurora-DB-Cluster aus Amazon S3 wieder her

Im folgenden Beispiel für restore-db-cluster-from-s3 wird ein Amazon Aurora MySQL Version 5.7-kompatibles DB-Cluster aus einer MySQL 5.7-DB-Backup-Datei in Amazon S3 wiederhergestellt.

aws rds restore-db-cluster-from-s3 \
    --db-cluster-identifier cluster-s3-restore \
    --engine aurora-mysql \
    --master-username admin \
    --master-user-password mypassword \
    --s3-bucket-name amzn-s3-demo-bucket \
    --s3-prefix test-backup \
    --s3-ingestion-role-arn arn:aws:iam::123456789012:role/service-role/TestBackup \
    --source-engine mysql \
    --source-engine-version 5.7.28

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-west-2c",
            "us-west-2a",
            "us-west-2b"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "cluster-s3-restore",
        "DBClusterParameterGroup": "default.aurora-mysql5.7",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "cluster-s3-restore.cluster-co3xyzabc123.us-west-2.rds.amazonaws.com",
        "ReaderEndpoint": "cluster-s3-restore.cluster-ro-co3xyzabc123.us-west-2.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-mysql",
        "EngineVersion": "5.7.12",
        "Port": 3306,
        "MasterUsername": "admin",
        "PreferredBackupWindow": "11:15-11:45",
        "PreferredMaintenanceWindow": "thu:12:19-thu:12:49",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z1PVIF0EXAMPLE",
        "StorageEncrypted": false,
        "DbClusterResourceId": "cluster-SU5THYQQHOWCXZZDGXREXAMPLE",
        "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:cluster-s3-restore",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "ClusterCreateTime": "2020-07-27T14:22:08.095Z",
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": false,
        "CrossAccountClone": false,
        "DomainMemberships": []
    }
}

Weitere Informationen finden Sie unter Migrieren von Daten aus MySQL mithilfe eines Amazon-S3-Buckets im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie restore-db-cluster-from-snapshot verwendet wird.

AWS CLI

So stellen Sie einen DB-Cluster aus einem Snapshots wieder her

Der folgende restore-db-cluster-from-snapshot stellt ein Aurora PostgreSQL-DB-Cluster, der mit PostgreSQL Version 10.7 kompatibel ist, aus einem DB-Cluster-Snapshot namens test-instance-snapshot wieder her.

aws rds restore-db-cluster-from-snapshot \
    --db-cluster-identifier newdbcluster \
    --snapshot-identifier test-instance-snapshot \
    --engine aurora-postgresql \
    --engine-version 10.7

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-west-2c",
            "us-west-2a",
            "us-west-2b"
        ],
        "BackupRetentionPeriod": 7,
        "DatabaseName": "",
        "DBClusterIdentifier": "newdbcluster",
        "DBClusterParameterGroup": "default.aurora-postgresql10",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "newdbcluster.cluster-############.us-west-2.rds.amazonaws.com",
        "ReaderEndpoint": "newdbcluster.cluster-ro-############.us-west-2.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-postgresql",
        "EngineVersion": "10.7",
        "Port": 5432,
        "MasterUsername": "postgres",
        "PreferredBackupWindow": "09:33-10:03",
        "PreferredMaintenanceWindow": "sun:12:22-sun:12:52",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z1PVIF0EXAMPLE",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/287364e4-33e3-4755-a3b0-a1b2c3d4e5f6",
        "DbClusterResourceId": "cluster-5DSB5IFQDDUVAWOUWM1EXAMPLE",
        "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:newdbcluster",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "ClusterCreateTime": "2020-06-05T15:06:58.634Z",
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": false,
        "CrossAccountClone": false,
        "DomainMemberships": []
    }
}

Weitere Informationen zur Wiederherstellung von Snapshots finden Sie unter Wiederherstellen aus einem DB-Cluster-Snapshot im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie restore-db-cluster-to-point-in-time verwendet wird.

AWS CLI

Wiederherstellen eines DB-Clusters zu einer bestimmten Zeit

Im folgenden Beispiel für restore-db-cluster-to-point-in-time wird der DB-Cluster namens database-4 zum spätestmöglichen Zeitpunkt wiederhergestellt. Die Verwendung von copy-on-write als Wiederherstellungstyp stellt den neuen DB-Cluster als Klon des Quell-DB-Clusters wieder her.

aws rds restore-db-cluster-to-point-in-time \
    --source-db-cluster-identifier database-4 \
    --db-cluster-identifier sample-cluster-clone \
    --restore-type copy-on-write \
    --use-latest-restorable-time

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-west-2c",
            "us-west-2a",
            "us-west-2b"
        ],
        "BackupRetentionPeriod": 7,
        "DatabaseName": "",
        "DBClusterIdentifier": "sample-cluster-clone",
        "DBClusterParameterGroup": "default.aurora-postgresql10",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "sample-cluster-clone.cluster-############.us-west-2.rds.amazonaws.com",
        "ReaderEndpoint": "sample-cluster-clone.cluster-ro-############.us-west-2.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-postgresql",
        "EngineVersion": "10.7",
        "Port": 5432,
        "MasterUsername": "postgres",
        "PreferredBackupWindow": "09:33-10:03",
        "PreferredMaintenanceWindow": "sun:12:22-sun:12:52",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z1PVIF0EXAMPLE",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/287364e4-33e3-4755-a3b0-a1b2c3d4e5f6",
        "DbClusterResourceId": "cluster-BIZ77GDSA2XBSTNPFW1EXAMPLE",
        "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-clone",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "CloneGroupId": "8d19331a-099a-45a4-b4aa-11aa22bb33cc44dd",
        "ClusterCreateTime": "2020-03-10T19:57:38.967Z",
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": false,
        "CrossAccountClone": false
    }
}

Weitere Informationen finden Sie unter Wiederherstellen eines DB-Clusters zu einer bestimmten Zeit im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie restore-db-instance-from-db-snapshot verwendet wird.

AWS CLI

So stellen Sie eine DB-Instance aus einem DB-Snapshot wieder her

Im folgenden Beispiel für restore-db-instance-from-db-snapshot wird eine neue DB-Instance namens db7-new-instance mit der DB-Instance-Klasse db.t3.small des angegebenen DB-Snapshots erstellt. Die Quell-DB-Instance, aus der der Snapshot abgerufen wurde, verwendet eine veraltete DB-Instance-Klasse, sodass Sie sie nicht aktualisieren können.

aws rds restore-db-instance-from-db-snapshot \
    --db-instance-identifier db7-new-instance \
    --db-snapshot-identifier db7-test-snapshot \
    --db-instance-class db.t3.small

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "db7-new-instance",
        "DBInstanceClass": "db.t3.small",
        "Engine": "mysql",
        "DBInstanceStatus": "creating",

        ...output omitted...

        "PreferredMaintenanceWindow": "mon:07:37-mon:08:07",
        "PendingModifiedValues": {},
        "MultiAZ": false,
        "EngineVersion": "5.7.22",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "general-public-license",

        ...output omitted...

        "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:db7-new-instance",
        "IAMDatabaseAuthenticationEnabled": false,
        "PerformanceInsightsEnabled": false,
        "DeletionProtection": false,
        "AssociatedRoles": []
    }
}

Weitere Informationen finden Sie unter Wiederherstellen aus einem DB-Snapshot im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie restore-db-instance-from-s3 verwendet wird.

AWS CLI

So stellen Sie eine DB-Instance aus einem Backup in Amazon S3 wieder her

Im folgenden Beispiel für restore-db-instance-from-s3 wird eine neue DB-Instance namens restored-test-instance aus einem vorhandenen Backup im my-backups-S3-Bucket erstellt.

aws rds restore-db-instance-from-s3 \
    --db-instance-identifier restored-test-instance \
    --allocated-storage 250 --db-instance-class db.m4.large --engine mysql \
    --master-username master --master-user-password secret99 \
    --s3-bucket-name my-backups --s3-ingestion-role-arn arn:aws:iam::123456789012:role/my-role \
    --source-engine mysql --source-engine-version 5.6.27

Das folgende Codebeispiel zeigt, wie restore-db-instance-to-point-in-time verwendet wird.

AWS CLI

Beispiel 1: So stellen Sie eine DB-Instance zu einem bestimmten Zeitpunkt wieder her

Der folgende restore-db-instance-to-point-in-time-Befehl stellt test-instance auf einer neuen DB-Instance namens restored-test-instance zum angegebenen Zeitpunkt wieder her.

aws rds restore-db-instance-to-point-in-time \
    --source-db-instance-identifier test-instance \
    --target-db-instance restored-test-instance \
    --restore-time 2018-07-30T23:45:00.000Z

Ausgabe:

{
    "DBInstance": {
        "AllocatedStorage": 20,
        "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance",
        "DBInstanceStatus": "creating",
        "DBInstanceIdentifier": "restored-test-instance",
        ...some output omitted...
    }
}

Weitere Informationen finden Sie unter Wiederherstellen einer DB-Instance zu einer bestimmten Zeit im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So stellen Sie eine DB-Instance aus einem replizierten Backup zu einem bestimmten Zeitpunkt wieder her

Im folgenden Beispiel für restore-db-instance-to-point-in-time wird eine Oracle-DB-Instance aus einem replizierten automatisierten Backup zum angegebenen Zeitpunkt wiederhergestellt.

aws rds restore-db-instance-to-point-in-time \
    --source-db-instance-automated-backups-arn "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example" \
    --target-db-instance-identifier myorclinstance-from-replicated-backup \
    --restore-time 2020-12-08T18:45:00.000Z

Ausgabe:

{
    "DBInstance": {
        "DBInstanceIdentifier": "myorclinstance-from-replicated-backup",
        "DBInstanceClass": "db.t3.micro",
        "Engine": "oracle-se2",
        "DBInstanceStatus": "creating",
        "MasterUsername": "admin",
        "DBName": "ORCL",
        "AllocatedStorage": 20,
        "PreferredBackupWindow": "07:45-08:15",
        "BackupRetentionPeriod": 14,
        ... some output omitted ...
        "DbiResourceId": "db-KGLXG75BGVIWKQT7NQ4EXAMPLE",
        "CACertificateIdentifier": "rds-ca-2019",
        "DomainMemberships": [],
        "CopyTagsToSnapshot": false,
        "MonitoringInterval": 0,
        "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:myorclinstance-from-replicated-backup",
        "IAMDatabaseAuthenticationEnabled": false,
        "PerformanceInsightsEnabled": false,
        "DeletionProtection": false,
        "AssociatedRoles": [],
        "TagList": []
    }
}

Weitere Informationen finden Sie unter Wiederherstellen auf eine bestimmte Zeit aus einer replizierten Sicherung im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie start-activity-stream verwendet wird.

AWS CLI

Starten eines Datenbankaktivitäts-Streams

Im folgenden Beispiel für start-activity-stream wird ein asynchroner Aktivitäts-Stream zur Überwachung eines Aurora-Clusters namens my-pg-cluster gestartet.

aws rds start-activity-stream \
    --region us-east-1 \
    --mode async \
    --kms-key-id arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1 \
    --resource-arn arn:aws:rds:us-east-1:1234567890123:cluster:my-pg-cluster \
    --apply-immediately

Ausgabe:

{
    "KmsKeyId": "arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1",
    "KinesisStreamName": "aws-rds-das-cluster-0ABCDEFGHI1JKLM2NOPQ3R4S",
    "Status": "starting",
    "Mode": "async",
    "ApplyImmediately": true
}

Weitere Informationen finden Sie unter Starten eines Datenbankaktivitäts-Streams im Benutzerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie start-db-cluster verwendet wird.

AWS CLI

So starten Sie einen DB-Cluster

Im folgenden Beispiel für start-db-cluster werden ein DB-Cluster und dessen DB-Instances gestartet.

aws rds start-db-cluster \
    --db-cluster-identifier mydbcluster

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1e",
            "us-east-1b"
        ],
        "BackupRetentionPeriod": 1,
        "DatabaseName": "mydb",
        "DBClusterIdentifier": "mydbcluster",
        ...some output truncated...
    }
}

Weitere Informationen finden Sie unter Stoppen und Starten eines Amazon-Aurora-DB-Clusters im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter StartDbCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie start-db-instance-automated-backups-replication verwendet wird.

AWS CLI

So aktivieren Sie multiregionale automatisierte Backups

Im folgenden Beispiel für start-db-instance-automated-backups-replication werden automatisierte Backups aus einer DB-Instance in der Region USA West (Oregon) in die Region USA Ost (N.-Virginia) repliziert. Der Aufbewahrungszeitraum für Backups beträgt 14 Tage.

aws rds start-db-instance-automated-backups-replication \
    --region us-west-2 \
    --source-db-instance-arn "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db" \
    --backup-retention-period 14

Ausgabe:

{
    "DBInstanceAutomatedBackup": {
        "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
        "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
        "Region": "us-east-1",
        "DBInstanceIdentifier": "new-orcl-db",
        "RestoreWindow": {},
        "AllocatedStorage": 20,
        "Status": "pending",
        "Port": 1521,
        "InstanceCreateTime": "2020-12-04T15:28:31Z",
        "MasterUsername": "admin",
        "Engine": "oracle-se2",
        "EngineVersion": "12.1.0.2.v21",
        "LicenseModel": "bring-your-own-license",
        "OptionGroupName": "default:oracle-se2-12-1",
        "Encrypted": false,
        "StorageType": "gp2",
        "IAMDatabaseAuthenticationEnabled": false,
        "BackupRetentionPeriod": 14,
        "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
    }
}

Weitere Informationen finden Sie unter Ermöglichen multiregionaler automatisierter Sicherungen im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie start-db-instance verwendet wird.

AWS CLI

So starten Sie eine DB-Instance

Im folgenden Beispiel für start-db-instance wird die angegebene Instance gestartet.

aws rds start-db-instance \
    --db-instance-identifier test-instance

Ausgabe:

{
    "DBInstance": {
        "DBInstanceStatus": "starting",
        ...some output truncated...
    }
}

  • API-Details finden Sie unter StartDbInstance in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie start-export-task verwendet wird.

AWS CLI

So exportieren Sie einen Snapshot nach Amazon S3

Im folgenden Beispiel für start-export-task wird ein DB-Snapshot namens db5-snapshot-test in den Amazon-S3-Bucket namens amzn-s3-demo-bucket exportiert.

aws rds start-export-task \
    --export-task-identifier my-s3-export \
    --source-arn arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test \
    --s3-bucket-name amzn-s3-demo-bucket \
    --iam-role-arn arn:aws:iam::123456789012:role/service-role/ExportRole \
    --kms-key-id arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff

Ausgabe:

{
    "ExportTaskIdentifier": "my-s3-export",
    "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test",
    "SnapshotTime": "2020-03-27T20:48:42.023Z",
    "S3Bucket": "amzn-s3-demo-bucket",
    "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
    "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
    "Status": "STARTING",
    "PercentProgress": 0,
    "TotalExtractedDataInGB": 0
}

Weitere Informationen finden Sie unter Exportieren eines Snapshots in einen Amazon-S3-Bucket im Benutzerhandbuch zu Amazon RDS.

  • API-Details finden Sie unter StartExportTask in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie stop-activity-stream verwendet wird.

AWS CLI

So stoppen Sie einen Datenbankaktivitäts-Stream

Im folgenden Beispiel für stop-activity-stream wird ein Aktivitäts-Stream in einem Aurora-Clusters namens my-pg-cluster gestoppt.

aws rds stop-activity-stream \
    --region us-east-1 \
    --resource-arn arn:aws:rds:us-east-1:1234567890123:cluster:my-pg-cluster \
    --apply-immediately

Ausgabe:

{
    "KmsKeyId": "arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1",
    "KinesisStreamName": "aws-rds-das-cluster-0ABCDEFGHI1JKLM2NOPQ3R4S",
    "Status": "stopping"
}

Weitere Informationen finden Sie unter Anhalten eines Aktivitäts-Streams im Entwicklerhandbuch zu Amazon Aurora.

Das folgende Codebeispiel zeigt, wie stop-db-cluster verwendet wird.

AWS CLI

So stoppen Sie einen DB-Cluster

Im folgenden Beispiel für stop-db-cluster werden ein DB-Cluster und deren DB-Instances gestoppt.

aws rds stop-db-cluster \
    --db-cluster-identifier mydbcluster

Ausgabe:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1e",
            "us-east-1b"
        ],
        "BackupRetentionPeriod": 1,
        "DatabaseName": "mydb",
        "DBClusterIdentifier": "mydbcluster",
        ...some output truncated...
    }
}

Weitere Informationen finden Sie unter Stoppen und Starten eines Amazon-Aurora-DB-Clusters im Benutzerhandbuch zu Amazon Aurora.

  • API-Details finden Sie unter StopDbCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie stop-db-instance-automated-backups-replication verwendet wird.

AWS CLI

So beenden Sie die Replikation automatisierter Backups

Der folgende stop-db-instance-automated-backups-replication beendet die Replikation automatisierter Backups in die Region USA West (Oregon). Replizierte Backups werden gemäß dem festgelegten Aufbewahrungszeitraum für Backups aufbewahrt.

aws rds stop-db-instance-automated-backups-replication \
    --region us-west-2 \
    --source-db-instance-arn "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db"

Ausgabe:

{
    "DBInstanceAutomatedBackup": {
        "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
        "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
        "Region": "us-east-1",
        "DBInstanceIdentifier": "new-orcl-db",
        "RestoreWindow": {
            "EarliestTime": "2020-12-04T23:13:21.030Z",
            "LatestTime": "2020-12-07T19:59:57Z"
        },
        "AllocatedStorage": 20,
        "Status": "replicating",
        "Port": 1521,
        "InstanceCreateTime": "2020-12-04T15:28:31Z",
        "MasterUsername": "admin",
        "Engine": "oracle-se2",
        "EngineVersion": "12.1.0.2.v21",
        "LicenseModel": "bring-your-own-license",
        "OptionGroupName": "default:oracle-se2-12-1",
        "Encrypted": false,
        "StorageType": "gp2",
        "IAMDatabaseAuthenticationEnabled": false,
        "BackupRetentionPeriod": 7,
        "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
    }
}

Weitere Informationen finden Sie unter Anhalten von automatisierten Backups im Benutzerhandbuch zu Amazon RDS.

Das folgende Codebeispiel zeigt, wie stop-db-instance verwendet wird.

AWS CLI

So halten Sie eine DB-Instance an

Im folgenden Beispiel für stop-db-instance wird die angegebene DB-Instance gestoppt.

aws rds stop-db-instance \
    --db-instance-identifier test-instance

Ausgabe:

{
    "DBInstance": {
        "DBInstanceStatus": "stopping",
        ...some output truncated...
    }
}

  • API-Details finden Sie unter StopDbInstance in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie switchover-blue-green-deployment verwendet wird.

AWS CLI

Beispiel 1: So stellen Sie eine Blau/Grün-Bereitstellung für eine RDS-DB-Instance um

Im folgenden Beispiel für switchover-blue-green-deployment wird die angegebene grüne Umgebung als neue Produktionsumgebung hochgestuft.

aws rds switchover-blue-green-deployment \
    --blue-green-deployment-identifier bgd-wi89nwzglccsfake \
    --switchover-timeout 300

Ausgabe:

{
    "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
        "BlueGreenDeploymentName": "bgd-cli-test-instance",
        "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
        "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e",
        "SwitchoverDetails": [
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-k5fv7u",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ggsh8m",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-o2vwm0",
                "Status": "AVAILABLE"
            }
        ],
        "Tasks": [
            {
                "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                "Status": "COMPLETED"
            },
            {
                "Name": "DB_ENGINE_VERSION_UPGRADE",
                "Status": "COMPLETED"
            },
            {
                "Name": "CONFIGURE_BACKUPS",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATING_TOPOLOGY_OF_SOURCE",
                "Status": "COMPLETED"
            }
        ],
        "Status": "SWITCHOVER_IN_PROGRESS",
        "CreateTime": "2022-02-25T22:33:22.225000+00:00"
    }
}

Weitere Informationen finden Sie unter Umstellen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon RDS.

Beispiel 2: So stufen Sie eine Blau/Grün-Bereitstellung für einen Aurora-MySQL-DB-Cluster hoch

Im folgenden Beispiel für switchover-blue-green-deployment wird die angegebene grüne Umgebung als neue Produktionsumgebung hochgestuft.

aws rds switchover-blue-green-deployment \
    --blue-green-deployment-identifier bgd-wi89nwzglccsfake \
    --switchover-timeout 300

Ausgabe:

{
    "BlueGreenDeployment": {
        "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
        "BlueGreenDeploymentName": "my-blue-green-deployment",
        "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
        "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6",
        "SwitchoverDetails": [
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-bvxc73",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-7wc4ie",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-p4xxkz",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-np1ikl",
                "Status": "AVAILABLE"
            },
            {
                "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
                "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-miszlf",
                "Status": "AVAILABLE"
            }
        ],
        "Tasks": [
            {
                "Name": "CREATING_READ_REPLICA_OF_SOURCE",
                "Status": "COMPLETED"
            },
            {
                "Name": "DB_ENGINE_VERSION_UPGRADE",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
                "Status": "COMPLETED"
            },
            {
                "Name": "CREATE_CUSTOM_ENDPOINTS",
                "Status": "COMPLETED"
            }
        ],
        "Status": "SWITCHOVER_IN_PROGRESS",
        "CreateTime": "2022-02-25T22:38:49.522000+00:00"
    }
}

Weitere Informationen finden Sie unter Umstellen einer Blau/Grün-Bereitstellung im Benutzerhandbuch zu Amazon Aurora.