RDSAmazon-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface mit Amazon Aktionen ausführen und allgemeine Szenarien implementierenRDS.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.

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

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungadd-option-to-option-group.

AWS CLI

Um eine Option zu einer Optionsgruppe hinzuzufügen

Das folgende add-option-to-option-group Beispiel fügt der angegebenen Optionsgruppe eine Option hinzu.


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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten 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 add-role-to-db-cluster Beispiel 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 Zuordnen einer IAM Rolle zu einem Amazon Aurora My SQL DB-Cluster im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie AddRoleToDbClusterin der AWS CLI Befehlsreferenz.

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 add-role-to-db-instance Beispiel wird die Rolle einer Oracle-DB-Instance mit dem Namen hinzugefügttest-instance.


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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

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

APIEinzelheiten finden Sie AddRoleToDbInstanceunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um einem Abonnement eine Quell-ID hinzuzufügen

Im folgenden add-source-identifier Beispiel wird einem vorhandenen Abonnement eine weitere Quell-ID 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"
        ]
    }
}

APIEinzelheiten finden Sie AddSourceIdentifierToSubscriptionunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um einer Ressource Tags hinzuzufügen

Im folgenden add-tags-to-resource Beispiel 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 Tagging Amazon RDS Resources im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten 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 apply-pending-maintenance-action Beispiel werden die ausstehenden Wartungsaktionen für einen 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 RDSAmazon-Benutzerhandbuch und Wartung eines Amazon Aurora-DB-Clusters im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ApplyPendingMaintenanceActionunter 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 authorize-db-security-group-ingress Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie AuthorizeDbSecurityGroupIngressin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungbacktrack-db-cluster.

AWS CLI

Um einen Aurora-DB-Cluster zurückzuverfolgen

Im folgenden backtrack-db-cluster Beispiel wird der angegebene DB-Cluster-Beispielcluster auf den 19. März 2018 um 10 Uhr zurückgesetzt.


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 Ressource bestätigt. RDS

APIEinzelheiten finden Sie BacktrackDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcancel-export-task.

AWS CLI

Um einen Snapshot-Export nach Amazon S3 abzubrechen

Im folgenden cancel-export-task Beispiel 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": "mybucket",
    "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 RDSAmazon-Benutzerhandbuch oder Abbrechen einer Snapshot-Exportaufgabe im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie CancelExportTaskin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um eine DB-Cluster-Parametergruppe zu kopieren

Im folgenden copy-db-cluster-parameter-group Beispiel 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie CopyDbClusterParameterGroupunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Cluster-Snapshot zu kopieren

Im folgenden copy-db-cluster-snapshot Beispiel 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie CopyDbClusterSnapshotunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um eine DB-Cluster-Parametergruppe zu kopieren

Im folgenden copy-db-parameter-group Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie CopyDbParameterGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcopy-db-snapshot.

AWS CLI

Um einen DB-Snapshot zu kopieren

Im folgenden copy-db-snapshot Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie CopyDbSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcopy-option-group.

AWS CLI

Um eine Optionsgruppe zu kopieren

Im folgenden copy-option-group Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie CopyOptionGroupunter AWS CLI Befehlsreferenz.

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

AWS CLI

Beispiel 1: Um eine blaue/grüne Bereitstellung für eine RDS for My SQL DB-Instance zu erstellen

Das folgende create-blue-green-deployment Beispiel erstellt eine blaue/grüne Bereitstellung für eine My SQL 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 Erstellen einer blauen/grünen Bereitstellung im RDSAmazon-Benutzerhandbuch.

Beispiel 2: So erstellen Sie eine blaue/grüne Bereitstellung für einen Aurora My SQL DB-Cluster

Das folgende create-blue-green-deployment Beispiel erstellt eine blaue/grüne Bereitstellung für einen Aurora My SQL 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 Erstellen einer blauen/grünen Bereitstellung im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie unter CreateBlueGreenDeployment AWS CLIBefehlsreferenz.

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

AWS CLI

Um einen benutzerdefinierten DB-Cluster-Endpunkt zu erstellen

Im folgenden create-db-cluster-endpoint Beispiel wird ein benutzerdefinierter DB-Cluster-Endpunkt erstellt und mit dem angegebenen Aurora-DB-Cluster verknüpft.


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 Amazon Aurora Connection Management im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie CreateDbClusterEndpointunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um eine DB-Cluster-Parametergruppe zu erstellen

Im folgenden create-db-cluster-parameter-group Beispiel 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten 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 create-db-cluster-snapshot Beispiel wird ein 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie CreateDbClusterSnapshotunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-cluster.

AWS CLI

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

Im folgenden create-db-cluster Beispiel wird ein My SQL 5.7-kompatibler DB-Cluster unter Verwendung der Standard-Engine-Version erstellt. Ersetzen Sie das Beispielkennwort secret99 durch ein sicheres Passwort. Wenn Sie die Konsole verwenden, um einen DB-Cluster zu erstellen, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihren DB-Cluster. Wenn Sie jedoch den verwenden, AWS CLI um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster mit dem create-db-instance AWS CLI Befehl explizit 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: Um einen Postgre SQL --kompatiblen DB-Cluster zu erstellen

Das folgende create-db-cluster Beispiel erstellt einen Postgre SQL -kompatiblen DB-Cluster unter Verwendung der Standard-Engine-Version. Ersetzen Sie das Beispielkennwort secret99 durch ein sicheres Passwort. Wenn Sie die Konsole verwenden, um einen DB-Cluster zu erstellen, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihren DB-Cluster. Wenn Sie jedoch den verwenden, AWS CLI um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster mit dem create-db-instance AWS CLI Befehl explizit erstellen.


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

Ausgabe:


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

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

APIEinzelheiten finden Sie CreateDbClusterunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um eine DB-Instance zu erstellen, lesen Sie Replica

In diesem Beispiel wird eine Read Replica einer vorhandenen DB-Instance mit dem Namen erstellt. test-instance Die Read Replica trägt den Namen. 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...
    }
}

APIEinzelheiten 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 create-db-instance Beispiel werden die erforderlichen Optionen verwendet, um eine neue DB-Instance zu starten.


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

Ausgabe:


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

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

APIEinzelheiten finden Sie unter C reateDBInstance in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie mancreate-db-parameter-group.

AWS CLI

Um eine DB-Parametergruppe zu erstellen

Im folgenden create-db-parameter-group Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter reateDBParameterC-Gruppe in der AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Proxyendpunkt für eine RDS Datenbank zu erstellen

