IBM Cloud Docs
cURL による接続

cURL による接続

Elasticsearch データベースにはコマンド・ライン端末から cURL を使用して直接アクセスすることができます。 Elasticsearch には、データベース内での クラスター・モニター索引管理 、および 検索 を可能にするさまざまな REST API が用意されています。

接続文字列は、配置の [概要] ページの [エンドポイント] パネルに表示され、クラウド データベース CLI プラグインAPI からも取得できます。

CLI エンドポイントパネル
エンドポイントセクション、CLI タブ

cURL を使用してデプロイメントに接続するために必要な情報は、サービス資格情報ページで作成した資格情報の「CLI」セクションにもあります。 参照用に、接続文字列の構成要素を次の表に示します。

curl接続情報
フィールド名 索引 説明
Bin 接続を作成するための推奨バイナリー。この場合は curl になります。
Composed デプロイメントへの接続を確立するための構成済みのコマンド。 このコマンドは、Bin 実行可能プログラムと Environment 変数設定を組み合わせ、コマンド・ライン・パラメーターとして Arguments を使用します。
Environment 環境変数として設定したキー/値のリスト。
Arguments 0... Bin フィールドに示されているコマンドに引数として渡される情報
Certificate Base64 アプリケーションが適切なサーバーに接続していることを確認するために使用される、サービス独自の証明書。 base64 でエンコードされています。
Certificate 名前 サービス専有証明書に割り当てられた名前。
Type この接続情報を使用するパッケージのタイプ。この場合は cli です。
  • 0... は、1 つの配列にこれらのエントリーが 1 つ以上ある可能性があることを示しています。

Elasticsearch API cURL の例

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 はデフォルトで SSL 証明書の検証を実行します。 配置はサービス独自の証明書を使用するため、使用する証明書を指定する必要があります。
  • curl - コマンド自体。
  • -u - Elasticsearch デプロイメントにログインするための資格情報として使用される、コロンで区切ったユーザー名とパスワードのパラメーター。
  • https://... - curl コマンドが接続するエンドポイントを指定するパラメーター。 これは HTTPS プロトコルの URL で構成され、ポート番号を含んでいます。
  • /_cluster/health?pretty - クラスターの状況を返す Elasticsearch クラスター API エンドポイント。

サービス独自証明書の使用

  1. Endpoints」 パネルまたはサービス・クレデンシャル接続情報の「 Base64 」フィールドから証明書情報をコピーする。
  2. 必要に応じて、Base64 ストリングをテキストにデコードします。
  3. 証明書をファイルに保存します (提供される名前、または独自のファイル名を使用できます)。
  4. CURL_CA_BUNDLE 変数へのパスを指定します。

サービス独自証明書のCLIプラグインサポート

コマンド ibmcloud cdb deployment-cacert "your-service-name" を使用して、デプロイメントのデコードされた証明書を CLI プラグインと共に表示することができます。 これにより、base64 がテキストにデコードされます。 コマンドの出力をコピーしてファイルに保存し、そのファイルのパスを CURL_CA_BUNDLE 変数に指定します。