Amazon RDS-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie Amazon RDS verwenden. AWS Command Line Interface

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

Aktionen

Das folgende Codebeispiel zeigt, wie Sieadd-option-to-option-group.

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.

Einzelheiten zur API finden Sie AddOptionToOptionGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungadd-role-to-db-cluster.

AWS CLI

So ordnen Sie einem DB-Cluster eine AWS Identity and Access Management (IAM) -Rolle 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.

Einzelheiten zur API finden Sie unter AddRoleToDbCluster AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungadd-role-to-db-instance.

AWS CLI

So ordnen Sie einer DB-Instance eine AWS Identity and Access Management (IAM) -Rolle 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 Integration von Amazon RDS für Oracle in Amazon S3 im Benutzerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie unter AddRoleToDbInstance AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungadd-source-identifier-to-subscription.

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

Einzelheiten zur API finden Sie AddSourceIdentifierToSubscriptionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungadd-tags-to-resource.

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-RDS-Ressourcen im Entwicklerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie AddTagsToResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungapply-pending-maintenance-action.

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 DB-Clusters in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie ApplyPendingMaintenanceActionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungauthorize-db-security-group-ingress.

AWS CLI

So ordnen Sie einer DB-Instance eine AWS Identity and Access Management (IAM) -Rolle 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.

Einzelheiten zur API finden Sie unter AuthorizeDbSecurityGroupIngress AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungbacktrack-db-cluster.

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.

Einzelheiten zur API finden Sie BacktrackDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcancel-export-task.

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.

Einzelheiten zur API finden Sie CancelExportTaskin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcopy-db-cluster-parameter-group.

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.

Einzelheiten zur API finden Sie CopyDbClusterParameterGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcopy-db-cluster-snapshot.

AWS CLI

Um einen DB-Cluster-Snapshot zu kopieren

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.

Einzelheiten zur API finden Sie CopyDbClusterSnapshotunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcopy-db-parameter-group.

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

Einzelheiten zur API finden Sie CopyDbParameterGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcopy-db-snapshot.

AWS CLI

Um einen DB-Snapshot zu kopieren

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.

Einzelheiten zur API finden Sie CopyDbSnapshotunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcopy-option-group.

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 Erstellen einer Kopie einer Optionsgruppe im Benutzerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie CopyOptionGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-blue-green-deployment.

AWS CLI

Beispiel 1: So erstellen Sie eine blue/green Bereitstellung für eine RDS for MySQL-DB-Instance

Das folgende create-blue-green-deployment Beispiel erstellt eine blue/green Bereitstellung für eine MySQL-DB-Instance.


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 Creating a blue/green Deployment im Amazon RDS-Benutzerhandbuch.

Beispiel 2: So erstellen Sie eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster

Das folgende create-blue-green-deployment Beispiel erstellt eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster.


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 Creating a blue/green Deployment im Amazon Aurora Aurora-Benutzerhandbuch.

Einzelheiten zur API finden Sie CreateBlueGreenDeploymentunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-cluster-endpoint.

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.

Einzelheiten zur API finden Sie CreateDbClusterEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-cluster-parameter-group.

AWS CLI

Um eine DB-Cluster-Parametergruppe zu erstellen

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.

Einzelheiten zur API finden Sie CreateDbClusterParameterGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-cluster-snapshot.

AWS CLI

Um einen DB-Cluster-Snapshot zu erstellen

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.

Einzelheiten zur API finden Sie CreateDbClusterSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-cluster.

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 verwenden, um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster explizit mit dem create-db-instance AWS CLI-Befehl 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 verwenden, um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster explizit mit dem create-db-instance AWS CLI-Befehl 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 DB-Clusters in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie CreateDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-instance-read-replica.

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

Einzelheiten zur API finden Sie CreateDbInstanceReadReplicain der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-instance.

AWS CLI

Um eine DB-Instance zu erstellen

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 DB-Instance in Amazon RDS im Benutzerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie unter Create DBInstance in AWS CLI Command Reference.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-parameter-group.

AWS CLI

Um eine DB-Parametergruppe zu erstellen

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.

API-Einzelheiten finden Sie unter DBParameterGruppe erstellen in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-proxy-endpoint.

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.