Im folgenden create-db-proxy-endpoint Beispiel wird ein DB-Proxyendpunkt 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 RDSAmazon-Benutzerhandbuch und Erstellen eines Proxy-Endpunkts im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie CreateDbProxyEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-proxy.

AWS CLI

Um einen DB-Proxy für eine RDS Datenbank zu erstellen

Das folgende create-db-proxy Beispiel erstellt einen DB-Proxy.


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 RDSAmazon-Benutzerhandbuch und Erstellen eines RDS Proxys im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten 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 hat die neue DB-Sicherheitsgruppe einen Namen mysecgroup und 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"
    }
}

APIEinzelheiten finden Sie CreateDbSecurityGroupunter AWS CLI Befehlsreferenz.

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

AWS CLI

Beispiel 1: So erstellen Sie einen SQL primären Aurora Postgre-DB-Cluster

Im folgenden create-db-cluster Beispiel wird ein SQL SQL primärer Aurora Postgre-DB-Cluster erstellt, der 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: Um die primäre (Writer-) DB-Instance zu erstellen

Im folgenden create-db-instance Beispiel wird eine primäre (Writer-) DB-Instance von Aurora Serverless v2 erstellt. Wenn Sie die Konsole verwenden, um einen DB-Cluster zu erstellen, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihren DB-Cluster. Wenn Sie jedoch den verwenden, AWS CLI um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster mit dem create-db-instance AWS CLI Befehl explizit 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

Das folgende create-db-shard-group Beispiel erstellt eine DB-Shard-Gruppe in Ihrem SQL primären Aurora Postgre-DB-Cluster.


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 Using Aurora Serverless v2 im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie unter CreateDbShardGroup AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-db-snapshot.

AWS CLI

Um einen DB-Snapshot zu erstellen

Das folgende create-db-snapshot Beispiel erstellt einen DB-Snapshot.


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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter C reateDBSnapshot in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie mancreate-db-subnet-group.

AWS CLI

Um eine DB-Subnetzgruppe zu erstellen

Im folgenden create-db-subnet-group Beispiel wird eine DB-Subnetzgruppe erstellt, die mysubnetgroup unter Verwendung vorhandener Subnetze aufgerufen wird.


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 VPC in a im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie CreateDbSubnetGroupunter 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 Amazon Simple Notification Service-Thema gesendet, das von angegeben ist--sns-topic-arn.


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

APIEinzelheiten finden Sie CreateEventSubscriptionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-global-cluster.

AWS CLI

Um einen globalen DB-Cluster zu erstellen

Das folgende create-global-cluster Beispiel erstellt einen neuen Aurora My SQL -kompatiblen globalen DB-Cluster.


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

APIEinzelheiten finden Sie CreateGlobalClusterunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-option-group.

AWS CLI

So erstellen Sie eine RDS Amazon-Optionsgruppe

Der folgende create-option-group Befehl erstellt eine neue RDS Amazon-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"
    }
}

APIEinzelheiten finden Sie CreateOptionGroupin der AWS CLI Befehlsreferenz.

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

AWS CLI

Beispiel 1: Um Ressourcen in einer grünen Umgebung für eine RDS for My SQL DB-Instance zu löschen

Im folgenden delete-blue-green-deployment Beispiel werden die Ressourcen in einer grünen Umgebung für eine RDS for My SQL DB-Instance 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 blauen/grünen Bereitstellung im RDSAmazon-Benutzerhandbuch.

Beispiel 2: Um Ressourcen in einer grünen Umgebung für einen Aurora My SQL DB-Cluster zu löschen

Das folgende delete-blue-green-deployment Beispiel löscht die Ressourcen in einer grünen Umgebung für einen Aurora My SQL DB-Cluster.


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 blauen/grünen Bereitstellung im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie unter DeleteBlueGreenDeployment AWS CLIBefehlsreferenz.

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

AWS CLI

Um einen benutzerdefinierten DB-Cluster-Endpunkt zu löschen

Im folgenden delete-db-cluster-endpoint Beispiel 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 Amazon Aurora Connection Management im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteDbClusterEndpointunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um eine DB-Cluster-Parametergruppe zu löschen

Im folgenden delete-db-cluster-parameter-group Beispiel 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-Cluster-Parametergruppen im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteDbClusterParameterGroupunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Cluster-Snapshot zu löschen

Im folgenden delete-db-cluster-snapshot Beispiel wird der angegebene DB-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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteDbClusterSnapshotunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-cluster.

AWS CLI

Beispiel 1: Um eine DB-Instance in einem DB-Cluster zu löschen

Im folgenden delete-db-instance Beispiel 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 Löschstatus befinden. Sie können keinen endgültigen Snapshot erstellen, wenn 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 Amazon Aurora Aurora-Benutzerhandbuch.

Beispiel 2: Um einen DB-Cluster zu löschen

Im folgenden delete-db-cluster Beispiel wird der angegebene DB-Cluster gelöscht mycluster und 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 Clusters with a Single DB Instance im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteDbClusterunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um ein repliziertes automatisiertes Backup aus einer Region zu löschen

Im folgenden delete-db-instance-automated-backup Beispiel wird die automatische Sicherung 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 replizierter Backups im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten 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 delete-db-instance Beispiel wird die angegebene DB-Instance gelöscht, nachdem ein letzter DB-Snapshot mit dem Namen erstellt wurdetest-instance-final-snap.


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

APIEinzelheiten finden Sie unter D eleteDBInstance in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie mandelete-db-parameter-group.

AWS CLI

Um eine DB-Parametergruppe zu löschen

Im folgenden command Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter eleteDBParameterD-Gruppe in der AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Proxyendpunkt für eine RDS Datenbank zu löschen

Im folgenden delete-db-proxy-endpoint Beispiel wird ein DB-Proxyendpunkt 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 RDSAmazon-Benutzerhandbuch und Löschen eines Proxy-Endpunkts im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteDbProxyEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-proxy.

AWS CLI

Um einen DB-Proxy für eine RDS Datenbank zu löschen

Das folgende delete-db-proxy Beispiel löscht einen DB-Proxy.


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 RDSAmazon-Benutzerhandbuch und Löschen eines RDS Proxys im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteDbProxyin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um eine DB-Sicherheitsgruppe zu löschen

Im folgenden delete-db-security-group Beispiel wird eine DB-Sicherheitsgruppe mit dem Namen 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter DeleteDbSecurityGroup AWS CLIBefehlsreferenz.

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

