IBM Cloud Docs
Verbindung zu cURL herstellen

Verbindung zu cURL herstellen

Sie können auf Ihre Elasticsearch-Datenbank direkt mit cURL über einen Befehlszeilenterminal zugreifen. Elasticsearch verfügt über eine Vielzahl von REST APIs, die die Clusterüberwachung, die Indexverwaltung und die Suche in der Datenbank ermöglichen.

Verbindungszeichenfolgen werden im Bereich Endpunkte auf der Übersichtsseite Ihrer Bereitstellung angezeigt und können auch über das Cloud-Datenbank-CLI-Plug-in und die API abgerufen werden.

CLI-Endpunkte-Panel
Endpunkte-Abschnitt, CLI-Registerkarte

Die Informationen, die Sie benötigen, um eine Verbindung mit cURL zu Ihrer Bereitstellung herzustellen, befinden sich auch im Abschnitt "CLI" eines Credentials, das auf der Seite Service credentials erstellt wurde. Die Tabelle enthält eine Aufgliederung zu Referenzzwecken.

informationen zur Curl-Verbindung
Feldname Index Beschreibung
Bin Die empfohlene Binärdatei zum Erstellen einer Verbindung. In diesem Fall ist dies curl.
Composed Ein formatierter Befehl zum Aufbauen einer Verbindung zu Ihrer Bereitstellung. Der Befehl kombiniert die ausführbare Datei Bin, die Environment und verwendet Arguments als Befehlszeilenparameter.
Environment Eine Liste von Schlüsseln/Werten, die Sie als Umgebungsvariablen festlegen.
Arguments 0... Die Informationen, die als Argumente an den im Feld 'Bin' angezeigten Befehl übergeben werden.
Certificate Base64 Ein diensteigenes Zertifikat, das verwendet wird, um zu bestätigen, dass eine Anwendung eine Verbindung zum entsprechenden Server herstellt. Das Zertifikat liegt in Base64-Codierung vor.
Certificate Name Der zugewiesene Name für das diensteigene Zertifikat.
Type Der Typ des Pakets, das diese Verbindungsinformationen verwendet; in diesem Fall cli.
  • 0... Gibt an, dass es möglicherweise weitere derartige Einträge in einem Array gibt.

cURL-Beispiel für Elasticsearch-API

CURL_CA_BUNDLE="/path-to/your_cert_file" curl -u admin:<password> 'https://d5eeee66-5bc4-499a-b73b-1307848f1eac.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:31821/_cluster/health?pretty'
  • CURL_CA_BUNDLE: cURL führt standardmäßig eine SSL-Zertifikatsprüfung durch. Da Ihre Bereitstellung ein diensteigenes Zertifikat verwendet, müssen Sie angeben, welches Zertifikat verwendet werden soll.
  • curl: Der Befehl selbst.
  • -u: Der Parameter für den Benutzernamen und das Kennwort, die durch einen Doppelpunkt getrennt sind und als Berechtigungsnachweise für die Anmeldung bei der Elasticsearch-Bereitstellung verwendet werden sollen.
  • https://... - Der Parameter, der die Endpunkte angibt, zu denen der curl-Befehl eine Verbindung herstellt. Er setzt sich aus HTTPS-Protokoll-URLs zusammen und enthält eine Portnummer.
  • /_cluster/health?pretty: Ein API-Endpunkt für Elasticsearch-Cluster, der den Status Ihres Clusters zurückgibt.

Verwendung des diensteigenen Zertifikats

  1. Kopieren Sie die Zertifikatsinformationen aus dem Bereich Endpunkte oder aus dem Feld Base64 der Verbindungsinformationen der Dienstanmeldeinformationen.
  2. Decodieren Sie bei Bedarf die Base64-Zeichenfolge in Text.
  3. Speichern Sie das Zertifikat in einer Datei. (Sie können den vorgegebenen Namen übernehmen oder einen eigenen Dateinamen angeben. )
  4. Geben Sie den Pfad für die Variable CURL_CA_BUNDLE an.

CLI-Plugin-Unterstützung für das diensteigene Zertifikat

Sie können das decodierte Zertifikat für Ihre Bereitstellung mit dem CLI-Plugin mit dem Befehl ibmcloud cdb deployment-cacert "your-service-name" anzeigen. Dadurch werden in Base64 codierte Zeichenfolgen in Text decodiert. Kopieren Sie die Ausgabe des Befehls und speichern Sie sie in einer Datei und geben Sie den Pfad der Datei zur Variablen CURL_CA_BUNDLE an.