Einzelheiten zur API finden Sie CreateDbProxyEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-proxy.

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.

Einzelheiten zur API finden Sie CreateDbProxyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-security-group.

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

Einzelheiten zur API finden Sie CreateDbSecurityGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-shard-group.

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 verwenden, um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster explizit mit dem create-db-instance AWS CLI-Befehl 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.

Einzelheiten zur API finden Sie CreateDbShardGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-snapshot.

AWS CLI

Um einen DB-Snapshot zu erstellen

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.

Einzelheiten zur API finden Sie unter Create DBSnapshot in AWS CLI Command Reference.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-subnet-group.

AWS CLI

So erstellen Sie eine 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.

Einzelheiten zur API finden Sie CreateDbSubnetGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-event-subscription.

AWS CLI

Um ein Event-Abonnement zu erstellen

Im folgenden create-event-subscription Beispiel wird ein Abonnement für Sicherungs- und Wiederherstellungsereignisse für 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
    }
}

Einzelheiten zur API finden Sie CreateEventSubscriptionunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-global-cluster.

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 globalen Aurora-Datenbank im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie CreateGlobalClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-option-group.

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

Einzelheiten zur API finden Sie CreateOptionGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-blue-green-deployment.

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 blue/green Bereitstellung im Amazon RDS-Benutzerhandbuch.

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 blue/green Bereitstellung im Amazon Aurora Aurora-Benutzerhandbuch.

Einzelheiten zur API finden Sie DeleteBlueGreenDeploymentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-cluster-endpoint.

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.

Einzelheiten zur API finden Sie DeleteDbClusterEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-cluster-parameter-group.

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.

Einzelheiten zur API finden Sie DeleteDbClusterParameterGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-cluster-snapshot.

AWS CLI

Um einen DB-Cluster-Snapshot zu löschen

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.

Einzelheiten zur API finden Sie DeleteDbClusterSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-cluster.

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.

Einzelheiten zur API finden Sie DeleteDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-instance-automated-backup.

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.

Einzelheiten zur API finden Sie DeleteDbInstanceAutomatedBackupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-instance.

AWS CLI

Um eine DB-Instance zu löschen

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

Einzelheiten zur API finden Sie unter Löschen DBInstance in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-parameter-group.

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.

API-Einzelheiten finden Sie unter DBParameterGruppe löschen in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-proxy-endpoint.

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.

Einzelheiten zur API finden Sie DeleteDbProxyEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-proxy.

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.

Einzelheiten zur API finden Sie DeleteDbProxyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-security-group.

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 Amazon RDS-Benutzerhandbuch.

Einzelheiten zur API finden Sie unter DeleteDbSecurityGroup AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-shard-group.

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.

Einzelheiten zur API finden Sie DeleteDbShardGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-snapshot.

AWS CLI

Um einen DB-Snapshot zu löschen

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.

Einzelheiten zur API finden Sie DeleteDbSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-subnet-group.

AWS CLI

Um eine DB-Subnetzgruppe zu löschen

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.

Einzelheiten zur API finden Sie unter DeleteDbSubnetGroup AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-event-subscription.

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

Einzelheiten zur API finden Sie DeleteEventSubscriptionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-global-cluster.

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 globalen Aurora-Datenbank im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie DeleteGlobalClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-option-group.

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.

Einzelheiten zur API finden Sie DeleteOptionGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungderegister-db-proxy-targets.

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.

Einzelheiten zur API finden Sie DeregisterDbProxyTargetsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-account-attributes.

AWS CLI

So beschreiben Sie Kontoattribute

Im folgenden describe-account-attributes Beispiel 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"
        }
    ]
}

Einzelheiten zur API finden Sie unter DescribeAccountAttributes AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-blue-green-deployments.

AWS CLI

Beispiel 1: Um die blue/green Bereitstellung einer RDS-DB-Instance nach Abschluss der Erstellung zu beschreiben

Im folgenden describe-blue-green-deployment Beispiel werden die Details einer blue/green Bereitstellung abgerufen, nachdem die Erstellung abgeschlossen ist.


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 blue/green Bereitstellung anzeigen im Amazon RDS-Benutzerhandbuch.

Beispiel 2: Um eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster zu beschreiben