AWS CLI

Beispiel 1: Um eine DB-Shard-Gruppe erfolglos zu löschen

Das folgende delete-db-shard-group Beispiel zeigt den Fehler, der auftritt, wenn Sie versuchen, eine DB-Shard-Gruppe zu löschen, bevor Sie alle Ihre Datenbanken und Schemas löschen.


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: Um eine DB-Shard-Gruppe erfolgreich zu löschen

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


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

APIEinzelheiten finden Sie DeleteDbShardGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-db-snapshot.

AWS CLI

Um einen DB-Snapshot zu löschen

Das folgende delete-db-snapshot Beispiel löscht den angegebenen DB-Snapshot.


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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten 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 delete-db-subnet-group Beispiel wird die DB-Subnetzgruppe namens gelöscht. mysubnetgroup


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 VPC in a im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteDbSubnetGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-event-subscription.

AWS CLI

Um ein Event-Abonnement zu löschen

Im folgenden delete-event-subscription Beispiel 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"
    }
}

APIEinzelheiten finden Sie unter DeleteEventSubscription AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-global-cluster.

AWS CLI

Um einen globalen DB-Cluster zu löschen

Das folgende delete-global-cluster Beispiel löscht einen Aurora My SQL -kompatiblen globalen DB-Cluster. Die Ausgabe zeigt den Cluster, den Sie löschen, aber nachfolgende describe-global-clusters Befehle führen diesen DB-Cluster nicht 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteGlobalClusterunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-option-group.

AWS CLI

Um eine Optionsgruppe zu löschen

Im folgenden delete-option-group Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DeleteOptionGroupin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um ein DB-Proxyziel von der Datenbank-Zielgruppe abzumelden

Das folgende deregister-db-proxy-targets Beispiel entfernt die Zuordnung zwischen dem Proxy proxyExample und seinem Ziel.


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 RDSAmazon-Benutzerhandbuch und Löschen eines RDS Proxys im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DeregisterDbProxyTargetsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-account-attributes.

AWS CLI

Zur Beschreibung von Kontoattributen

Im folgenden describe-account-attributes Beispiel werden die Attribute für das AWS Girokonto 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"
        }
    ]
}

APIEinzelheiten finden Sie unter DescribeAccountAttributes AWS CLIBefehlsreferenz.

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

AWS CLI

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

Im folgenden describe-blue-green-deployment Beispiel werden nach Abschluss der Erstellung die Details einer blauen/grünen Bereitstellung abgerufen.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Blau/Grün-Bereitstellungen anzeigen im RDSAmazon-Benutzerhandbuch.

Beispiel 2: Um eine blaue/grüne Bereitstellung für einen Aurora My SQL DB-Cluster zu beschreiben

Im folgenden describe-blue-green-deployment Beispiel werden die Details einer blauen/grünen 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 Blau/Grün-Bereitstellung anzeigen im Amazon Aurora Aurora-Benutzerhandbuch.

Beispiel 3: Um eine blaue/grüne Bereitstellung für einen Aurora SQL My-Cluster nach dem Switchover zu beschreiben

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

Beispiel 4: Um eine kombinierte blaue/grüne Bereitstellung zu beschreiben

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


aws rds describe-blue-green-deployments

Ausgabe:


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

Weitere Informationen finden Sie unter Blau/Grün-Bereitstellungen anzeigen im RDSAmazon-Benutzerhandbuch und Blau/Grün-Bereitstellungen anzeigen im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeBlueGreenDeploymentsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-certificates.

AWS CLI

Um Zertifikate zu beschreiben

Im folgenden describe-certificates Beispiel 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 vonSSL/TLSzum Verschlüsseln einer Verbindung zu einer DB-Instance im RDSAmazon-Benutzerhandbuch und Verwenden vonSSL/TLSzum Verschlüsseln einer Verbindung zu einem DB-Cluster im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeCertificatesin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um Backtracks für einen DB-Cluster zu beschreiben

Im folgenden describe-db-cluster-backtracks Beispiel 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 Backtracking eines Aurora-DB-Clusters im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie unter DescribeDbClusterBacktracks AWS CLIBefehlsreferenz.

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

AWS CLI

Beispiel 1: Um DB-Cluster-Endpunkte zu beschreiben

Im folgenden describe-db-cluster-endpoints Beispiel werden Details für Ihre DB-Cluster-Endpunkte abgerufen. Die gängigsten Arten von Aurora-Clustern haben zwei Endpunkte. Ein Endpunkt hat TypWRITER. Sie können diesen Endpunkt für alle SQL Anweisungen verwenden. Der andere Endpunkt hat TypREADER. Sie können diesen Endpunkt nur für SELECT und andere schreibgeschützte Anweisungen SQL 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: Um die DB-Cluster-Endpunkte eines einzelnen DB-Clusters zu beschreiben

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


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 Amazon Aurora Connection Management im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbClusterEndpointsunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um DB-Cluster-Parametergruppen zu beschreiben

Im folgenden describe-db-cluster-parameter-groups Beispiel werden Details für Ihre DB-Cluster-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-Cluster-Parametergruppen im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbClusterParameterGroupsunter AWS CLI Befehlsreferenz.

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

AWS CLI

Beispiel 1: Um die Parameter in einer DB-Cluster-Parametergruppe zu beschreiben

Im folgenden describe-db-cluster-parameters Beispiel werden Details zu den Parametern in einer DB-Cluster-Parametergruppe 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: Um nur die Parameternamen in einer DB-Cluster-Parametergruppe aufzulisten

Im folgenden describe-db-cluster-parameters Beispiel werden nur die Namen der Parameter in einer DB-Cluster-Parametergruppe 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: Um nur die änderbaren Parameter in einer DB-Cluster-Parametergruppe zu beschreiben

Im folgenden describe-db-cluster-parameters Beispiel werden nur die Namen der Parameter abgerufen, die Sie in einer DB-Cluster-Parametergruppe ändern 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: Um nur die änderbaren booleschen Parameter in einer DB-Cluster-Parametergruppe zu beschreiben

Im folgenden describe-db-cluster-parameters Beispiel werden nur die Namen der Parameter abgerufen, die Sie in einer DB-Cluster-Parametergruppe ändern können und die 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-Cluster-Parametergruppen im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbClusterParametersunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um die Attributnamen und -werte für einen DB-Cluster-Snapshot zu beschreiben

