Zum Hauptinhalt springen

Erstellen einer Redis-Datenbank über die API

Dieser Artikel beschreibt, wie Du eine Redis-Datenbank über die API erstellst.

Voraussetzungen​

Um eine Redis-Datenbank zu erstellen, benötigst Du Zugriff auf ein Projekt. Wie Du ein Projekt erstellst, erfährst Du hier. Du benötigst die Projekt-ID für die folgenden Schritte.

Liste verfügbarer Redis-Versionen​

Sende eine GET-Anfrage an den GET/v2/redis-versions/-Endpunkt, um eine Liste der verfügbaren Redis-Versionen zu erhalten.

Jedes zurückgegebene Versionsobjekt enthält die folgenden Eigenschaften:

  • id enthält die eindeutige Kennung der Version
  • number enthält die Versionsnummer (z. B. "7.0")
  • name enthält einen für Menschen lesbaren Namen für die Version
  • disabled gibt an, ob die Version zur Verwendung verfügbar ist

Wichtig: Bei der Auswahl einer Version für Deine Datenbank musst Du eine Version wählen, bei der disabled den Wert false hat.

Erstellen einer Redis-Datenbank​

Um eine Redis-Datenbank zu erstellen, sende eine Anfrage an den POST/v2/projects/{projectId}/redis-databases/-Endpunkt. Der Anfrage-Body muss ein JSON-Objekt mit den folgenden Eigenschaften enthalten:

  • description sollte eine für Menschen lesbare Beschreibung der Datenbank enthalten. Dies ist ein Pflichtwert.
  • version sollte die Versionsnummer der Datenbank enthalten (z. B. "7.0"). Dies ist ein Pflichtwert und muss mit der number-Eigenschaft einer Version übereinstimmen, die vom Endpunkt GET/v2/redis-versions/ zurückgegeben wird (nicht mit der id-Eigenschaft).

Die Antwort enthält die folgenden Eigenschaften:

  • id enthält die ID der erstellten Datenbank.

Zugriff auf die Datenbank​

Nachdem Du eine Datenbank erstellt hast, kannst Du eine Anfrage an den GET/v2/redis-databases/{redisDatabaseId}/-Endpunkt senden.

Die Antwort enthält unter anderem die folgenden Werte:

  • hostname und port enthalten den Hostnamen und den Port der Datenbank. Du kannst diese Werte verwenden, um dich von deiner Hosting-Umgebung aus mit der Datenbank zu verbinden.
  • configuration ermöglicht es Dir, die spezifischen Konfigurationswerte einzusehen, die auf Deine Datenbank angewendet wurden.