Aktivieren der Amazon-RDS-Daten-API - Amazon Aurora

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.

Aktivieren der Amazon-RDS-Daten-API

Um die Amazon-RDS-Daten-API (Daten-API) nutzen zu können, müssen Sie sie für Ihren Aurora-DB-Cluster aktivieren. Sie können die Daten-API aktivieren, wenn Sie den DB-Cluster erstellen oder ändern.

Anmerkung

Ob die Daten-API für Ihren Cluster verfügbar ist, hängt von Ihrer Aurora-Version, Datenbank-Engine und AWS-Region ab. Für ältere Aurora-Versionen funktioniert die Daten-API nur mit Aurora Serverless v1-Clustern. Bei neueren Aurora-Versionen funktioniert die Daten-API mit Clustern, die sowohl bereitgestellte als auch Aurora Serverless v2-Instances verwenden. Informationen dazu, ob Ihr Cluster die Daten-API verwenden kann, finden Sie unter Unterstützte Regionen und Aurora-DB-Engines für RDS-Daten-API.

Aktivieren der RDS-Daten-API beim Erstellen einer Datenbank

Während Sie eine Datenbank erstellen, die die RDS-Daten-API (Daten-API) unterstützt, können Sie dieses Feature aktivieren. In den folgenden Verfahren wird beschrieben, wie Sie vorgehen müssen, wenn Sie die AWS-Managementkonsole, die AWS CLI oder die RDS-API verwenden.

Um die Daten-API bei der Erstellung eines DB-Clusters zu aktivieren, wählen Sie das Kontrollkästchen RDS-Daten-API aktivieren im Bereich Konnektivität der Seite Datenbank erstellen aus, wie im folgenden Screenshot gezeigt.

Der Abschnitt „Konnektivität“ auf der Seite „Datenbank erstellen“ mit ausgewähltem Kontrollkästchen „RDS-Daten-API aktivieren“.

Anleitungen zum Erstellen eines Aurora-DB-Clusters, der die RDS-Daten-API nutzen kann, finden Sie unten:

Um die Daten-API zu aktivieren, während Sie einen Aurora-DB-Cluster erstellen, führen Sie den AWS CLI-Befehl create-db-cluster mit der Option --enable-http-endpoint aus.

Im folgenden Beispiel wird ein DB-Cluster von Aurora PostgreSQL mit aktivierter Daten-API erstellt.

Für Linux, macOS oder Unix:

aws rds create-db-cluster \ --db-cluster-identifier my_pg_cluster \ --engine aurora-postgresql \ --enable-http-endpoint

Für Windows:

aws rds create-db-cluster ^ --db-cluster-identifier my_pg_cluster ^ --engine aurora-postgresql ^ --enable-http-endpoint

Um die Daten-API zu aktivieren, während Sie einen Aurora-DB-Cluster erstellen, verwenden Sie den Vorgang CreateDBCluster, wobei der Wert des Parameters EnableHttpEndpoint auf true gesetzt sein muss.

Aktivieren der RDS-Daten-API in einer vorhandenen Datenbank

Sie können einen DB-Cluster ändern, der die RDS-Daten-API (Daten-API) unterstützt, um dieses Feature zu aktivieren oder zu deaktivieren.

Aktivieren oder Deaktivieren der Daten-API (Aurora Serverless v2 und bereitgestellt)

Verwenden Sie die folgenden Verfahren, um die Daten-API in Aurora Serverless v2 und bereitgestellten Datenbanken zu aktivieren oder zu deaktivieren. Verwenden Sie die Verfahren unter Aktivieren oder Deaktivieren der Daten-API (nur Aurora Serverless v1), um die Daten-API in Aurora Serverless v1-Datenbanken zu aktivieren oder zu deaktivieren.

Sie können die Daten-API aktivieren oder deaktivieren, indem Sie die RDS-Konsole für einen DB-Cluster verwenden, der dieses Feature unterstützt. Öffnen Sie dazu die Cluster-Detailseite der Datenbank, für die Sie die Daten-API aktivieren oder deaktivieren möchten, und wechseln Sie auf der Registerkarte Konnektivität und Sicherheit zum Abschnitt RDS-Daten-API. In diesem Abschnitt wird der Status der Daten-API angezeigt und Sie können sie aktivieren oder deaktivieren.

Der folgende Screenshot zeigt, dass die RDS-Daten-API nicht aktiviert ist.

Der Abschnitt „RDS-Daten-API“ auf der Registerkarte „Konnektivität und Sicherheit“ der Detailseite für einen DB-Cluster. Der Status der Daten-API wird als deaktiviert angezeigt, und die Schaltfläche „RDS-Daten-API aktivieren“ ist vorhanden.

Um die Daten-API in einer vorhandenen Datenbank zu aktivieren oder zu deaktivieren, führen Sie den AWS CLI-Befehl enable-http-endpoint oder disable-http-endpoint aus und geben Sie den ARN Ihres DB-Clusters an.

Das folgende Beispiel aktiviert die Daten-API.

Für Linux, macOS oder Unix:

aws rds enable-http-endpoint \ --resource-arn cluster_arn

Für Windows:

aws rds enable-http-endpoint ^ --resource-arn cluster_arn

Verwenden Sie die Operationen EnableHttpEndpoint und DisableHttpEndpoint, um die Daten-API in einer vorhandenen Datenbank zu aktivieren oder zu deaktivieren.

Aktivieren oder Deaktivieren der Daten-API (nur Aurora Serverless v1)

Verwenden Sie die folgenden Verfahren, um die Daten-API in vorhandenen Aurora Serverless v1-Datenbanken zu aktivieren oder zu deaktivieren. Verwenden Sie die Verfahren unter Aktivieren oder Deaktivieren der Daten-API (Aurora Serverless v2 und bereitgestellt), um die Daten-API für Aurora Serverless v2- und bereitgestellte Datenbanken zu aktivieren oder zu deaktivieren.

Wenn Sie einen Aurora Serverless v1-DB-Cluster bearbeiten, aktivieren Sie die Daten-API im Abschnitt Konnektivität der RDS-Konsole.

Der folgende Screenshot zeigt die aktivierte Daten-API beim Ändern eines Aurora-DB-Clusters.

Im Abschnitt „Konnektivität“ auf der Seite „DB-Cluster ändern“ ist das Kontrollkästchen „Daten-API“ aktiviert.

Anleitungen zum Ändern eines Aurora Serverless v1-DB-Clusters finden Sie unter Ändern eines Aurora Serverless v1-DB-Clusters.

Um die Daten-API zu aktivieren oder zu deaktivieren, führen Sie den AWS CLI-Befehl modify-db-cluster mit --enable-http-endpoint oder --no-enable-http-endpoint aus.

Im folgenden Beispiel wird die Daten-API in einem sample-cluster aktiviert.

Für Linux, macOS oder Unix:

aws rds modify-db-cluster \ --db-cluster-identifier sample-cluster \ --enable-http-endpoint

Für Windows:

aws rds modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --enable-http-endpoint

Um die Daten-API zu aktivieren, verwenden Sie den Vorgang ModifyDBCluster und setzen Sie den Wert von EnableHttpEndpoint je nach Bedarf auf true oder false.