cURL
による接続
Elasticsearch データベースにはコマンド・ライン端末から cURL を使用して直接アクセスすることができます。 Elasticsearch には、データベース内での クラスター・モニター、 索引管理 、および 検索 を可能にするさまざまな REST API が用意されています。
接続文字列は、配置の [概要] ページの [エンドポイント] パネルに表示され、クラウド データベース CLI プラグイン や API からも取得できます。

cURL を使用してデプロイメントに接続するために必要な情報は、サービス資格情報ページで作成した資格情報の「CLI」セクションにもあります。 参照用に、接続文字列の構成要素を次の表に示します。
フィールド名 | 索引 | 説明 |
---|---|---|
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 エンドポイント。
サービス独自証明書の使用
- Endpoints」 パネルまたはサービス・クレデンシャル接続情報の「 Base64 」フィールドから証明書情報をコピーする。
- 必要に応じて、Base64 ストリングをテキストにデコードします。
- 証明書をファイルに保存します (提供される名前、または独自のファイル名を使用できます)。
CURL_CA_BUNDLE
変数へのパスを指定します。
サービス独自証明書のCLIプラグインサポート
コマンド ibmcloud cdb deployment-cacert "your-service-name"
を使用して、デプロイメントのデコードされた証明書を CLI プラグインと共に表示することができます。 これにより、base64 がテキストにデコードされます。 コマンドの出力をコピーしてファイルに保存し、そのファイルのパスを CURL_CA_BUNDLE
変数に指定します。