Im folgenden describe-blue-green-deployment Beispiel werden die Details einer blue/green 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 blue/green Bereitstellung anzeigen im Amazon Aurora Aurora-Benutzerhandbuch.

Beispiel 3: Um eine blue/green Bereitstellung für einen Aurora MySQL-Cluster nach dem Switchover zu beschreiben

Im folgenden describe-blue-green-deployment Beispiel werden die Details zu einer blue/green 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 blue/green Bereitstellung anzeigen im Amazon Aurora Aurora-Benutzerhandbuch.

Beispiel 4: Um eine kombinierte blue/green Bereitstellung zu beschreiben

Im folgenden describe-blue-green-deployment Beispiel werden die Details einer kombinierten blue/green 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 blue/green Bereitstellung im Amazon RDS-Benutzerhandbuch und Anzeigen einer blue/green Bereitstellung im Amazon Aurora Aurora-Benutzerhandbuch.

Einzelheiten zur API finden Sie DescribeBlueGreenDeploymentsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-certificates.

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 SSL/TLS zur Verschlüsselung einer Verbindung zu einer DB-Instance im Amazon RDS-Benutzerhandbuch und Verwenden SSL/TLS zur Verschlüsselung einer Verbindung zu einem DB-Cluster im Amazon Aurora Aurora-Benutzerhandbuch.

Einzelheiten zur API finden Sie DescribeCertificatesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-cluster-backtracks.

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.

Einzelheiten zur API finden Sie DescribeDbClusterBacktracksin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-cluster-endpoints.

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.

Einzelheiten zur API finden Sie DescribeDbClusterEndpointsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-cluster-parameter-groups.

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.

Einzelheiten zur API finden Sie DescribeDbClusterParameterGroupsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-cluster-parameters.

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.

Einzelheiten zur API finden Sie DescribeDbClusterParametersin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-cluster-snapshot-attributes.

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.

Einzelheiten zur API finden Sie DescribeDbClusterSnapshotAttributesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-cluster-snapshots.

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.

Einzelheiten zur API finden Sie DescribeDbClusterSnapshotsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-clusters.

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 describe-db-clusters Beispiel werden nur die DBClusterIdentifier Endpoint ,- und 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 DB-Cluster in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie unter DescribeDbClusters AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-engine-versions.

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.

Einzelheiten zur API finden Sie unter DBEngineVersionen beschreiben in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-instance-automated-backups.

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. Die Details beinhalten 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.

Einzelheiten zur API finden Sie DescribeDbInstanceAutomatedBackupsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-instances.

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

Einzelheiten zur API finden Sie unter Describe DBInstances in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-log-files.

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

Einzelheiten zur API finden Sie DescribeDbLogFilesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-parameter-groups.

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.

Einzelheiten zur API finden Sie unter DBParameterGruppen beschreiben in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-parameters.

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.

Einzelheiten zur API finden Sie unter Describe DBParameters in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-proxies.

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.

Einzelheiten zur API finden Sie DescribeDbProxiesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-proxy-endpoints.

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.

Einzelheiten zur API finden Sie DescribeDbProxyEndpointsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-proxy-target-groups.

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.

Einzelheiten zur API finden Sie DescribeDbProxyTargetGroupsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-proxy-targets.

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.

Einzelheiten zur API finden Sie DescribeDbProxyTargetsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-recommendations.

AWS CLI

Beispiel 1: So listen Sie alle DB-Empfehlungen auf

Das folgende describe-db-recommendations Beispiel listet alle DB-Empfehlungen in Ihrem AWS Konto auf.


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

Das folgende describe-db-recommendations Beispiel listet DB-Empfehlungen mit hohem Schweregrad in Ihrem AWS Konto auf.


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

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

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

Das folgende describe-db-recommendations Beispiel listet alle aktiven DB-Empfehlungen in Ihrem AWS Konto auf.


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

Einzelheiten zur API finden Sie DescribeDbRecommendationsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-security-groups.

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 Auflisten verfügbarer DB-Sicherheitsgruppen im Benutzerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie DescribeDbSecurityGroupsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-shard-groups.

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 DB-Cluster in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie DescribeDbShardGroupsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-snapshot-attributes.

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.

