Connexion avec cURL

Vous pouvez accéder à votre base de données Elasticsearch directement à partir d'un terminal de ligne de commande via cURL. Elasticsearch dispose d'une grande variété d'API REST qui permettent la surveillance de cluster, la gestion d'index et la recherche dans la base de données.

Les chaînes de connexion sont affichées dans le panneau Endpoints de la page Overview de votre déploiement et peuvent également être récupérées à partir du plug-in CLI des bases de données en nuage et de l'API.

Panneau de terminaison CLI
Section des terminaisons, onglet CLI

Les informations dont vous avez besoin pour établir une connexion avec cURL à votre déploiement se trouvent également dans la section "CLI" d'un justificatif d'identité créé sur la page Certificats d'identité du service. Le tableau ci-après est fourni à titre de référence.

informations sur la connexion curl
Nom de zone Index Description
Bin Le binaire recommandé pour créer une connexion ; dans ce cas, il s'agit de curl.
Composed Commande formatée pour établir une connexion à votre déploiement. La commande combine l'exécutable Bin, les paramètres de la variable Environment et utilise Arguments comme paramètres de ligne de commande.
Environment Liste de clés/valeurs que vous définissez en tant que variables d'environnement.
Arguments 0... Informations qui sont transmises en tant qu'arguments à la commande affichée dans la zone Bin.
Certificate Base64 Certificat propriétaire de service utilisé pour confirmer qu'une application se connecte au serveur approprié. Il est encodé en base64.
Certificate Nom Nom attribué au certificat propriétaire du service.
Type Type de package qui utilise ces informations de connexion ; en l'occurrence, cli.
  • 0... indique qu'il peut y avoir une ou plusieurs de ces entrées dans un tableau.

Exemple cURL d'API Elasticsearch

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 effectue la vérification de certificat SSL par défaut. Comme votre déploiement utilise un certificat propriétaire de service, vous devez spécifier le certificat à utiliser.
  • curl - Commande proprement dite.
  • -u - Paramètre pour le nom d'utilisateur et le mot de passe, séparés par un signe deux-points, à utiliser comme données d'identification pour se connecter au déploiement Elasticsearch.
  • https://... - Le paramètre qui spécifie les nœuds finaux auxquels la commande curl se connecte. Il est composé d'URL de protocole HTTPS et inclut un numéro de port.
  • /_cluster/health?pretty - Noeud final d'API de cluster Elasticsearch qui renvoie le statut de votre cluster.

Utilisation du certificat de propriété du service

  1. Copiez les informations relatives au certificat à partir du panneau Endpoints ou du champ Base64 des informations de connexion de la lettre de créance de service.
  2. Si besoin, décodez la chaîne Base64 en texte.
  3. Sauvegardez le certificat dans un fichier. (Vous pouvez utiliser le nom qui est fourni ou votre propre nom de fichier.)
  4. Indiquez le chemin d'accès à la variable CURL_CA_BUNDLE.

Prise en charge du plug-in CLI pour le certificat propriétaire du service

Vous pouvez afficher le certificat décodé pour votre déploiement avec le plug-in d'interface de ligne de commande à l'aide de la commande ibmcloud cdb deployment-cacert "your-service-name". Elle décode la chaîne base64 en texte. Copiez et sauvegardez le résultat de la commande dans un fichier et affectez à la variable CURL_CA_BUNDLE le chemin d'accès au fichier.