Im folgenden describe-db-cluster-snapshot-attributes Beispiel 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbClusterSnapshotAttributesunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Cluster-Snapshot für einen DB-Cluster zu beschreiben

Im folgenden describe-db-cluster-snapshots Beispiel 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbClusterSnapshotsunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-clusters.

AWS CLI

Beispiel 1: Um einen DB-Cluster zu beschreiben

Im folgenden describe-db-clusters Beispiel werden die Details des angegebenen DB-Clusters 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: Um bestimmte Attribute aller DB-Cluster aufzulisten

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: Um DB-Cluster mit einem bestimmten Attribut aufzulisten

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


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

Ausgabe:


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

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

APIEinzelheiten finden Sie DescribeDbClustersunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um die DB-Engine-Versionen für die My SQL DB-Engine zu beschreiben

Im folgenden describe-db-engine-versions Beispiel werden Details zu den einzelnen 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 (AmazonRDS)? im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter escribeDBEngineD-Versionen in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie mandescribe-db-instance-automated-backups.

AWS CLI

Um die automatisierten Backups für eine DB-Instance zu beschreiben

Im folgenden describe-db-instance-automated-backups Beispiel werden Details zu den 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 Informationen zu replizierten Backups im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter DescribeDbInstanceAutomatedBackups AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-instances.

AWS CLI

Um eine DB-Instance zu beschreiben

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

APIEinzelheiten finden Sie unter D escribeDBInstances in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie mandescribe-db-log-files.

AWS CLI

Um die Protokolldateien für eine DB-Instance zu beschreiben

Im folgenden describe-db-log-files Beispiel 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"
        }
    ]
}

APIEinzelheiten finden Sie unter DescribeDbLogFiles AWS CLIBefehlsreferenz.

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

AWS CLI

Um Ihre DB-Parametergruppe zu beschreiben

Im folgenden describe-db-parameter-groups Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter escribeDBParameterD-Gruppen in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-parameters.

AWS CLI

Um die Parameter in einer DB-Parametergruppe zu beschreiben

Im folgenden describe-db-parameters Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter D escribeDBParameters in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie mandescribe-db-proxies.

AWS CLI

Um einen DB-Proxy für eine RDS Datenbank zu beschreiben

Das folgende describe-db-proxies Beispiel gibt Informationen über DB-Proxys zurück.


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 Einen RDS Proxy anzeigen im RDSAmazon-Benutzerhandbuch und Einen RDS Proxy anzeigen im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbProxiesin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Proxy-Endpunkt zu beschreiben

Das folgende describe-db-proxy-endpoints Beispiel gibt Informationen über DB-Proxy-Endpunkte zurück.


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 RDSAmazon-Benutzerhandbuch und Erstellen eines Proxy-Endpunkts im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbProxyEndpointsin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Proxy-Endpunkt zu beschreiben

Das folgende describe-db-proxy-target-groups Beispiel gibt Informationen über DB-Proxy-Zielgruppen zurück.


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 Einen RDS Proxy anzeigen im RDSAmazon-Benutzerhandbuch und Einen RDS Proxy anzeigen im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbProxyTargetGroupsin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um DB-Proxyziele zu beschreiben

Das folgende describe-db-proxy-targets Beispiel gibt Informationen über DB-Proxyziele zurück.


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 Einen RDS Proxy anzeigen im RDSAmazon-Benutzerhandbuch und Einen RDS Proxy anzeigen im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbProxyTargetsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-recommendations.

AWS CLI

Beispiel 1: Um alle DB-Empfehlungen aufzulisten

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 RDSAmazon-Empfehlungen anzeigen und beantworten im RDSAmazon-Benutzerhandbuch und RDSAmazon-Empfehlungen anzeigen und beantworten im Amazon Aurora-Benutzerhandbuch.

Beispiel 2: Um DB-Empfehlungen mit hohem Schweregrad aufzulisten

Im folgenden describe-db-recommendations Beispiel werden DB-Empfehlungen mit hohem Schweregrad in Ihrem AWS Konto aufgeführt.


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: Um DB-Empfehlungen für eine bestimmte DB-Instance aufzulisten

Das folgende describe-db-recommendations Beispiel listet alle DB-Empfehlungen für eine angegebene DB-Instance auf.


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: Um alle aktiven DB-Empfehlungen aufzulisten

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

APIEinzelheiten finden Sie DescribeDbRecommendationsin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um DB-Sicherheitsgruppen aufzulisten

Das folgende describe-db-security-groups Beispiel listet DB-Sicherheitsgruppen auf.


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 Verfügbare DB-Sicherheitsgruppen auflisten im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbSecurityGroupsin der AWS CLI Befehlsreferenz.

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

AWS CLI

Beispiel 1: Um DB-Shard-Gruppen zu beschreiben

Im folgenden describe-db-shard-groups Beispiel werden die Details Ihrer DB-Shard-Gruppen abgerufen.


aws rds describe-db-shard-groups

Ausgabe:


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

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

APIEinzelheiten finden Sie DescribeDbShardGroupsunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um die Attributnamen und -werte für einen DB-Snapshot zu beschreiben

Das folgende describe-db-snapshot-attributes Beispiel beschreibt die Attributnamen und -werte für einen DB-Snapshot.


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 Einen DB-Snapshot teilen im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbSnapshotAttributesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-db-snapshots.

AWS CLI

Beispiel 1: Um einen DB-Snapshot für eine DB-Instance zu beschreiben

Im folgenden describe-db-snapshots Beispiel 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 RDSAmazon-Benutzerhandbuch.

Beispiel 2: Um die Anzahl der manuell erstellten Snapshots zu ermitteln

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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter D escribeDBSnapshots in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie mandescribe-db-subnet-groups.

AWS CLI

Um eine DB-Subnetzgruppe zu beschreiben

Im folgenden describe-db-subnet-groups Beispiel 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeDbSubnetGroupsin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um die Standard-Engine und die Systemparameterinformationen für die Aurora-Datenbank-Engine zu beschreiben

Im folgenden describe-engine-default-cluster-parameters Beispiel werden die Details der Standard-Engine und die Systemparameterinformationen für Aurora-DB-Cluster mit My SQL 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-Cluster-Parametergruppen im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeEngineDefaultClusterParametersunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um die Standard-Engine und die Systemparameterinformationen für die Datenbank-Engine zu beschreiben

Im folgenden describe-engine-default-parameters Beispiel werden Details für die Standard-Engine und Systemparameterinformationen für My SQL 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeEngineDefaultParametersunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-event-categories.

