機械翻訳について
  1. REST API for Oracle EssbaseREST API for Oracle Essbase
  2. cURLの使用

cURLの使用

このドキュメント内の例では、cURLを使用してEssbase REST APIにアクセスする方法を示します。cURLは、HTTPリクエストやその他のリクエストを行うために使用できるコマンドライン・データ転送ツールです。

タスク1: cURLのインストール

サーバーに安全に接続するには、SSLをサポートするバージョンのcURLをインストールし、Verisign CA証明書に対して認証するためのSSL認証局(CA)証明書ファイルまたはバンドルを提供する必要があります。 認証の詳細は、「認証」を参照してください。

次の手順は、cURLをWindows 64-bitシステムにインストールする方法を示しています。

  1. ブラウザで、http://curl.haxx.seのcURLホーム・ページに移動し、左側のナビゲーション・メニューの「ダウンロード」をクリックします。

  2. cURL Releases and Downloadsページで、使用しているオペレーティング・システムに対応するSSL対応バージョンのcURLソフトウェアを探し、ZIPファイルをダウンロードするためのリンクをクリックして、ソフトウェアをインストールします。

  3. http://curl.haxx.se/docs/caextract.htmlのcURL「CA証明書」ページに移動し、cURLをインストールしたフォルダにca-bundle.crt SSL CA証明書バンドルをダウンロードします。

  4. コマンド・ウィンドウを開き、cURLをインストールしたディレクトリに移動し、cURL環境変数CURL_CA_BUNDLEをSSL認証局(CA)証明書バンドルのロケーションに設定します。 例:

    C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt

これで、cURLを使用してリクエストを送信する準備ができました。

タスク2: cURLの環境変数の設定

コマンド・ウィンドウで、cURL環境変数CURL_CA_BUNDLEをローカルCA証明書バンドルのロケーションに設定します。 例:

C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt

cURLを使用したCA証明書の検証の詳細は、http://curl.haxx.se/docs/sslcerts.htmlを参照してください。

タスク3: cURLの起動

cURLを起動し、必要に応じて、次の表に定義されているコマンドライン・オプションのいずれかを指定して、その実行を指示します。

cURLオプション 説明
-d, --data @file.json ローカル・マシン上のJSON形式のリクエスト本文を含むファイルを識別します。 または、-d"{id=5,status='OK'}を使用してリクエスト本文を渡すこともできます。
-F, --form @file.json ローカル・マシン上のフォーム・データをJSON形式で識別します。
-H --header, -I -include, and -X --request <method> 次のいずれかまたは両方を定義します:

  • リクエスト・ドキュメントのコンテンツ・タイプ

  • アイデンティティ・ドメインを識別するカスタム・ヘッダー、X-ID-TENANT-NAME

-i レスポンス・ヘッダー情報を表示します。
-u, --user <username>:<password> Essbaseのユーザー名とパスワードを指定します。 これらをすべてのcURLコマンドで指定しないようにするには、cookieの実装または変数の使用を検討してください。 https://ec.haxx.se/http-cookies.htmlを参照してください。
-X リクエストのタイプ(GET、POSTなど)を示します。

例:

curl -i -X GET -u username:password https://192.0.2.1:443/essbase/rest/v1/about