Einzelheiten zur API finden Sie DescribeDbSnapshotAttributesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-snapshots.

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 describe-db-snapshots Beispiel wird der length Operator in der --query Option verwendet, um die Anzahl der manuellen Schnappschüsse zurückzugeben, die in einer bestimmten AWS Region aufgenommen wurden.


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

Ausgabe:

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

Einzelheiten zur API finden Sie unter Describe DBSnapshots in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-subnet-groups.

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 finden Sie unter Amazon Virtual Private Cloud VPCs und Amazon RDS im Amazon RDS-Benutzerhandbuch.

Einzelheiten zur API finden Sie DescribeDbSubnetGroupsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-engine-default-cluster-parameters.

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.

Einzelheiten zur API finden Sie DescribeEngineDefaultClusterParametersin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-engine-default-parameters.

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.

Einzelheiten zur API finden Sie DescribeEngineDefaultParametersin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-event-categories.

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

Einzelheiten zur API finden Sie DescribeEventCategoriesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-event-subscriptions.

AWS CLI

So beschreiben Sie Ereignisabonnements

In diesem Beispiel werden alle Amazon RDS-Event-Abonnements für das AWS Girokonto 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...
    ]
}

Einzelheiten zur API finden Sie DescribeEventSubscriptionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-events.

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

Einzelheiten zur API finden Sie DescribeEventsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-export-tasks.

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 Überwachen von Snapshot-Exporten im Benutzerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie DescribeExportTasksin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-global-clusters.

AWS CLI

So beschreiben Sie globale DB-Cluster

Das folgende describe-global-clusters Beispiel listet globale Aurora-DB-Cluster in der aktuellen AWS Region auf.


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 globalen Aurora-Datenbank im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie DescribeGlobalClustersin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-option-group-options.

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.

Einzelheiten zur API finden Sie DescribeOptionGroupOptionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-option-groups.

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.

Einzelheiten zur API finden Sie DescribeOptionGroupsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-orderable-db-instance-options.

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

Einzelheiten zur API finden Sie unter DescribeOrderableDBInstanceOptionen in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-pending-maintenance-actions.

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.

Einzelheiten zur API finden Sie DescribePendingMaintenanceActionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-reserved-db-instances-offerings.

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

Einzelheiten zur API finden Sie DescribeReservedDbInstancesOfferingsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-reserved-db-instances.

AWS CLI

So beschreiben Sie reservierte DB-Instances

Im folgenden describe-reserved-db-instances Beispiel 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.

Einzelheiten zur API finden Sie unter DescribeReservedDbInstances AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-source-regions.

AWS CLI

So beschreiben Sie Quellregionen