AWS CLI

Um Ereigniskategorien zu beschreiben

Im folgenden describe-event-categories Beispiel 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"
            ]
        }
    ]
}

APIEinzelheiten finden Sie unter DescribeEventCategories AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-event-subscriptions.

AWS CLI

Um Veranstaltungsabonnements zu beschreiben

Dieses Beispiel beschreibt alle RDS Amazon-Event-Abonnements für das AWS Girokonto.


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

APIEinzelheiten finden Sie DescribeEventSubscriptionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-events.

AWS CLI

Um Ereignisse zu beschreiben

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

APIEinzelheiten finden Sie unter DescribeEvents AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-export-tasks.

AWS CLI

Um Aufgaben zum Exportieren von Snapshots zu beschreiben

Das folgende describe-export-tasks Beispiel gibt Informationen über Snapshot-Exporte nach Amazon S3 zurück.


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": "mybucket",
            "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": "mybucket",
            "S3Prefix": "",
            "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
            "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
            "Status": "STARTING",
            "PercentProgress": 0,
            "TotalExtractedDataInGB": 0
        }
    ]
}

Weitere Informationen finden Sie unter Überwachung von Snapshot-Exporten im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeExportTasksin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-global-clusters.

AWS CLI

Um globale DB-Cluster zu beschreiben

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

APIEinzelheiten finden Sie DescribeGlobalClustersunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um alle verfügbaren Optionen zu beschreiben

Das folgende describe-option-group-options Beispiel listet zwei Optionen für eine Oracle Database 19c-Instance auf.


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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeOptionGroupOptionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-option-groups.

AWS CLI

Um die verfügbaren Optionsgruppen zu beschreiben

Das folgende describe-option-groups Beispiel listet die Optionsgruppen für eine Oracle Database 19c-Instance auf.


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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeOptionGroupsin der AWS CLI Befehlsreferenz.

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

AWS CLI

Um bestellbare DB-Instance-Optionen zu beschreiben

Im folgenden describe-orderable-db-instance-options Beispiel werden Details zu den bestellbaren Optionen für DB-Instances abgerufen, auf denen die My SQL 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...
}

APIEinzelheiten finden Sie unter DescribeOrderableDBInstanceOptions AWS CLIBefehlsreferenz.

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

AWS CLI

Um Ressourcen aufzulisten, für die mindestens eine Wartungsaktion aussteht

Das folgende describe-pending-maintenance-actions Beispiel listet die ausstehende Wartungsaktion für eine DB-Instance auf.


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 Wartung einer DB-Instance im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribePendingMaintenanceActionsunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um Angebote für reservierte DB-Instances zu beschreiben

Im folgenden describe-reserved-db-instances-offerings Beispiel werden Details zu den Optionen für oracle reservierte DB-Instances 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...
}

APIEinzelheiten finden Sie unter DescribeReservedDbInstancesOfferings AWS CLIBefehlsreferenz.

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

AWS CLI

Um reservierte DB-Instances zu beschreiben

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 Reserved DB Instances for Amazon RDS im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie DescribeReservedDbInstancesunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztdescribe-source-regions.

AWS CLI

Um Quellregionen zu beschreiben

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 Informationen zu replizierten Backups im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter DescribeSourceRegions AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztdescribe-valid-db-instance-modifications.

AWS CLI

Um gültige Änderungen für eine DB-Instance zu beschreiben

Im folgenden describe-valid-db-instance-modifications Beispiel 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"
            }
        ]
    }
}

APIEinzelheiten finden Sie unter DescribeValidDbInstanceModifications AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztdownload-db-log-file-portion.

AWS CLI

Um eine DB-Protokolldatei herunterzuladen

Im folgenden download-db-log-file-portion Beispiel wird nur der neueste Teil Ihrer Protokolldatei heruntergeladen und in einer lokalen Datei mit dem Namen gespeicherttail.txt.


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

Um die gesamte Datei herunterzuladen, müssen Sie den --starting-token 0 Parameter angeben. Im folgenden Beispiel wird die Ausgabe in einer lokalen Datei mit dem Namen gespeichertfull.txt.


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 kann Leerzeilen enthalten. Sie werden beim Herunterladen am Ende jedes Teils der Protokolldatei angezeigt. Dies verursacht im Allgemeinen keine Probleme bei der Analyse Ihrer Protokolldateien.

APIEinzelheiten finden Sie DownloadDbLogFilePortionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztgenerate-auth-token.

AWS CLI

Um ein Authentifizierungstoken zu generieren

Im folgenden generate-db-auth-token Beispiel 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

APIEinzelheiten finden Sie GenerateAuthTokenunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztgenerate-db-auth-token.

AWS CLI

Um ein IAM Authentifizierungstoken zu generieren

Im folgenden generate-db-auth-token Beispiel 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 von IAM Authentifizierung im RDSAmazon-Benutzerhandbuch und Herstellen einer Verbindung zu Ihrem DB-Cluster mithilfe von IAM Authentifizierung im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie GenerateDbAuthTokenin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztlist-tags-for-resource.

AWS CLI

So listen Sie Tags auf einer RDS Amazon-Ressource auf

Das folgende list-tags-for-resource Beispiel listet alle Tags auf einer DB-Instance auf.


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 Tagging Amazon RDS Resources im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie ListTagsForResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-certificates.

AWS CLI

Um das standardmäßige TLS SystemzertifikatSSL/für neue DB-Instances vorübergehend zu überschreiben

Das folgende modify-certificates Beispiel überschreibt vorübergehend das TLS SystemstandardzertifikatSSL/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 RDSAmazon-Benutzerhandbuch und Rotation Ihres SSL TLS /-Zertifikats im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyCertificatesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-current-db-cluster-capacity.

AWS CLI

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

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


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

Ausgabe:


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

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

APIEinzelheiten finden Sie unter ModifyCurrentDbClusterCapacity AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-cluster-endpoint.

AWS CLI

Um einen benutzerdefinierten DB-Cluster-Endpunkt zu ändern

Im folgenden modify-db-cluster-endpoint Beispiel 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 Amazon Aurora Connection Management im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbClusterEndpointunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-cluster-parameter-group.

AWS CLI

Um Parameter in einer DB-Cluster-Parametergruppe zu ändern

Im folgenden modify-db-cluster-parameter-group Beispiel werden die Werte von Parametern 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-Cluster-Parametergruppen im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbClusterParameterGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-cluster-snapshot-attribute.

