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.
# 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 |
+-------------------------+
```