Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Amazon-Aurora-Endpunktverbindungen
Bei Amazon Aurora kommt in der Regel keine einzelne Instance, sondern ein Cluster von DB-Instances zum Einsatz. Jede Verbindung wird von einer bestimmten DB-Instance verarbeitet. Wenn Sie eine Verbindung zu einem Aurora-Cluster herstellen, verweisen der von Ihnen angegebene Hostname und Port auf einen zwischengeschalteten Handler, der als *Endpunkt* bezeichnet wird. Aurora verwendet den Endpunktmechanismus, um diese Verbindungen zu abstrahieren. Sie müssen daher für den Ausgleich und das Umleiten von Verbindungen nicht alle Hostnamen fest codieren oder Ihre eigene Logik schreiben, wenn einige DB-Instances nicht verfügbar sind.
Bei bestimmten Aurora-Aufgaben führen verschiedene Instances oder Gruppen von Instances unterschiedliche Rollen aus. Beispielsweise verarbeitet die primäre Instance alle Data Definition Language (DDL)- und Data Manipulation Language (DML)-Anweisungen. Der schreibgeschützte Abfragedatenverkehr wird von bis zu 15 Aurora-Replicas verarbeitet.
**Topics**
+ [Typen von Aurora-Endpunkten](#Aurora.Overview.Endpoints.Types)
+ [Anzeigen der Endpunkte für einen Aurora-Cluster](#Aurora.Endpoints.Viewing)
+ [Funktionsweise von Aurora-Endpunkten mit hoher Verfügbarkeit](#Aurora.Overview.Endpoints.HA)
+ [Cluster-Endpunkte für Amazon Aurora](Aurora.Endpoints.Cluster.md)
+ [Reader-Endpunkte für Amazon Aurora](Aurora.Endpoints.Reader.md)
+ [Instance-Endpunkte für Amazon Aurora](Aurora.Endpoints.Instance.md)
+ [Benutzerdefinierte Endpunkte für Amazon Aurora](Aurora.Endpoints.Custom.md)
## Typen von Aurora-Endpunkten
Ihrem Anwendungsfall entsprechend können Sie mit Endpunkten jede Verbindung der entsprechenden Instance oder Gruppe von Instances zuordnen. Zum Ausführen von DDL-Anweisungen können Sie beispielsweise eine Verbindung mit der Instance herstellen, die als primäre Instance fungiert. Zum Durchführen von Abfragen können Sie eine Verbindung mit dem Leser-Endpunkt herstellen. Aurora führt hierbei automatisch einen Verbindungsausgleich unter allen Aurora-Replikaten aus. Bei Clustern mit DB-Instances unterschiedlicher Kapazitäten oder Konfigurationen besteht die Möglichkeit, eine Verbindung mit benutzerdefinierten Endpunkten herzustellen, die mit unterschiedlichen Untergruppen von DB-Instances verknüpft sind. Zur Diagnose und Optimierung können Sie eine Verbindung mit einem spezifischen Instance-Endpunkt herstellen, um die Details einer bestimmten DB-Instance zu untersuchen.
Ein Endpunkt wird als eine Aurora-spezifische URL dargestellt, die eine Hostadresse und einen Port enthält. In einem Aurora-DB-Cluster stehen die folgenden Endpunkt-Typen zur Verfügung:
**Cluster-Endpunkt**
Stellen Sie eine Verbindung zur primären Instance Ihres Clusters her, um Anwendungen zu entwickeln und zu testen und Transformationen wie `INSERT`-Anweisungen und DDL-, DML- und ETL-Operationen durchzuführen. Suchen Sie den Standort des Cluster-Endpunkts mithilfe der AWS-Managementkonsole AWS CLI, oder Amazon RDS-API, wie unter beschrieben[Anzeigen der Endpunkte für einen Aurora-Cluster](#Aurora.Endpoints.Viewing).
Weitere Informationen über Cluster-Endpunkte finden Sie unter [Cluster-Endpunkte für Amazon Aurora](Aurora.Endpoints.Cluster.md).
**Leser-Endpunkt**
Führen Sie Abfragen durch. Aurora führt automatisch einen Verbindungsausgleich zwischen allen Aurora-Replikaten durch. Finden Sie den Standort des Leser-Endpunkts mithilfe der AWS-Managementkonsole AWS CLI, oder Amazon RDS-API, wie unter beschrieben[Anzeigen der Endpunkte für einen Aurora-Cluster](#Aurora.Endpoints.Viewing).
Weitere Informationen über Leser-Endpunkte finden Sie unter [Reader-Endpunkte für Amazon Aurora](Aurora.Endpoints.Reader.md).
**Instance-Endpunkt**
Untersuchen Sie Details zu einer bestimmten DB-Instance zur Diagnose oder Optimierung. Sie finden den Standort des Instance-Endpunkts für jede Ihrer Instances AWS-Managementkonsole nur auf der Instance-Detailseite für Ihre Instance.
Weitere Informationen über Instance-Endpunkte finden Sie unter [Instance-Endpunkte für Amazon Aurora](Aurora.Endpoints.Instance.md).
**Benutzerdefinierter Endpunkt**
Stellen Sie eine Verbindung zu verschiedenen Teilmengen von DB-Instances auf dem DB-Cluster her. Dies ist nützlich, wenn Sie in Ihrem DB-Cluster über unterschiedliche Instance-Kapazitäten und -Konfigurationen verfügen. Suchen Sie die benutzerdefinierten Endpunktstandorte mithilfe der AWS-Managementkonsole AWS CLI, oder Amazon RDS-API, wie unter beschrieben[Anzeigen der Endpunkte für einen Aurora-Cluster](#Aurora.Endpoints.Viewing).
Weitere Informationen über benutzerdefinierte Endpunkte finden Sie unter [Benutzerdefinierte Endpunkte für Amazon Aurora](Aurora.Endpoints.Custom.md).
**Schreiber-Endpunkt von Aurora Global Database**
Aurora Global Database verfügt über einen speziellen Endpunkt, der denselben Zweck erfüllt wie der Cluster-Endpunkt eines eigenständigen Aurora-Clusters. Er verarbeitet sowohl Schreib- als auch Leseanfragen. Wenn ein sekundärer Cluster aufgrund einer Umstellung oder eines Failovers zum neuen primären Cluster wird, stellt Aurora diesen Endpunkt automatisch so um, dass er auf den Cluster-Endpunkt des neuen primären Clusters in der anderen AWS-Region verweist. Auf diese Weise müssen Sie die AWS Region nicht in der Verbindungszeichenfolge für Ihre Anwendung codieren, und Sie müssen die Verbindungszeichenfolge nicht ändern, wenn sich das Layout der globalen Datenbank ändert. Aurora erstellt diesen Endpunkt, wenn Sie eine Aurora Global Database einrichten, indem Sie beispielsweise **Region hinzufügen** für einen Aurora-Cluster in der AWS-Managementkonsole auswählen.
Weitere Informationen darüber, wie Sie diesen Endpunkttyp mit Aurora Global Database verwenden können, finden Sie unter [Verbinden mit Amazon Aurora Global Database](aurora-global-database-connecting.md).
## Anzeigen der Endpunkte für einen Aurora-Cluster
Sie können den Standort des Instance-Endpunkts zwar nur auf der Instance-Detailseite in der finden AWS-Managementkonsole, aber Sie können die Konsole oder die Amazon RDS-API verwenden AWS CLI, um die Standorte von Cluster-, Reader- und benutzerdefinierten Endpunkten zu finden.
------
#### [ Console ]
Suchen Sie auf der AWS-Managementkonsole Seite mit den Instance-Details für Ihren Cluster nach dem Cluster-Endpunkt, dem Reader-Endpunkt und allen benutzerdefinierten Endpunkten. Der Instance-Endpunkt wird auf der Detailseite der jeweiligen Instance angezeigt. Fügen Sie beim Herstellen der Verbindung dem auf der Detailseite angezeigten Namen des Endpunkts die zugewiesene Portnummer (mit einem Doppelpunkt hinter der Nummer) an.
------
#### [ AWS CLI ]
Mit dem AWS CLI finden Sie den Writer, den Reader und alle benutzerdefinierten Endpunkte in der Ausgabe des [describe-db-clusters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusters.html)Befehls. Der folgende Befehl zeigt beispielsweise die Endpunktattribute für alle Cluster in Ihrer aktuellen AWS Region.
```
aws rds describe-db-clusters --query '*[].{Endpoint:Endpoint,ReaderEndpoint:ReaderEndpoint,CustomEndpoints:CustomEndpoints}'
```
------
#### [ Amazon RDS API ]
Mit der Amazon RDS-API rufen Sie die Endpunkte ab, indem Sie den Vorgang [Describe DBCluster Endpoints](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterEndpoints.html) aufrufen.
------
## Funktionsweise von Aurora-Endpunkten mit hoher Verfügbarkeit
Verwenden Sie für Cluster, bei denen hohe Verfügbarkeit wichtig ist, den Cluster-Endpunkt für read/write allgemeine Verbindungen und den Reader-Endpunkt für schreibgeschützte Verbindungen. Die Schreiber- und Leser-Endpunkte verwalten das Failover von DB-Instances besser als Instance-Endpunkte. Im Gegensatz zu den Instance-Endpunkten ändern die Schreiber- und Leser-Endpunkte automatisch, mit welcher DB-Instance sie eine Verbindung herstellen, wenn eine DB-Instance in Ihrem Cluster nicht mehr verfügbar ist. Weitere Informationen über Cluster- und Leser-Endpunkte finden Sie unter [Cluster-Endpunkte für Amazon Aurora](Aurora.Endpoints.Cluster.md) und [Reader-Endpunkte für Amazon Aurora](Aurora.Endpoints.Reader.md).
Wenn die primäre DB-Instance eines DB-Clusters ausfällt, führt Aurora automatisch ein Failover zu einer neuen primären DB-Instance durch. Dies geschieht entweder durch Hochstufung einer vorhandenen Aurora-Replica zu einer neuen primären DB-Instance oder durch Erstellen einer neuen primären DB-Instance. Bei einem Failover können Sie den Cluster-Endpunkt verwenden, um die Verbindung zu der neu hochgestuften oder erstellten primären DB-Instance wiederherzustellen. Sie haben auch die Möglichkeit, den Leser-Endpunkt zu verwenden, um eine Verbindung zu einem der Aurora-Replikate im DB-Cluster wiederherzustellen. Während eines Failovers leitet der Reader-Endpunkt Verbindungen möglicherweise für kurze Zeit an die neue primäre DB-Instance eines DB-Clusters weiter, nachdem ein Aurora-Replica zur neuen primären DB-Instance hochgestuft wurde.
Wenn Sie Ihre Anwendungslogik so entwickeln, dass Verbindungen zu Instance-Endpunkten verwaltet werden können, ist es möglich, den daraus resultierenden Satz an verfügbaren DB-Instances im DB-Cluster manuell oder programmgesteuert zu ermitteln. Verwenden Sie den [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusters.html) AWS CLI Befehl oder den [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusters.html)RDS-API-Vorgang, um die DB-Cluster- und Reader-Endpunkte, DB-Instances, ob es sich bei DB-Instances um Lesegeräte handelt, und deren Promotion-Stufen zu ermitteln. Sie können dann die Instance-Klassen nach einem Failover bestätigen und eine Verbindung mit einem geeigneten Instance-Endpunkt herstellen.
Weitere Informationen zu Failovers finden Sie unter [Fehlertoleranz für einen Aurora-DB-Cluster](Concepts.AuroraHighAvailability.md#Aurora.Managing.FaultTolerance).
Weitere Informationen über Hochverfügbarkeit in Amazon Aurora finden Sie unter [Hohe Verfügbarkeit für Amazon Aurora](Concepts.AuroraHighAvailability.md).
# Cluster-Endpunkte für Amazon Aurora
Ein *Cluster-Endpunkt* (oder *Writer-Endpunkt*) für einen Aurora-DB-Cluster stellt eine Verbindung zur aktuellen primären DB-Instance für diesen DB-Cluster her. Nur dieser Endpunkt kann Schreibvorgänge wie z. B. DDL-Anweisungen durchführen. Aus diesem Grund sollten Sie eine Verbindung zum Cluster-Endpunkt herstellen, wenn Sie zum ersten Mal einen Cluster einrichten oder Ihr Cluster nur eine DB-Instance enthält.
Jeder Aurora-DB-Cluster verfügt über einen Cluster-Endpunkt und eine primäre DB-Instance.
Sie verwenden den Cluster-Endpunkt für alle Schreibvorgänge auf dem DB-Cluster, darunter Einfügungs-, Aktualisierungs- und Löschvorgänge sowie DDL-Änderungen. Sie können den Cluster-Endpunkt auch für Lesevorgänge nutzen, beispielsweise Abfragen.
Der Cluster-Endpunkt bietet Failover-Support für Lese-/Schreibverbindungen zum DB-Cluster. Wenn die aktuelle primäre DB-Instance eines DB-Clusters ausfällt, führt Aurora automatisch ein Failover zu einer neuen primären DB-Instance durch. Während eines Failovers bedient der DB-Cluster weiterhin Verbindungsanfragen von der neuen primären DB-Instance an den Cluster-Endpunkt mit minimaler Serviceunterbrechung.
Das folgende Beispiel zeigt einen Cluster-Endpunkt für einen Aurora MySQL-DB-Cluster.
```
mydbcluster.cluster-c7tj4example.us-east-1.rds.amazonaws.com:3306
```
Jeder Aurora-Cluster verfügt über einen integrierten Cluster-Endpunkt, dessen Name zusammen mit anderen Attributen durch Aurora verwaltet wird. Sie können einen solchen Endpunkt nicht erstellen, löschen oder ändern.
Den Cluster-Endpunkt verwenden Sie beim Verwalten Ihres Clusters, bei Extraktions-, Transformations- und Ladevorgängen (ETL) oder beim Entwickeln und Testen von Anwendungen. Der Cluster-Endpunkt stellt eine Verbindung zur primären Instance des Clusters her. Die primäre Instance ist die einzige DB-Instance, mit der Sie Tabellen und Indizes erstellen sowie `INSERT`-Anweisungen und andere DDL- und DML-Operationen ausführen können.
Die physische IP-Adresse, auf die der Cluster-Endpunkt verweist, wird geändert, wenn der Failover-Mechanismus für den Cluster eine neue DB-Instance zur primären Instance für Lese-Schreib-Operationen hochstuft. Wenn Sie irgendeine Form von Verbindungspooling oder eine andere Art von Multiplexing verwenden, müssen Sie möglicherweise zwischengespeicherte DNS-Informationen löschen oder die entsprechende Time-to-Live reduzieren. Hierdurch wird sichergestellt, dass Sie keine Lese-Schreib-Verbindung mit einer DB-Instance herstellen, die nicht mehr verfügbar ist oder nach einem Failover schreibgeschützt ist.
# Reader-Endpunkte für Amazon Aurora
Ein *Reader-Endpunkt* für einen Aurora-DB-Cluster bietet Verbindungsausgleichsunterstützung für schreibgeschützte Verbindungen zum DB-Cluster. Verwenden Sie den Leser-Endpunkt für Lesevorgänge, beispielsweise Abfragen. Durch die Verarbeitung dieser Anweisungen auf den schreibgeschützten Aurora-Replikaten reduziert dieser Endpunkt den Overhead für die primäre Instance. Er hilft dem Cluster auch, die Kapazität für gleichzeitige `SELECT`-Abfragen zu skalieren, und dies proportional zur Anzahl der Aurora-Replikate im Cluster. Jeder Aurora-DB-Cluster verfügt über einen Reader-Endpunkt.
Wenn der Cluster mindestens ein Aurora-Replikat enthält, gleicht der Reader-Endpunkt jede Verbindungsanforderung zwischen den Aurora-Replikaten aus. In diesem Fall können Sie nur schreibgeschützte Anweisungen wie `SELECT` in dieser Sitzung ausführen. Wenn der Cluster nur eine primäre Instance und keine Aurora-Replikate enthält, stellt der Reader-Endpunkt eine Verbindung zur primären Instance her. In diesem Fall können Sie Schreibvorgänge über den Endpunkt ausführen.
Das folgende Beispiel zeigt einen Leser-Endpunkt für einen Aurora MySQL-DB-Cluster.
```
mydbcluster.cluster-ro-c7tj4example.us-east-1.rds.amazonaws.com:3306
```
Sie nutzen den Reader-Endpunkt für schreibgeschützte Verbindungen Ihres Aurora-Clusters. Der Endpunkt nutzt einen Verbindungsausgleichsmechanismus, um Ihren Cluster bei der Verarbeitung abfrageintensiver Workloads zu unterstützen. Der Reader-Endpunkt ist der Endpunkt, den Sie Anwendungen zur Verfügung stellen, die Berichterstattung oder andere schreibgeschützte Operationen auf dem Cluster ausführen.
Der Reader-Endpunkt sorgt für den Ausgleich der Verbindungen zu verfügbaren Aurora-Replikaten in einem Aurora-DB-Cluster. Es wird kein Ausgleich für individuelle Abfragen durchgeführt. Wenn Sie zur Verteilung der Workload-Auslastung durch Lesevorgänge für einen DB-Cluster einen Ausgleich für jede Abfrage durchführen möchten, öffnen Sie für jede Abfrage eine neue Verbindung zum Reader-Endpunkt.
Jeder Aurora-Cluster verfügt über einen integrierten Cluster-Endpunkt verfügt, dessen Name zusammen mit anderen Attributen durch Aurora verwaltet wird. Sie können einen solchen Endpunkt nicht erstellen, löschen oder ändern.
Wenn Ihr Cluster nur ein primäres Ziel (Instance oder DB-Shard-Gruppe) und keine Aurora-Replikate enthält, stellt der Reader-Endpunkt eine Verbindung zur primären Instance her. In diesem Fall können Sie Schreibvorgänge über diesen Endpunkt ausführen.
**Tipp**
Über RDS-Proxy können Sie zusätzliche schreibgeschützte Endpunkte für einen Aurora-Cluster erstellen. Diese Endpunkte führen den gleichen Verbindungsausgleich wie der Aurora-Reader-Endpunkt aus. Anwendungen können sich schneller mit den Proxy-Endpunkten wieder verbinden als der Aurora-Reader-Endpunkt, wenn Reader-Instances nicht verfügbar sind. Die Proxy-Endpunkte können auch andere Proxy-Funktionen wie Multiplexing nutzen. Weitere Informationen finden Sie unter [Verwenden von Reader-Endpunkten mit Aurora-Clustern](rds-proxy-endpoints.md#rds-proxy-endpoints-reader).
# Instance-Endpunkte für Amazon Aurora
Ein *Instance-Endpunkt* stellt innerhalb eines Aurora-Clusters eine Verbindung zu einer spezifischen DB-Instance her. Jede DB-Instance in einem DB-Cluster hat einen eigenen, spezifischen Instance-Endpunkt. Daher ist ein Instance-Endpunkt für die aktuelle primäre DB-Instance des DB-Clusters vorhanden und es steht ein Instance-Endpunkt für jedes der Aurora-Replicas im DB-Cluster zur Verfügung.
Der Instance-Endpunkt bietet direkte Kontrolle über Verbindungen zum DB-Cluster für Szenarien, in denen die Verwendung des Cluster-Endpunkts oder des Leser-Endpunkts möglicherweise nicht angemessen ist. Beispiel: Ihre Client-Anwendung erfordert möglicherweise einen detaillierteren Verbindungsausgleich je nach Workload-Typ. In diesem Fall können Sie mehrere Clients so konfigurieren, dass sie Verbindungen zu verschiedenen Aurora-Replicas in einem DB-Cluster herstellen, um die Lese-Workloads zu verteilen. Ein Beispiel für die Verwendung von Instance-Endpunkten zur Verbesserung der Verbindungsgeschwindigkeit nach einem Failover für Aurora PostgreSQL finden Sie unter [Schnelles Failover mit Amazon Aurora PostgreSQL](AuroraPostgreSQL.BestPractices.FastFailover.md). Ein Beispiel für die Verwendung von Instance-Endpunkten zur Verbesserung der Verbindungsgeschwindigkeit nach einem Failover für Aurora MySQL finden Sie unter [MariaDB Connector/J failover support - case Amazon Aurora](https://mariadb.org/mariadb-connectorj-failover-support-case-amazon-aurora/).
Das folgende Beispiel zeigt einen Instance-Endpunkt für eine DB-Instance in einem Aurora MySQL-DB-Cluster.
```
mydbinstance.c7tj4example.us-east-1.rds.amazonaws.com:3306
```
Jede DB-Instance in einem Aurora-Cluster verfügt über ihren eigenen integrierten Instance-Endpunkt, dessen Name und andere Attribute von Aurora verwaltet werden. Sie können einen solchen Endpunkt nicht erstellen, löschen oder ändern. Möglicherweise sind Sie mit Instance-Endpunkten vertraut, wenn Sie Amazon RDS verwenden. Bei Aurora verwenden Sie die Schreiber- und Leser-Endpunkte jedoch häufiger als die Instance-Endpunkte.
Bei täglichen Aurora-Operationen werden Instance-Endpunkte hauptsächlich dazu verwendet, um Kapazitäts- oder Leistungsprobleme zu untersuchen, die eine spezifische Instance in einem Aurora-Cluster betreffen. Während eine Verbindung zu einer spezifischen Instance besteht, können Sie unter anderem deren Statusvariablen oder Metriken untersuchen. Hierdurch ist es möglich, Unterschiede zwischen den Aktivitäten verschiedener Cluster-Instances zu ermitteln.
In fortgeschrittenen Anwendungsfällen konfigurieren Sie einige DB-Instances möglicherweise anders als andere DB-Instances. Verwenden Sie in diesem Fall den Instance-Endpunkt, um eine direkte Verbindung mit einer Instance herzustellen, die kleiner oder größer ist oder sich auf eine andere Art von den anderen Instances unterscheidet. Legen Sie auch eine Failover-Priorität fest, damit diese spezielle DB-Instance bei einer Hochstufung zur primären Instance als letztes berücksichtigt wird. In solchen Fällen empfehlen wir, dass Sie nicht den Instance-Endpunkt, sondern benutzerdefinierte Endpunkte verwenden. Diese Vorgehensweise vereinfacht die Verbindungsverwaltung und trägt zur Gewährleistung von hoher Verfügbarkeit bei, wenn Sie Ihrem Cluster weitere DB-Instances hinzufügen.
# Benutzerdefinierte Endpunkte für Amazon Aurora
Ein *benutzerdefinierter Endpunkt* für einen Aurora-Cluster ist ein von Ihnen gewählter Satz an DB-Instances. Wenn Sie eine Verbindung mit dem Endpunkt herstellen, führt Aurora einen Verbindungsausgleich durch und wählt eine Instance aus der Gruppe aus, um die Verbindung zu ermöglichen. Sie bestimmen, auf welche Instances sich dieser Endpunkt bezieht, und Sie entscheiden auch, welchen Zweck der Endpunkt erfüllen soll.
Ein Aurora-DB-Cluster verfügt über keine benutzerdefinierten Endpunkte. Ein benutzerdefinierter Endpunkt muss daher von Ihnen erstellt werden. Sie können für jeden bereitgestellten Aurora-Cluster oder Cluster von Aurora Serverless v2 bis zu fünf benutzerdefinierte Endpunkte erstellen. Für Aurora Serverless v1-Cluster können keine benutzerdefinierten Endpunkte verwendet werden.
Der benutzerdefinierte Endpunkt stellt Datenbankverbindungen mit Lastausgleich bereit. Diese basieren auf anderen Kriterien als die schreibgeschützte oder die Lese-Schreib-Funktion der DB-Instances. So können Sie z. B. einen benutzerdefinierten Endpunkt definieren, um eine Verbindung mit Instances herzustellen, die eine bestimmte AWS-Instance-Klasse oder eine bestimmte DB-Parametergruppe verwenden. Sie können dann bestimmte Benutzergruppen über diesen benutzerdefinierten Endpunkt informieren. Beispielsweise können Sie internen Benutzern Instances mit geringer Kapazität für die Berichterstellung oder Ad-hoc-Abfragen (einmalig) und dem Produktionsdatenverkehr Instances mit hohen Kapazitäten zuweisen.
Da die Verbindung mit jeder mit dem benutzerdefinierten Endpunkt verknüpften DB-Instance erfolgen kann, sollten Sie sicherstellen, dass alle DB-Instances innerhalb dieser Gruppe bestimmte gemeinsame Eigenschaften aufweisen. Hierdurch wird sichergestellt, dass Leistung, Speicherkapazität usw. für alle Verbindungen mit diesem Endpunkt konsistent verfügbar sind.
Diese Funktion richtet sich an fortgeschrittene Benutzer mit besonderen Arten von Workloads, bei denen es nicht sinnvoll ist, wenn alle Aurora-Replicas im Cluster identisch sind. Mit benutzerdefinierten Endpunkten können Sie die Kapazität der DB-Instance vorhersagen, die für jede Verbindung verwendet wird. Bei der Verwendung von benutzerdefinierten Endpunkten wird der Reader-Endpunkt für diesen Cluster üblicherweise nicht verwendet.
Das folgende Beispiel zeigt einen benutzerdefinierten Endpunkt für eine DB-Instance in einem Aurora MySQL-DB-Cluster.
```
myendpoint.cluster-custom-c7tj4example.us-east-1.rds.amazonaws.com:3306
```
Benutzerdefinierte Endpunkte werden verwendet, um die Verbindungsverwaltung zu vereinfachen, wenn Ihr Cluster DB-Instances mit unterschiedlichen Kapazitäten und Konfigurationseinstellungen enthält.
Zuvor hätten Sie möglicherweise den CNAMES-Mechanismus verwendet, um DNS (Domain Name Service)-Aliasse Ihrer eigenen Domäne einzurichten und ähnliche Ergebnisse zu erzielen. Durch benutzerdefinierte Endpunkte müssen CNAME-Datensätze bei zu- oder abnehmender Größe Ihres Clusters nicht aktualisiert werden. Mit benutzerdefinierten Endpunkten können auch verschlüsselte Transport Layer Security (TLS)- und Secure Sockets Layer (SSL)-Verbindungen verwendet werden.
Anstatt für jeden bestimmten Zweck eine DB-Instance zu verwenden und eine Verbindung zu deren Instance-Endpunkt herzustellen, können Sie mehrere Gruppen spezifischer DB-Instances nutzen. In diesem Fall verfügt jede Gruppe über ihren eigenen benutzerdefinierten Endpunkt. Hierdurch kann Aurora einen Verbindungsausgleich unter allen Instances durchführen, die für Aufgaben wie Berichterstellung, die Verarbeitung der Produktionslast oder interne Abfragen bestimmt sind. Die benutzerdefinierten Endpunkte verteilen die Verbindungen passiv auf die Instances und verwenden DNS, um die IP-Adresse einer der Instances nach dem Zufallsprinzip zurückzugeben. Sollte eine DB-Instance innerhalb einer Gruppe nicht mehr verfügbar sein, leitet Aurora nachfolgende Verbindungen benutzerdefinierter Endpunkte an eine der anderen DB-Instances weiter, die mit demselben Endpunkt verknüpft sind.
**Topics**
+ [Überlegungen zu benutzerdefinierten Endpunkten in Amazon Aurora](Aurora.Endpoints.Custom.Considerations.md)
+ [Erstellen eines benutzerdefinierten Endpunkts](aurora-custom-endpoint-creating.md)
+ [Anzeigen von benutzerdefinierten Endpunkten](aurora-endpoint-viewing.md)
+ [Bearbeiten eines benutzerdefinierten Endpunkts](aurora-endpoint-editing.md)
+ [Löschen eines benutzerdefinierten Endpunkts](aurora-endpoints-custom-deleting.md)
+ [AWS CLI Beispiele für benutzerdefinierte Endpunkte für Amazon Aurora](Aurora.Endpoint.Tutorial.md)
# Überlegungen zu benutzerdefinierten Endpunkten in Amazon Aurora
Verwenden Sie die Informationen in den folgenden Abschnitten, um benutzerdefinierte Endpunkte zu verwalten, Eigenschaften dafür anzugeben und Mitgliedschaftsregeln zu verwenden.
**Topics**
+ [Verwalten von benutzerdefinierten Endpunkten](#Aurora.Endpoints.Custom.Managing)
+ [Angeben der Eigenschaften für benutzerdefinierte Endpunkte](#Aurora.Endpoints.Custom.Properties)
+ [Mitgliedschaftsregeln für benutzerdefinierte Endpunkte](#Aurora.Endpoints.Custom.Membership)
## Verwalten von benutzerdefinierten Endpunkten
Da neu erstellte Aurora-Cluster über keine benutzerdefinierten Endpunkte verfügen, müssen Sie diese Objekte selbst erstellen und verwalten. Sie tun dies mit der AWS-Managementkonsole AWS CLI, oder Amazon RDS-API.
**Anmerkung**
Sie müssen auch benutzerdefinierte Endpunkte für Aurora-Cluster erstellen und verwalten, die anhand von Snapshots wiederhergestellt wurden. Benutzerdefinierte Endpunkte sind nicht im Snapshot enthalten. Sie erstellen sie nach der Wiederherstellung erneut und wählen neue Endpunktnamen, wenn sich der wiederhergestellte Cluster in der gleichen Region wie der ursprüngliche Cluster befindet.
Um mit benutzerdefinierten Endpunkten von zu arbeiten AWS-Managementkonsole, navigieren Sie zur Detailseite für Ihren Aurora-Cluster und verwenden die Steuerelemente im Abschnitt **Benutzerdefinierte Endpunkte**.
Um mit benutzerdefinierten Endpunkten aus dem zu arbeiten AWS CLI, können Sie die folgenden Operationen verwenden:
+ [create-db-cluster-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-endpoint.html)
+ [describe-db-cluster-endpoints](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-endpoints.html)
+ [modify-db-cluster-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-endpoint.html)
+ [delete-db-cluster-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-endpoint.html)
Sie können die folgenden Funktionen verwenden, um über die Amazon-RDS-API mit benutzerdefinierten Endpunkten zu arbeiten:
+ [Endpunkt erstellen DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterEndpoint.html)
+ [Beschreiben Sie DBCluster Endpunkte](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterEndpoints.html)
+ [Endpunkt ändern DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterEndpoint.html)
+ [DBClusterEndpunkt löschen](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterEndpoint.html)
## Angeben der Eigenschaften für benutzerdefinierte Endpunkte
Die maximale Länge des Namens für einen benutzerdefinierten Endpunkt beträgt 63 Zeichen. Der Name hat folgendes Format:
```
endpoint_name.cluster-custom-customer_DNS_identifier.AWS_Region.rds.amazonaws.com
```
Sie können den Namen eines benutzerdefinierten Endpunkts nicht für mehr als einen Cluster in derselben AWS-Region verwenden. Die benutzerdefinierte DNS-ID ist eine eindeutige Kennung, die mit Ihrer AWS-Konto bestimmten Kennung verknüpft ist AWS-Region.
Jedem benutzerdefinierten Endpunkt ist ein Typ zugeordnet, der bestimmt, welche DB-Instances diesem Endpunkt zugeordnet werden können. Zurzeit kann der Typ entweder `READER` oder `ANY` sein. Für die benutzerdefinierten Endpunkttypen gelten die folgenden Überlegungen:
+ Sie können den benutzerdefinierten Endpunkttyp nicht in der AWS-Managementkonsole auswählen. Alle benutzerdefinierten Endpunkte, die Sie über die erstellen, AWS-Managementkonsole haben einen Typ von`ANY`.
Sie können den benutzerdefinierten Endpunkttyp mithilfe der AWS CLI oder der Amazon RDS-API festlegen und ändern.
+ Nur Reader-DB-Instances können Teil eines benutzerdefinierten `READER`-Endpunkts sein.
+ Sowohl Reader- als auch Writer-DB-Instances können Teil eines benutzerdefinierten `ANY`-Endpunkts sein. Aurora leitet Verbindungen zu Cluster-Endpunkten mit Typ `ANY` mit gleicher Wahrscheinlichkeit zu jeder zugehörigen DB-Instance. Der Typ `ANY` gilt für Cluster mit allen Replikationstopologien.
+ Wenn Sie versuchen, einen benutzerdefinierten Endpunkt mit einem Typ zu erstellen, der mit der Replikationskonfiguration eines Clusters nicht kompatibel ist, zeigt Aurora eine Fehlermeldung an.
## Mitgliedschaftsregeln für benutzerdefinierte Endpunkte
Wenn Sie eine DB-Instance einem benutzerdefinierten Endpunkt hinzufügen oder aus einem benutzerdefinierten Endpunkt entfernen, bleiben alle vorhandenen Verbindungen zu dieser DB-Instance bestehen.
Sie können eine Liste mit DB-Instances definieren, die im benutzerdefinierten Endpunkt enthalten oder aus diesem ausgeschlossen sein sollen. Wir bezeichnen diese Listen als *statische* bzw. als *Ausschlusslisten*. Sie können den inclusion/exclusion Mechanismus verwenden, um die Gruppen von DB-Instances weiter zu unterteilen und sicherzustellen, dass der Satz von benutzerdefinierten Endpunkten alle DB-Instances im Cluster abdeckt. Jeder benutzerdefinierte Endpunkt kann jeweils nur einen dieser Listentypen enthalten.
Im: AWS-Managementkonsole
+ Die Auswahl wird durch das Kontrollkästchen **Attach future instances added to this cluster** (Zukünftige Instances diesem Cluster anfügen) dargestellt. Wenn Sie das Kontrollkästchen deaktivieren, verwendet der benutzerdefinierte Endpunkt eine statische Liste, die nur die auf der Seite angegebenen DB-Instances enthält. Wenn Sie das Kontrollkästchen aktivieren, verwendet der benutzerdefinierte Endpunkt eine Ausschlussliste. In diesem Fall repräsentiert der benutzerdefinierte Endpunkt alle DB-Instances im Cluster (einschließlich zukünftig hinzugefügter DB-Instances) außer jenen, die auf der Seite nicht ausgewählt wurden.
+ In der Konsole können Sie den Endpunkttyp nicht angeben. Jeder benutzerdefinierte Endpunkt, der mit der Konsole erstellt wurde, weist den Typ `ANY` auf.
Daher ändert Aurora die Mitgliedschaft des benutzerdefinierten Endpunkts nicht, wenn DB-Instances aufgrund eines Failovers oder einer Hochstufung die Rollen zwischen Writer und Reader ändern.
In der AWS CLI und der Amazon RDS-API:
+ Sie können den Endpunkttyp angeben. Wenn der Endpunkttyp auf `READER` gesetzt ist, wird die Endpunkt-Mitgliedschaft daher bei Failovers und Hochstufungen automatisch angepasst.
Beispielsweise enthält ein benutzerdefinierter Endpunkt des Typs `READER` ein Aurora-Replikat, das anschließend zu einer Writer-DB-Instance hochgestuft wird. Die neue Writer-Instance ist nicht mehr Teil des benutzerdefinierten Endpunkts.
+ Sie können einzelne Mitglieder den Listen hinzufügen und sie aus den Listen entfernen, nachdem sie ihre Rollen geändert haben. Verwenden Sie den [modify-db-cluster-endpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-endpoint.html) AWS CLI Befehl oder den Vorgang [„DBClusterEndpoint API modifizieren](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterEndpoint.html)“.
Sie können eine DB-Instance mit mehreren benutzerdefinierten Endpunkten verknüpfen. Angenommen, Sie fügen einem Cluster eine neue DB-Instance hinzu, oder eine DB-Instance wird von Aurora automatisch durch den Mechanismus der automatischen Skalierung hinzugefügt. In diesen Fällen wird die DB-Instance allen infrage kommenden benutzerdefinierten Endpunkten hinzugefügt. Welchen Endpunkten die DB-Instance hinzugefügt wird, hängt vom benutzerdefinierten Endpunkt des Typs `READER` oder `ANY` sowie von statischen Listen oder Ausschlusslisten ab, die für jeden Endpunkt definiert wurden. Wenn der Endpunkt beispielsweise eine statische Liste von DB-Instances enthält, werden kürzlich hinzugefügte Aurora-Replicas nicht diesem Endpunkt hinzugefügt. Wenn der Endpunkt über eine Ausschlussliste verfügt, werden neu hinzugefügte Aurora-Replicas dem Endpunkt hinzugefügt, wenn sie nicht in der Ausschlussliste aufgeführt sind und ihre Rollen dem Typ des benutzerdefinierten Endpunkts entsprechen.
Wenn ein Aurora-Replica nicht mehr verfügbar ist, bleibt es weiterhin mit benutzerdefinierten Endpunkten verknüpft. Das Replica bleibt Teil des benutzerdefinierten Endpunkts, wenn es z. B. nicht voll funktionsfähig ist, angehalten wurde oder neu startet. Sie können jedoch erst dann eine Verbindung über diese Endpunkte zum Replica herstellen, wenn es wieder verfügbar ist.
# Erstellen eines benutzerdefinierten Endpunkts
Erstellen Sie einen benutzerdefinierten Endpunkt mit der AWS-Managementkonsole, der AWS CLI oder der Amazon-RDS-API.
## Konsole
Zum Erstellen eines benutzerdefinierten Endpunkts mit der AWS-Managementkonsole besuchen Sie die Cluster-Detailseite und wählen Sie im Abschnitt **Endpoints (Endpunkte)** die Aktion `Create custom endpoint` aus. Wählen Sie einen Namen für den benutzerdefinierten Endpunkt aus. Dieser muss für Ihre Benutzer-ID und Region eindeutig sein. Um eine Liste von DB-Instances auszuwählen, die auch bei einer Erweiterung des Clusters gleich bleibt, lassen Sie das Kontrollkästchen **Attach future instances added to this cluster (Zukünftige zu diesem Cluster hinzugefügte Instances anhängen)** deaktiviert. Wenn Sie dieses Kontrollkästchen aktivieren, fügt der benutzerdefinierte Endpunkt dynamisch alle neuen Instances hinzu, wenn Sie sie zum Cluster hinzufügen.
![\[Erstellen Sie eine benutzerdefinierte Endpunktseite mit Feldern für die Endpunkt-ID, die Auswahl des Instance-Typs und statischen Optionen bzw. Ausschlussoptionen.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/AuroraCreateCustomEndpoint.png)
Sie können den benutzerdefinierten Endpunkttyp nicht in der AWS-Managementkonsole auswählen. Alle von Ihnen mit der AWS-Managementkonsole erstellten benutzerdefinierten Endpunkte haben den Typ `ANY`.
## AWS CLI
Zum Erstellen eines benutzerdefinierten Endpunkts mit der AWS CLI führen Sie den Befehl [create-db-cluster-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-endpoint.html) aus.
Mit folgendem Befehl wird ein benutzerdefinierter Endpunkt erstellt, der an einen bestimmten Cluster angefügt ist. Zu Beginn wird der Endpunkt mit allen Aurora-Replica-Instances des Clusters verknüpft. Über einen nachfolgenden Befehl wird er mit einem spezifischen Satz an DB-Instances im Cluster verknüpft.
Für Linux, macOS oder Unix:
```
aws rds create-db-cluster-endpoint --db-cluster-endpoint-identifier custom-endpoint-doc-sample \
--endpoint-type reader \
--db-cluster-identifier cluster_id
aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier custom-endpoint-doc-sample \
--static-members instance_name_1 instance_name_2
```
Für Windows:
```
aws rds create-db-cluster-endpoint --db-cluster-endpoint-identifier custom-endpoint-doc-sample ^
--endpoint-type reader ^
--db-cluster-identifier cluster_id
aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier custom-endpoint-doc-sample ^
--static-members instance_name_1 instance_name_2
```
## RDS-API
Zum Erstellen eines benutzerdefinierten Endpunkts mit der RDS-API führen Sie die Aktion [CreateDBClusterEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterEndpoint.html) aus.
# Anzeigen von benutzerdefinierten Endpunkten
## Konsole
Zum Anzeigen von benutzerdefinierten Endpunkten mit der AWS-Managementkonsole gehen Sie zur Cluster-Detailseite des entsprechenden Clusters und rufen den Abschnitt **Endpoints (Endpunkte)** auf. Dieser Abschnitt enthält nur Informationen zu benutzerdefinierten Endpunkten. Die Details der integrierten Endpunkte sind im Abschnitt zu den wichtigsten **Details** aufgeführt. Um die Details für einen spezifischen benutzerdefinierten Endpunkt anzuzeigen, wählen Sie dessen Namen aus. Daraufhin wird die Detailseite für diesen Endpunkt geöffnet.
Der folgende Screenshot zeigt, dass die Liste der benutzerdefinierten Endpunkte für einen Aurora-Cluster zu Beginn leer ist.
![\[Endpunktseite ohne benutzerdefinierte Endpunkte\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/AuroraCustomEndpointEmptyList.png)
Nachdem Sie einige benutzerdefinierte Endpunkte für diesen Cluster erstellt haben, werden diese im Abschnitt **Endpoints (Endpunkte)** angezeigt.
![\[Endpunktseite mit zwei benutzerdefinierten Endpunkten\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/AuroraCustomEndpointList.png)
Auf der Detailseite sehen Sie, mit welchen DB-Instances der Endpunkt derzeit verknüpft ist.
![\[DB-Instances, die einem benutzerdefinierten Endpunkt zugeordnet sind\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/AuroraCustomEndpointDetail.png)
Um darüber hinaus anzuzeigen, ob dem Cluster neu hinzugefügte DB-Instances automatisch auch in den Endpunkt integriert werden, rufen Sie die Seite **Bearbeiten** für den Endpunkt auf.
## AWS CLI
Zum Anzeigen benutzerdefinierter Endpunkte mit der AWS CLI führen Sie den Befehl [describe-db-cluster-endpoints](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-endpoints.html) aus.
Mit folgendem Befehl werden die benutzerdefinierten Endpunkte angezeigt, die mit einem bestimmten Cluster in einer bestimmten Region verknüpft sind. Die Ausgabe beinhaltet sowohl die integrierten Endpunkte als auch jeden benutzerdefinierten Endpunkt.
Für Linux, macOS oder Unix:
```
aws rds describe-db-cluster-endpoints --region region_name \
--db-cluster-identifier cluster_id
```
Für Windows:
```
aws rds describe-db-cluster-endpoints --region region_name ^
--db-cluster-identifier cluster_id
```
Im folgenden Beispiel wird der Befehl `describe-db-cluster-endpoints` mit einer Beispielausgabe gezeigt. Der `EndpointType` von `WRITER` oder `READER` bezeichnet die integrierten Schreib- und Lese- sowie schreibgeschützten Endpunkte des Clusters. Der `EndpointType` `CUSTOM` bezeichnet Endpunkte, die von Ihnen erstellt und deren verknüpfte DB-Instances von Ihnen ausgewählt werden. Einer der Endpunkte verfügt über ein Feld `StaticMembers`, das angibt, dass der Endpunkt mit einem genau bestimmten Satz an DB-Instances verknüpft ist. Dieses Feld kann nicht leer sein. Der andere Endpunkt verfügt über ein Feld `ExcludedMembers`, das angibt, dass der Endpunkt mit *anderen* als den unter `ExcludedMembers` aufgeführten DB-Instances verknüpft ist. Auch dieses Feld kann nicht leer sein. Die zweite Art benutzerdefinierter Endpunkte wird größer, um neue Instances zu berücksichtigen, die dem Cluster hinzufügt werden.
```
{
"DBClusterEndpoints": [
{
"Endpoint": "custom-endpoint-demo.cluster-c7tj4example.ca-central-1.rds.amazonaws.com",
"Status": "available",
"DBClusterIdentifier": "custom-endpoint-demo",
"EndpointType": "WRITER"
},
{
"Endpoint": "custom-endpoint-demo.cluster-ro-c7tj4example.ca-central-1.rds.amazonaws.com",
"Status": "available",
"DBClusterIdentifier": "custom-endpoint-demo",
"EndpointType": "READER"
},
{
"CustomEndpointType": "ANY",
"DBClusterEndpointIdentifier": "powers-of-2",
"ExcludedMembers": [],
"DBClusterIdentifier": "custom-endpoint-demo",
"Status": "available",
"EndpointType": "CUSTOM",
"Endpoint": "powers-of-2.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com",
"StaticMembers": [
"custom-endpoint-demo-04",
"custom-endpoint-demo-08",
"custom-endpoint-demo-01",
"custom-endpoint-demo-02"
],
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-W7PE3TLLFNSHXQKFU6J6NV5FHU",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:111122223333:cluster-endpoint:powers-of-2"
},
{
"CustomEndpointType": "ANY",
"DBClusterEndpointIdentifier": "eight-and-higher",
"ExcludedMembers": [
"custom-endpoint-demo-04",
"custom-endpoint-demo-02",
"custom-endpoint-demo-07",
"custom-endpoint-demo-05",
"custom-endpoint-demo-03",
"custom-endpoint-demo-06",
"custom-endpoint-demo-01"
],
"DBClusterIdentifier": "custom-endpoint-demo",
"Status": "available",
"EndpointType": "CUSTOM",
"Endpoint": "eight-and-higher.cluster-custom-123456789012.ca-central-1.rds.amazonaws.com",
"StaticMembers": [],
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-W7PE3TLLFNSHYQKFU6J6NV5FHU",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:111122223333:cluster-endpoint:eight-and-higher"
}
]
}
```
## RDS-API
Zum Anzeigen benutzerdefinierter Endpunkte mit der RDS-API führen Sie die Aktion [DescribeDBClusterEndpoints.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterEndpoints.html.html) aus.
# Bearbeiten eines benutzerdefinierten Endpunkts
Sie können die Eigenschaften eines benutzerdefinierten Endpunkts bearbeiten, um die mit dem Endpunkt verknüpften DB-Instances zu ändern. Sie können bei einem Endpunkt auch zwischen einer statischen und einer Ausschlussliste wechseln. Weitere Informationen zu diesen Endpunkteigenschaften finden Sie unter [Mitgliedschaftsregeln für benutzerdefinierte Endpunkte](Aurora.Endpoints.Custom.Considerations.md#Aurora.Endpoints.Custom.Membership).
Sie können einen benutzerdefinierten Endpunkt weiterhin verwenden oder eine Verbindung zu diesem herstellen, wenn die Änderungen einer Bearbeitungsaktion noch verarbeitet werden.
## Konsole
Zum Erstellen eines benutzerdefinierten Endpunkts mit der AWS-Managementkonsole wählen Sie den Endpunkt auf der Cluster-Detailseite aus oder rufen die Detailseite des Endpunkts auf und wählen dort die Aktion **Edit (Bearbeiten)** aus.
![\[Bearbeiten eines benutzerdefinierten Endpunkts\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/AuroraEditCustomEndpoint.png)
## AWS CLI
Zum Bearbeiten eines benutzerdefinierten Endpunkts mit der AWS CLI führen Sie den Befehl [modify-db-cluster-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-endpoint.html) aus.
Mit den folgenden Befehlen wird der Satz an DB-Instances geändert, die für einen benutzerdefinierten Endpunkt gelten, und optional zwischen dem Verhalten einer statischen Liste oder einer Ausschlussliste gewechselt. Die Parameter `--static-members` und `--excluded-members` weisen eine durch Leerzeichen getrennte Liste von DB-Instance-Kennungen auf.
Für Linux, macOS oder Unix:
```
aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier my-custom-endpoint \
--static-members db-instance-id-1 db-instance-id-2 db-instance-id-3 \
--region region_name
aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier my-custom-endpoint \
--excluded-members db-instance-id-4 db-instance-id-5 \
--region region_name
```
Für Windows:
```
aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier my-custom-endpoint ^
--static-members db-instance-id-1 db-instance-id-2 db-instance-id-3 ^
--region region_name
aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier my-custom-endpoint ^
--excluded-members db-instance-id-4 db-instance-id-5 ^
--region region_name
```
## RDS-API
Zum Bearbeiten eines benutzerdefinierten Endpunkts mit der RDS-API führen Sie die Aktion [ModifyDBClusterEndpoint.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterEndpoint.html.html) aus.
# Löschen eines benutzerdefinierten Endpunkts
Löschen Sie einen benutzerdefinierten Endpunkt mit der AWS-Managementkonsole, der AWS CLI oder der Amazon-RDS-API.
## Konsole
Zum Löschen eines benutzerdefinierten Endpunkts mit der AWS-Managementkonsole wählen Sie auf der Cluster-Detailseite den entsprechenden benutzerdefinierten Endpunkt und dann die Aktion **Delete (Löschen)** aus.
![\[Seite „Benutzerdefinierte Endpunkte löschen“\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/AuroraDeleteCustomEndpoint.png)
## AWS CLI
Zum Löschen eines benutzerdefinierten Endpunkts mit der AWS CLI führen Sie den Befehl [delete-db-cluster-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-endpoint.html) aus.
Mit folgendem Befehl wird ein benutzerdefinierter Endpunkt gelöscht: Sie müssen nicht den verknüpften Cluster, aber die Region angeben.
Für Linux, macOS oder Unix:
```
aws rds delete-db-cluster-endpoint --db-cluster-endpoint-identifier custom-end-point-id \
--region region_name
```
Für Windows:
```
aws rds delete-db-cluster-endpoint --db-cluster-endpoint-identifier custom-end-point-id ^
--region region_name
```
## RDS-API
Zum Löschen eines benutzerdefinierten Endpunkts mit der RDS-API führen Sie die Aktion [DeleteDBClusterEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterEndpoint.html) aus.
# AWS CLI Beispiele für benutzerdefinierte Endpunkte für Amazon Aurora
Das folgende Tutorial zeigt anhand von AWS CLI Beispielen mit Unix-Shell-Syntax, wie Sie einen Cluster mit mehreren „kleinen“ DB-Instances und einigen „großen“ DB-Instances definieren und benutzerdefinierte Endpunkte erstellen können, um eine Verbindung zu jeder Gruppe von DB-Instances herzustellen. Um ähnliche Befehle auf Ihrem eigenen System ausführen zu können, sollten Sie mit den Grundlagen der Arbeit mit Aurora-Clustern und der AWS CLI Verwendung vertraut sein, um Ihre eigenen Werte für Parameter wie Region, Subnetzgruppe und VPC-Sicherheitsgruppe bereitzustellen.
Dieses Beispiel verdeutlicht die ersten Einrichtungsschritte: das Erstellen eines Aurora-Clusters und das Hinzufügen von DB-Instances. Hierbei handelt es sich um einen heterogenen Cluster, weshalb nicht alle DB-Instances über die gleiche Kapazität verfügen. Die meisten Instances verwenden die AWS Instance-Klasse`db.r4.4xlarge`, aber die letzten beiden DB-Instances verwenden sie. `db.r4.16xlarge` Bei jedem dieser `create-db-instance`-Beispielbefehle wird die Ausgabe auf dem Bildschirm angezeigt und eine Kopie der JSON-Datei zur späteren Prüfung gespeichert.
```
aws rds create-db-cluster --db-cluster-identifier custom-endpoint-demo --engine aurora-mysql \
--engine-version 8.0.mysql_aurora.3.04.0 --master-username $MASTER_USER --manage-master-user-password \
--db-subnet-group-name $SUBNET_GROUP --vpc-security-group-ids $VPC_SECURITY_GROUP \
--region $REGION
for i in 01 02 03 04 05 06 07 08
do
aws rds create-db-instance --db-instance-identifier custom-endpoint-demo-${i} \
--engine aurora --db-cluster-identifier custom-endpoint-demo --db-instance-class db.r4.4xlarge \
--region $REGION \
| tee custom-endpoint-demo-${i}.json
done
for i in 09 10
do
aws rds create-db-instance --db-instance-identifier custom-endpoint-demo-${i} \
--engine aurora --db-cluster-identifier custom-endpoint-demo --db-instance-class db.r4.16xlarge \
--region $REGION \
| tee custom-endpoint-demo-${i}.json
done
```
Die größeren Instances sind für spezialisierte Arten von Berichtsabfragen vorgesehen. Damit diese nicht auf die primäre Instance hochgestuft werden, wird im folgenden Beispiel gezeigt, wie der Hochstufungsebene für diese Instances die niedrigste Priorität zugewiesen wird. In diesem Beispiel wird die Option `--manage-master-user-password` zum Generieren des Hauptbenutzerpassworts und zum Verwalten dieses Passworts in Secrets Manager angegeben. Weitere Informationen finden Sie unter [Passwortverwaltung mit , Amazon Aurora und AWS Secrets Manager](rds-secrets-manager.md). Alternativ können Sie die Option `--master-password` verwenden, um das Passwort selbst festzulegen und zu verwalten.
```
for i in 09 10
do
aws rds modify-db-instance --db-instance-identifier custom-endpoint-demo-${i} \
--region $REGION --promotion-tier 15
done
```
Angenommen, Sie möchten die zwei „größeren“ Instances nur für die ressourcenintensivsten Abfragen verwenden. Dazu können Sie zunächst einen benutzerdefinierten schreibgeschützten Endpunkt erstellen. Anschließend können Sie eine statische Liste von Elementen hinzufügen, sodass der Endpunkt nur mit diesen DB-Instances verbunden ist. Da sich diese Instances bereits in der niedrigsten Hochstufungsebene befinden, ist es unwahrscheinlich, dass eine von ihnen auf die primäre Instance hochgestuft wird. Sollte eine der Instances auf die primäre Instance hochgestuft worden sein, wäre sie über diesen Endpunkt nicht erreichbar, da der `READER`-Typ anstatt des `ANY`-Typs angegeben wurde.
Das folgende Beispiel verdeutlicht das Erstellen und Ändern von Endpunktbefehlen sowie eine JSON-Beispielausgabe mit dem ursprünglichen und geänderten Status des benutzerdefinierten Endpunkts.
```
$ aws rds create-db-cluster-endpoint --region $REGION \
--db-cluster-identifier custom-endpoint-demo \
--db-cluster-endpoint-identifier big-instances --endpoint-type reader
{
"EndpointType": "CUSTOM",
"Endpoint": "big-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com",
"DBClusterEndpointIdentifier": "big-instances",
"DBClusterIdentifier": "custom-endpoint-demo",
"StaticMembers": [],
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-W7PE3TLLFNSHXQKFU6J6NV5FHU",
"ExcludedMembers": [],
"CustomEndpointType": "READER",
"Status": "creating",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:111122223333:cluster-endpoint:big-instances"
}
$ aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier big-instances \
--static-members custom-endpoint-demo-09 custom-endpoint-demo-10 --region $REGION
{
"EndpointType": "CUSTOM",
"ExcludedMembers": [],
"DBClusterEndpointIdentifier": "big-instances",
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-W7PE3TLLFNSHXQKFU6J6NV5FHU",
"CustomEndpointType": "READER",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:111122223333:cluster-endpoint:big-instances",
"StaticMembers": [
"custom-endpoint-demo-10",
"custom-endpoint-demo-09"
],
"Status": "modifying",
"Endpoint": "big-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com",
"DBClusterIdentifier": "custom-endpoint-demo"
}
```
Der standardmäßige `READER`-Endpunkt des Clusters kann eine Verbindung entweder zur kleinen oder zur großen DB-Instance herstellen. Hierdurch wird das Vorhersagen der Abfrageleistung und der Skalierbarkeit bei einer hohen Auslastung des Clusters erschwert. Um den Workload zwischen den DB-Instance-Sätzen klar aufzuteilen, können Sie den standardmäßigen `READER`-Endpunkt ignorieren und einen zweiten benutzerdefinierten Endpunkt erstellen, der eine Verbindung mit den anderen DB-Instances herstellt. Im folgenden Beispiel wird dies erreicht, indem zunächst ein benutzerdefinierter Endpunkt erstellt und dann eine Ausschlussliste hinzugefügt wird. Alle anderen DB-Instances, die Sie dem Cluster später hinzufügen, werden automatisch in diesen Endpunkt integriert. Der Typ `ANY` signalisiert, dass dieser Endpunkt mit insgesamt acht Instances verknüpft ist: mit der primären Instance und sieben anderen Aurora-Replicas. Wenn im Beispiel der Typ `READER` verwendet würde, wäre der benutzerdefinierte Endpunkt nur mit den sieben Aurora-Replicas verknüpft.
```
$ aws rds create-db-cluster-endpoint --region $REGION --db-cluster-identifier custom-endpoint-demo \
--db-cluster-endpoint-identifier small-instances --endpoint-type any
{
"Status": "creating",
"DBClusterEndpointIdentifier": "small-instances",
"CustomEndpointType": "ANY",
"EndpointType": "CUSTOM",
"Endpoint": "small-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com",
"StaticMembers": [],
"ExcludedMembers": [],
"DBClusterIdentifier": "custom-endpoint-demo",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:111122223333:cluster-endpoint:small-instances",
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-6RDDXQOC3AKKZT2PRD7ST37BMY"
}
$ aws rds modify-db-cluster-endpoint --db-cluster-endpoint-identifier small-instances \
--excluded-members custom-endpoint-demo-09 custom-endpoint-demo-10 --region $REGION
{
"DBClusterEndpointIdentifier": "small-instances",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:c7tj4example:cluster-endpoint:small-instances",
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-6RDDXQOC3AKKZT2PRD7ST37BMY",
"CustomEndpointType": "ANY",
"Endpoint": "small-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com",
"EndpointType": "CUSTOM",
"ExcludedMembers": [
"custom-endpoint-demo-09",
"custom-endpoint-demo-10"
],
"StaticMembers": [],
"DBClusterIdentifier": "custom-endpoint-demo",
"Status": "modifying"
}
```
Im folgenden Beispiel wird der Status der Endpunkte dieses Clusters geprüft. Mit dem `EndPointType` `WRITER` verfügt der Cluster immer noch über seinen ursprünglichen Cluster-Endpunkt, den Sie weiterhin für die Administration, für Extraktions-, Transformations- und Ladevorgänge (ETL) und andere Schreibvorgänge nutzen würden. Er verfügt immer noch über seinen ursprünglichen `READER`-Endpunkt, den Sie nicht verwenden würden, da jede zu ihm hergestellte Verbindung möglicherweise zu einer kleinen oder großen DB-Instance weitergeleitet wird. Die benutzerdefinierten Endpunkte machen dieses Verhalten vorhersehbar, da Verbindungen verwendet werden, die, je nach angegebenem Endpunkt, garantiert eine der kleinen oder großen DB-Instances verwenden.
```
$ aws rds describe-db-cluster-endpoints --region $REGION
{
"DBClusterEndpoints": [
{
"EndpointType": "WRITER",
"Endpoint": "custom-endpoint-demo.cluster-c7tj4example.ca-central-1.rds.amazonaws.com",
"Status": "available",
"DBClusterIdentifier": "custom-endpoint-demo"
},
{
"EndpointType": "READER",
"Endpoint": "custom-endpoint-demo.cluster-ro-c7tj4example.ca-central-1.rds.amazonaws.com",
"Status": "available",
"DBClusterIdentifier": "custom-endpoint-demo"
},
{
"Endpoint": "small-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com",
"CustomEndpointType": "ANY",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:111122223333:cluster-endpoint:small-instances",
"ExcludedMembers": [
"custom-endpoint-demo-09",
"custom-endpoint-demo-10"
],
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-6RDDXQOC3AKKZT2PRD7ST37BMY",
"DBClusterIdentifier": "custom-endpoint-demo",
"StaticMembers": [],
"EndpointType": "CUSTOM",
"DBClusterEndpointIdentifier": "small-instances",
"Status": "modifying"
},
{
"Endpoint": "big-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com",
"CustomEndpointType": "READER",
"DBClusterEndpointArn": "arn:aws:rds:ca-central-1:111122223333:cluster-endpoint:big-instances",
"ExcludedMembers": [],
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-W7PE3TLLFNSHXQKFU6J6NV5FHU",
"DBClusterIdentifier": "custom-endpoint-demo",
"StaticMembers": [
"custom-endpoint-demo-10",
"custom-endpoint-demo-09"
],
"EndpointType": "CUSTOM",
"DBClusterEndpointIdentifier": "big-instances",
"Status": "available"
}
]
}
```
In den abschließenden Beispielen wird gezeigt, wie nachfolgende Datenbankverbindungen zu den benutzerdefinierten Endpunkten eine Verbindung mit den zahlreichen DB-Instances im Aurora-Cluster herstellen. Der `small-instances`-Endpunkt stellt immer eine Verbindung zu den `db.r4.4xlarge`-DB-Instances her. Diese stellen die Hosts mit den niedrigeren Nummern in diesem Cluster dar.
```
$ mysql -h small-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com -u $MYUSER -p
mysql> select @@aurora_server_id;
+-------------------------+
| @@aurora_server_id |
+-------------------------+
| custom-endpoint-demo-02 |
+-------------------------+
$ mysql -h small-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com -u $MYUSER -p
mysql> select @@aurora_server_id;
+-------------------------+
| @@aurora_server_id |
+-------------------------+
| custom-endpoint-demo-07 |
+-------------------------+
$ mysql -h small-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com -u $MYUSER -p
mysql> select @@aurora_server_id;
+-------------------------+
| @@aurora_server_id |
+-------------------------+
| custom-endpoint-demo-01 |
+-------------------------+
```
Der `big-instances`-Endpunkt stellt immer eine Verbindung zu den `db.r4.16xlarge`-DB-Instances her, die die beiden höchst nummerierten Hosts in diesem Cluster sind.
```
$ mysql -h big-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com -u $MYUSER -p
mysql> select @@aurora_server_id;
+-------------------------+
| @@aurora_server_id |
+-------------------------+
| custom-endpoint-demo-10 |
+-------------------------+
$ mysql -h big-instances.cluster-custom-c7tj4example.ca-central-1.rds.amazonaws.com -u $MYUSER -p
mysql> select @@aurora_server_id;
+-------------------------+
| @@aurora_server_id |
+-------------------------+
| custom-endpoint-demo-09 |
+-------------------------+
```