AWS CLI

Um ein DB-Cluster-Snapshot-Attribut zu ändern

Im folgenden modify-db-cluster-snapshot-attribute Beispiel werden Änderungen am angegebenen DB-Cluster-Snapshot-Attribut 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 Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbClusterSnapshotAttributeunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-cluster.

AWS CLI

Beispiel 1: Um einen DB-Cluster zu ändern

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


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

Ausgabe:


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

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

Beispiel 2: Um eine VPC Sicherheitsgruppe einem DB-Cluster zuzuordnen

Das folgende modify-db-instance Beispiel ordnet eine bestimmte VPC Sicherheitsgruppe zu und entfernt DB-Sicherheitsgruppen aus einem DB-Cluster.


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 Steuern des Zugriffs mit Sicherheitsgruppen im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbClusterunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-instance.

AWS CLI

Beispiel 1: Um eine DB-Instance zu ändern

Das folgende modify-db-instance Beispiel ordnet einer kompatiblen Microsoft SQL Server-DB-Instance eine Optionsgruppe und eine Parametergruppe zu. Der --apply-immediately Parameter bewirkt, dass die Options- und Parametergruppen sofort verknüpft werden, anstatt bis zum nächsten 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 RDS Amazon-DB-Instance im RDSAmazon-Benutzerhandbuch.

Beispiel 2: So ordnen Sie eine VPC Sicherheitsgruppe einer DB-Instance zu

Im folgenden modify-db-instance Beispiel wird 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter M odifyDBInstance in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie manmodify-db-parameter-group.

AWS CLI

Um eine DB-Parametergruppe zu ändern

Im folgenden modify-db-parameter-group Beispiel wird der Wert des clr enabled Parameters in einer DB-Parametergruppe geändert. Der --apply-immediately Parameter bewirkt, dass die DB-Parametergruppe sofort geändert wird, anstatt bis zum nächsten 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 RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter M odifyDBParameter Group in der AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Proxyendpunkt für eine RDS Datenbank zu ändern

Im folgenden modify-db-proxy-endpoint Beispiel wird ein DB-Proxyendpunkt so geändertproxyEndpoint, 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 RDSAmazon-Benutzerhandbuch und Ändern eines Proxy-Endpunkts im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbProxyEndpointin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-proxy-target-group.

AWS CLI

Um einen DB-Proxyendpunkt zu ändern

Im folgenden modify-db-proxy-target-group Beispiel 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 Proxys im RDSAmazon-Benutzerhandbuch und Ändern eines RDS Proxys im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbProxyTargetGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-proxy.

AWS CLI

Um einen DB-Proxy für eine RDS Datenbank zu ändern

Im folgenden modify-db-proxy Beispiel wird ein DB-Proxy mit dem Namen proxyExample Require SSL für seine Verbindungen geändert.


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 RDSAmazon-Benutzerhandbuch und Erstellen eines RDS Proxys im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbProxyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-shard-group.

AWS CLI

Beispiel 1: Um eine DB-Shard-Gruppe zu ändern

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


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

Ausgabe:


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

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

Beispiel 2: Um Ihre DB-Shard-Gruppen zu beschreiben

Im folgenden describe-db-shard-groups Beispiel werden die Details Ihrer DB-Shard-Gruppen abgerufen, nachdem Sie den Befehl ausgeführt haben. modify-db-shard-group 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 Amazon Aurora DB Clusters im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbShardGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-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 Einen Snapshot teilen im RDSAmazon-Benutzerhandbuch.

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. Bei der Angabe eines einzelnen Kontos darf die Konto-ID nicht von Anführungszeichen oder geschweiften Klammern umgeben werden.


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 Einen Snapshot teilen im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbSnapshotAttributein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-snapshot-attributes.

AWS CLI

Um ein DB-Snapshot-Attribut zu ändern

Das folgende modify-db-snapshot-attribute Beispiel erlaubt zwei AWS Konto-IDs, 111122223333 und444455556666, den genannten mydbsnapshot DB-Snapshot 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 Einen Snapshot teilen im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbSnapshotAttributesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-snapshot.

AWS CLI

Um einen DB-Snapshot zu ändern

Im folgenden modify-db-snapshot Beispiel wird ein Postge SQL 10.6-Snapshot mit dem Namen db5-snapshot-upg-test SQL Postgre 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 Upgraden eines SQL Postgre-DB-Snapshots im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie ModifyDbSnapshotin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-db-subnet-group.

AWS CLI

Um eine DB-Subnetzgruppe zu ändern

Im folgenden modify-db-subnet-group Beispiel wird der DB-Subnetzgruppe namens ein Subnetz mit der ID subnet-08e41f9e230222222 hinzugefügt. mysubnetgroup Um die vorhandenen Subnetze in der Subnetzgruppe beizubehalten, fügen Sie deren AS-Werte in die IDs Option ein. --subnet-ids Stellen Sie sicher, dass Subnetze mit mindestens zwei verschiedenen Availability Zones 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 3: Erstellen einer DB-Subnetzgruppe im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter ModifyDbSubnetGroup AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-event-subscription.

AWS CLI

Um ein Event-Abonnement zu ändern

Im folgenden modify-event-subscription Beispiel wird das angegebene Event-Abonnement 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
    }
}

APIEinzelheiten finden Sie ModifyEventSubscriptionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztmodify-global-cluster.

AWS CLI

Um einen globalen DB-Cluster zu ändern

Das folgende modify-global-cluster Beispiel aktiviert den Löschschutz für einen Aurora My SQL -kompatiblen globalen DB-Cluster.


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

APIEinzelheiten finden Sie ModifyGlobalClusterunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztpromote-read-replica-db-cluster.

AWS CLI

Um einen DB-Cluster hochzustufen, lesen Sie Replica

Im folgenden promote-read-replica-db-cluster Beispiel wird die angegebene Read Replica zu einem eigenständigen DB-Cluster heraufgestuft.


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 Heraufstufen einer Read Replica zu einem DB-Cluster im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie unter PromoteReadReplicaDbCluster AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztpromote-read-replica.

AWS CLI

Um ein Read Replica zu bewerben

Im folgenden promote-read-replica Beispiel wird die angegebene Read Replica zu einer eigenständigen DB-Instance heraufgestuft.


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

APIEinzelheiten finden Sie unter PromoteReadReplica AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztpurchase-reserved-db-instance.

AWS CLI

Um ein reserviertes DB-Instance-Angebot zu erwerben