Im folgenden describe-source-regions Beispiel werden Details zu allen AWS Quellregionen abgerufen. Es zeigt auch, dass automatische Backups nur von USA West (Oregon) in die AWS Zielregion USA Ost (Nord-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.

Einzelheiten zur API finden Sie DescribeSourceRegionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-valid-db-instance-modifications.

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

Einzelheiten zur API finden Sie DescribeValidDbInstanceModificationsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdownload-db-log-file-portion.

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.

Einzelheiten zur API finden Sie DownloadDbLogFilePortionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunggenerate-auth-token.

AWS CLI

So generieren Sie ein Authentifizierungstoken

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

Einzelheiten zur API finden Sie GenerateAuthTokenin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunggenerate-db-auth-token.

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.

Einzelheiten zur API finden Sie GenerateDbAuthTokenin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

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.

Einzelheiten zur API finden Sie ListTagsForResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-certificates.

AWS CLI

Um das SSL/TLS Systemstandardzertifikat für neue DB-Instances vorübergehend zu überschreiben

Das folgende modify-certificates Beispiel überschreibt vorübergehend das SSL/TLS Systemstandardzertifikat für neue DB-Instances.


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 Rotation Ihres SSL/TLS Zertifikats im Amazon RDS-Benutzerhandbuch und Rotation Ihres SSL/TLS Zertifikats im Amazon Aurora Aurora-Benutzerhandbuch.

Einzelheiten zur API finden Sie ModifyCertificatesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-current-db-cluster-capacity.

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 DB-Clusters in Aurora Serverless v1 im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie ModifyCurrentDbClusterCapacityin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-cluster-endpoint.

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.

Einzelheiten zur API finden Sie ModifyDbClusterEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-cluster-parameter-group.

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.

Einzelheiten zur API finden Sie ModifyDbClusterParameterGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-cluster-snapshot-attribute.

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 finden Sie unter Wiederherstellen aus einem DB-Cluster-Snapshot im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie ModifyDbClusterSnapshotAttributein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-cluster.

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 DB-Clusters in Amazon Aurora 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.

Einzelheiten zur API finden Sie ModifyDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-instance.

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.

Einzelheiten zur API finden Sie unter Ändern DBInstance in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-parameter-group.

AWS CLI

Um eine DB-Parametergruppe zu ändern

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.

Einzelheiten zur API finden Sie unter DBParameterGruppe ändern in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-proxy-endpoint.

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.

Einzelheiten zur API finden Sie ModifyDbProxyEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-proxy-target-group.

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.

Einzelheiten zur API finden Sie ModifyDbProxyTargetGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-proxy.

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.

Einzelheiten zur API finden Sie ModifyDbProxyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-shard-group.

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 DB-Cluster in Amazon Aurora 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 1000 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 DB-Cluster in Amazon Aurora im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie ModifyDbShardGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-snapshot-attribute.

AWS CLI

Beispiel 1: Um zwei AWS Konten die Wiederherstellung eines DB-Snapshots zu ermöglichen

Im folgenden modify-db-snapshot-attribute Beispiel wird zwei AWS Konten mit den Kennungen 111122223333 und die Erlaubnis erteilt444455556666, den DB-Snapshot mit dem Namen 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: Um zu verhindern, dass ein AWS Konto einen DB-Snapshot wiederherstellt

Im folgenden modify-db-snapshot-attribute Beispiel wird einem bestimmten AWS Konto die Erlaubnis entzogen, den genannten DB-Snapshot wiederherzustellenmydbsnapshot. 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.

Einzelheiten zur API finden Sie ModifyDbSnapshotAttributeunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-snapshot-attributes.

AWS CLI

So ändern Sie das Attribut eines DB-Snapshots

Im folgenden modify-db-snapshot-attribute Beispiel können zwei AWS Kontokennungen, 111122223333 und444455556666, den genannten mydbsnapshot DB-Snapshot wiederherstellen.


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.

Einzelheiten zur API finden Sie unter ModifyDbSnapshotAttributes AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-snapshot.

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 Aktualisieren eines PostgreSQL-DB-Snapshots im Benutzerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie ModifyDbSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-db-subnet-group.

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. Um die vorhandenen Subnetze in der Subnetzgruppe beizubehalten, fügen Sie deren IDs AS-Werte in die --subnet-ids Option 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 Schritt 2: Erstellen einer DB-Subnetzgruppe im Entwicklerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie unter ModifyDbSubnetGroup AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-event-subscription.

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

Einzelheiten zur API finden Sie ModifyEventSubscriptionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungmodify-global-cluster.

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 globalen Aurora-Datenbank im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie ModifyGlobalClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungpromote-read-replica-db-cluster.

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.

Einzelheiten zur API finden Sie PromoteReadReplicaDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungpromote-read-replica.

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

Einzelheiten zur API finden Sie PromoteReadReplicain der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungpurchase-reserved-db-instance.

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 -- ID reserved-db-instances-offering 438012d3-4a52-4cc7-b2e3-8dff72e0e706

Einzelheiten zur API finden PurchaseReservedDbInstanceSie AWS CLI in der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungpurchase-reserved-db-instances-offerings.

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 -- ID reserved-db-instances-offering 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.

Einzelheiten zur API finden PurchaseReservedDbInstancesOfferingsSie AWS CLI in der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungreboot-db-instance.

AWS CLI

So starten Sie eine DB-Instance neu

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.

Einzelheiten zur API finden Sie unter Reboot DBInstance in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungreboot-db-shard-group.

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.

Einzelheiten zur API finden Sie RebootDbShardGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungregister-db-proxy-targets.

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.

Einzelheiten zur API finden Sie RegisterDbProxyTargetsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungremove-from-global-cluster.

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.

Einzelheiten zur API finden Sie RemoveFromGlobalClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungremove-option-from-option-group.

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.

Einzelheiten zur API finden Sie RemoveOptionFromOptionGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungremove-role-from-db-cluster.

AWS CLI

So trennen Sie die Zuordnung einer AWS Identity and Access Management (IAM) -Rolle zu einem DB-Cluster

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.

Einzelheiten zur API finden Sie unter RemoveRoleFromDbCluster AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungremove-role-from-db-instance.

AWS CLI

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

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.

Einzelheiten zur API finden Sie unter RemoveRoleFromDbInstance AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungremove-source-identifier-from-subscription.

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

Einzelheiten zur API finden Sie RemoveSourceIdentifierFromSubscriptionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungremove-tags-from-resource.

AWS CLI

So entfernen Sie Tags aus 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.

Einzelheiten zur API finden Sie RemoveTagsFromResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungreset-db-cluster-parameter-group.

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.

Einzelheiten zur API finden Sie ResetDbClusterParameterGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungreset-db-parameter-group.

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

Einzelheiten zur API finden Sie ResetDbParameterGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungrestore-db-cluster-from-s3.

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.

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

Das folgende Codebeispiel zeigt die Verwendungrestore-db-cluster-from-snapshot.

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 finden Sie unter Wiederherstellen aus einem DB-Cluster-Snapshot im Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie RestoreDbClusterFromSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungrestore-db-cluster-to-point-in-time.

AWS CLI

So stellen Sie einen DB-Cluster zu einer bestimmten Zeit wieder her

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.

Einzelheiten zur API finden Sie RestoreDbClusterToPointInTimein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungrestore-db-instance-from-db-snapshot.

AWS CLI

Um eine DB-Instance aus einem DB-Snapshot wiederherzustellen

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.

Einzelheiten zur API finden Sie RestoreDbInstanceFromDbSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungrestore-db-instance-from-s3.

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

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

Das folgende Codebeispiel zeigt die Verwendungrestore-db-instance-to-point-in-time.

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.

Einzelheiten zur API finden Sie RestoreDbInstanceToPointInTimein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-activity-stream.

AWS CLI

So starten Sie einen Datenbankaktivitäts-Stream

Das folgende start-activity-stream Beispiel startet einen asynchronen Aktivitätsstream zur Überwachung eines Aurora-Clusters mit dem Namen my-pg-cluster.


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.

Einzelheiten zur API finden Sie unter StartActivityStream AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-db-cluster.

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.

Einzelheiten zur API finden Sie StartDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-db-instance-automated-backups-replication.

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 Aktivieren multiregionaler automatisierter Backups im Benutzerhandbuch zu Amazon RDS.

Einzelheiten zur API finden Sie StartDbInstanceAutomatedBackupsReplicationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-db-instance.

AWS CLI

Um eine DB-Instance zu starten

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

Einzelheiten zur API finden Sie StartDbInstancein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-export-task.

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.

Einzelheiten zur API finden Sie StartExportTaskin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstop-activity-stream.

AWS CLI

So stoppen Sie einen Datenbankaktivitäts-Stream

Das folgende stop-activity-stream Beispiel stoppt einen Aktivitätsstream in einem Aurora-Cluster mit dem Namen my-pg-cluster.


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 Benutzerhandbuch zu Amazon Aurora.

Einzelheiten zur API finden Sie StopActivityStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstop-db-cluster.

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.

Einzelheiten zur API finden Sie StopDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstop-db-instance-automated-backups-replication.

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.

Einzelheiten zur API finden Sie StopDbInstanceAutomatedBackupsReplicationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstop-db-instance.

AWS CLI

Um eine DB-Instance zu stoppen

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

Einzelheiten zur API finden Sie StopDbInstancein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungswitchover-blue-green-deployment.

AWS CLI

Beispiel 1: Um eine blue/green Bereitstellung für eine RDS-DB-Instance zu wechseln

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 Switching a blue/green Deployment im Amazon RDS-Benutzerhandbuch.

Beispiel 2: Um eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster zu bewerben

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 Switching a blue/green Deployment im Amazon Aurora Aurora-Benutzerhandbuch.

Einzelheiten zur API finden Sie SwitchoverBlueGreenDeploymentin der AWS CLI Befehlsreferenz.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

AWS Proton

Amazon RDS Data Service