Im folgenden purchase-reserved-db-instances-offering Beispiel 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

APIEinzelheiten finden PurchaseReservedDbInstanceSie AWS CLI in der Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztpurchase-reserved-db-instances-offerings.

AWS CLI

Beispiel 1: Um eine reservierte DB-Instance zum Kauf zu finden

Das folgende describe-reserved-db-instances-offerings Beispiel listet die verfügbaren reservierten My SQL DB-Instances mit der Instance-Klasse db.t2.micro und einer Dauer von einem Jahr auf. 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 Reserved DB Instances for Amazon RDS im RDSAmazon-Benutzerhandbuch.

Beispiel 2: Um eine reservierte DB-Instance zu erwerben

Das folgende purchase-reserved-db-instances-offering Beispiel 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 Reserved DB Instances for Amazon RDS im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie PurchaseReservedDbInstancesOfferingsunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztreboot-db-instance.

AWS CLI

Um eine DB-Instance neu zu starten

Das folgende reboot-db-instance Beispiel startet einen Neustart der angegebenen DB-Instance.


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 Rebooting a DB Instance im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter R ebootDBInstance in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie manreboot-db-shard-group.

AWS CLI

Beispiel 1: Um eine DB-Shard-Gruppe neu zu starten

Im folgenden reboot-db-shard-group Beispiel 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 Neustart eines Amazon Aurora Aurora-DB-Clusters oder einer Amazon Aurora Aurora-DB-Instance im Amazon Aurora Aurora-Benutzerhandbuch.

Beispiel 2: Um Ihre DB-Shard-Gruppen zu beschreiben

Im folgenden describe-db-shard-groups Beispiel werden die Details Ihrer DB-Shard-Gruppen abgerufen, nachdem Sie den Befehl ausgeführt haben. reboot-db-shard-group 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 Neustart eines Amazon Aurora Aurora-DB-Clusters oder einer Amazon Aurora Aurora-DB-Instance im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie RebootDbShardGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztregister-db-proxy-targets.

AWS CLI

Um einen DB-Proxy bei einer Datenbank zu registrieren

Das folgende register-db-proxy-targets Beispiel erstellt die Zuordnung zwischen einer Datenbank und einem Proxy.


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 RDSAmazon-Benutzerhandbuch und Erstellen eines RDS Proxys im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie RegisterDbProxyTargetsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztremove-from-global-cluster.

AWS CLI

Um einen sekundären Aurora-Cluster von einem globalen Aurora-Datenbankcluster zu trennen

Im folgenden remove-from-global-cluster Beispiel wird ein sekundärer Aurora-Cluster von einem globalen Aurora-Datenbankcluster 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 globalen Amazon Aurora Aurora-Datenbank im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie RemoveFromGlobalClusterunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztremove-option-from-option-group.

AWS CLI

Um eine Option aus einer Optionsgruppe zu löschen

Im folgenden remove-option-from-option-group Beispiel wird die OEM Option von entferntmyoptiongroup.


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 aus einer Optionsgruppe im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie RemoveOptionFromOptionGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztremove-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 remove-role-from-db-cluster Beispiel 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 Zuordnen einer IAM Rolle zu einem Amazon Aurora My SQL DB-Cluster im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie RemoveRoleFromDbClusterin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztremove-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 remove-role-from-db-instance Beispiel wird die angegebene Rolle rds-s3-integration-role aus einer Oracle-DB-Instance mit dem Namen 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 Serverintegration mit S3 im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie RemoveRoleFromDbInstancein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztremove-source-identifier-from-subscription.

AWS CLI

Um eine Quell-ID aus einem Abonnement zu entfernen

Im folgenden remove-source-identifier Beispiel 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
    }
}

APIEinzelheiten finden Sie RemoveSourceIdentifierFromSubscriptionunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztremove-tags-from-resource.

AWS CLI

Um Tags aus einer Ressource zu entfernen

Im folgenden remove-tags-from-resource Beispiel 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 Tagging RDS Amazon-Ressourcen im RDSAmazon-Benutzerhandbuch und Tagging RDS Amazon-Ressourcen im Amazon Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie RemoveTagsFromResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztreset-db-cluster-parameter-group.

AWS CLI

Beispiel 1: Um alle Parameter auf ihre Standardwerte zurückzusetzen

Im folgenden reset-db-cluster-parameter-group Beispiel 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-Cluster-Parametergruppen im Amazon Aurora Aurora-Benutzerhandbuch.

Beispiel 2: Um bestimmte Parameter auf ihre Standardwerte zurückzusetzen

Im folgenden reset-db-cluster-parameter-group Beispiel werden die Parameterwerte für bestimmte Parameter auf ihre Standardwerte in einer vom Kunden erstellten DB-Cluster-Parametergruppe 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-Cluster-Parametergruppen im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie ResetDbClusterParameterGroupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztreset-db-parameter-group.

AWS CLI

Beispiel 1: Um alle Parameter auf ihre Standardwerte zurückzusetzen

Im folgenden reset-db-parameter-group Beispiel 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 RDSAmazon-Benutzerhandbuch und Arbeiten mit DB-Parametergruppen und DB-Cluster-Parametergruppen im Amazon Aurora-Benutzerhandbuch.

Beispiel 2: Um bestimmte Parameter auf ihre Standardwerte zurückzusetzen

Im folgenden reset-db-parameter-group Beispiel werden die Parameterwerte für bestimmte Parameter auf ihre Standardwerte in einer vom Kunden erstellten DB-Parametergruppe 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"
}

APIEinzelheiten finden Sie ResetDbParameterGroupin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztrestore-db-cluster-from-s3.

AWS CLI

So stellen Sie einen Amazon Aurora Aurora-DB-Cluster von Amazon S3 wieder her

Das folgende restore-db-cluster-from-s3 Beispiel stellt einen mit Amazon Aurora My SQL Version 5.7 kompatiblen DB-Cluster aus einer My SQL 5.7 DB-Backup-Datei in Amazon S3 wieder her.


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 mybucket \
    --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 My SQL mithilfe eines Amazon S3 S3-Buckets im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie unter RestoreDbClusterFromS3 in der AWS CLI Befehlsreferenz.

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

AWS CLI

Um einen DB-Cluster aus einem Snapshot wiederherzustellen

Im Folgenden wird ein Aurora SQL Postgre-DB-Cluster, der mit Postgre SQL Version 10.7 kompatibel ist, aus einem DB-Cluster-Snapshot mit dem Namen restore-db-cluster-from-snapshot wiederhergestellt. test-instance-snapshot


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

APIEinzelheiten finden Sie RestoreDbClusterFromSnapshotunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztrestore-db-cluster-to-point-in-time.

AWS CLI

Um einen DB-Cluster auf einen bestimmten Zeitpunkt wiederherzustellen

Im folgenden restore-db-cluster-to-point-in-time Beispiel wird der angegebene DB-Cluster database-4 auf den spätestmöglichen Zeitpunkt wiederhergestellt. Bei Verwendung copy-on-write als Wiederherstellungstyp wird der neue DB-Cluster als Klon des Quell-DB-Clusters wiederhergestellt.


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 einem bestimmten Zeitpunkt im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie RestoreDbClusterToPointInTimeunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztrestore-db-instance-from-db-snapshot.

AWS CLI

Um eine DB-Instance aus einem DB-Snapshot wiederherzustellen

Im folgenden restore-db-instance-from-db-snapshot Beispiel wird aus dem angegebenen DB-Snapshot eine neue db.t3.small DB-Instance db7-new-instance mit dem Namen der DB-Instance-Klasse erstellt. Die Quell-DB-Instance, von der der Snapshot erstellt 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 Aus einem DB-Snapshot wiederherstellen im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie RestoreDbInstanceFromDbSnapshotunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztrestore-db-instance-from-s3.

AWS CLI

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

Das folgende restore-db-instance-from-s3 Beispiel erstellt eine neue DB-Instance, die restored-test-instance anhand eines vorhandenen Backups im my-backups S3-Bucket benannt wird.


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

APIEinzelheiten 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: Um eine DB-Instance auf einen bestimmten Zeitpunkt zurückzusetzen

Im folgenden restore-db-instance-to-point-in-time Beispiel wird test-instance zum angegebenen Zeitpunkt eine neue DB-Instance mit dem Namen restored-test-instance wiederhergestellt.


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 einem bestimmten Zeitpunkt im RDSAmazon-Benutzerhandbuch.

Beispiel 2: So stellen Sie eine DB-Instance aus einem replizierten Backup zu einem bestimmten Zeitpunkt wieder her

Im folgenden restore-db-instance-to-point-in-time Beispiel 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 Wiederherstellung zu einem bestimmten Zeitpunkt aus einem replizierten Backup im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie unter RestoreDbInstanceToPointInTime AWS CLIBefehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstart-activity-stream.

AWS CLI

Um einen Datenbank-Aktivitätsstream zu starten

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 Datenbank-Aktivitätsstreams im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie StartActivityStreamunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstart-db-cluster.

AWS CLI

Um einen DB-Cluster zu starten

Im folgenden start-db-cluster Beispiel werden ein DB-Cluster und seine 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 Aurora-DB-Clusters im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie StartDbClusterunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstart-db-instance-automated-backups-replication.

AWS CLI

Um regionsübergreifende automatische Backups zu aktivieren

Das folgende start-db-instance-automated-backups-replication Beispiel repliziert automatisierte Backups von einer DB-Instance in der Region USA Ost (Nord-Virginia) nach USA West (Oregon). Die Aufbewahrungsfrist 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 regionsübergreifender automatisierter Backups im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie StartDbInstanceAutomatedBackupsReplicationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstart-db-instance.

AWS CLI

Um eine DB-Instance zu starten

Das folgende start-db-instance Beispiel startet die angegebene DB-Instance.


aws rds start-db-instance \
    --db-instance-identifier test-instance

Ausgabe:


{
    "DBInstance": {
        "DBInstanceStatus": "starting",
        ...some output truncated...
    }
}

APIEinzelheiten finden Sie StartDbInstanceunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstart-export-task.

AWS CLI

Um einen Snapshot nach Amazon S3 zu exportieren

Das folgende start-export-task Beispiel exportiert einen DB-Snapshot mit dem Namen db5-snapshot-test in den Amazon S3 S3-Bucket mit dem Namenmybucket.


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 mybucket \
    --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": "mybucket",
    "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 S3-Bucket im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie StartExportTaskin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstop-activity-stream.

AWS CLI

Um einen Datenbank-Aktivitätsstream zu stoppen

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 Stoppen eines Activity Streams im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie StopActivityStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstop-db-cluster.

AWS CLI

Um einen DB-Cluster zu stoppen

Das folgende stop-db-cluster Beispiel stoppt einen DB-Cluster und seine DB-Instances.


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

APIEinzelheiten finden Sie StopDbClusterunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstop-db-instance-automated-backups-replication.

AWS CLI

Um die Replikation automatisierter Backups zu beenden

Mit dem Folgenden stop-db-instance-automated-backups-replication wird die Replikation automatisierter Backups in die Region USA West (Oregon) beendet. 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 Stoppen der automatisierten Backup-Replikation im RDSAmazon-Benutzerhandbuch.

APIEinzelheiten finden Sie StopDbInstanceAutomatedBackupsReplicationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztstop-db-instance.

AWS CLI

Um eine DB-Instance zu stoppen

Das folgende stop-db-instance Beispiel stoppt die angegebene DB-Instance.


aws rds stop-db-instance \
    --db-instance-identifier test-instance

Ausgabe:


{
    "DBInstance": {
        "DBInstanceStatus": "stopping",
        ...some output truncated...
    }
}

APIEinzelheiten finden Sie StopDbInstanceunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie man es benutztswitchover-blue-green-deployment.

AWS CLI

Beispiel 1: Um eine blaue/grüne Bereitstellung für eine RDS DB-Instance zu ändern

Im folgenden switchover-blue-green-deployment Beispiel wird die angegebene grüne Umgebung als neue Produktionsumgebung beworben.


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 Umstellung auf eine blaue/grüne Bereitstellung im RDSAmazon-Benutzerhandbuch.

Beispiel 2: Um eine blaue/grüne Bereitstellung für einen Aurora My SQL DB-Cluster zu bewerben

Im folgenden switchover-blue-green-deployment Beispiel wird die angegebene grüne Umgebung als neue Produktionsumgebung beworben.


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 Umstellung auf eine blaue/grüne Bereitstellung im Amazon Aurora Aurora-Benutzerhandbuch.

APIEinzelheiten finden Sie unter SwitchoverBlueGreenDeployment AWS CLIBefehlsreferenz.

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

QLDB

RDSAmazon-Datenservice