Oracle Cloud Infrastructure Compute ClassicのREST API

cURLの使用

cURLは、URL構文を含むデータを転送するためのオープン・ソースのコマンドライン・ツールであり、HTTPやHTTPSを含む各種のプロトコルをサポートしています。このドキュメントの例では、cURLを使用してCompute Classic REST APIにアクセスする方法を示しています。

cURLのダウンロードとインストールの詳細は、クイック・スタートを参照してください。 SSLをサポートするバージョンのcURLをインストールする必要があります。

認証要件の詳細は、「認証」を参照してください。

インストールしたら、cURLを使用してCompute Classic REST APIにアクセスします:

Verisign社のCA証明書に対して認証される、SSL認証局(CA)証明書ファイルまたはバンドルの場所にCURL_CA_BUNDLE環境変数を設定します。あるいは、--cacertオプションを使用して、コマンドラインにローカルCA証明書バンドルの場所を指定できます。

SSL CA証明書バンドルはhttp://curl.haxx.se/docs/caextract.htmlからダウンロードするか、各自で用意します。 cURLを使用したCA証明書の検証の詳細は、http://curl.haxx.se/docs/sslcerts.htmlを参照してください。

cURLを起動して、次の表に定義されたコマンドライン・オプションを必要に応じて1つ以上指定することで、その実行を指示します。

cURLオプション	説明
`--cacert`	ローカル・マシン上のCA証明書バンドルのロケーションを指定します。注意: cURLコマンドの実行中にこのオプションを指定することは必須ではありません。ただし、`「Peer certificate cannot be authenticated with known CA certificates」`エラーが発生した場合は、このオプションを使用して適切な証明書ファイルまたはバンドルの場所を指定します。
`-d, --data @file.json`	ローカル・マシン上でJSON形式のリクエスト・ドキュメントを識別します。
`-F, --form @file.json`	ローカル・マシン上でJSON形式のフォーム・データを識別します。
`-H`	次のいずれか、または両方を定義します。リクエスト・ドキュメントのコンテンツ・タイプ受入れヘッダー
`-i`	レスポンス・ヘッダー情報を表示します。
`-u、--user username:password`	Compute Classicアカウントのユーザー名とパスワードを指定します。認証cookieを渡している場合、すべてのリクエストとともにユーザー名とパスワードを渡す必要はありません。詳細は、「認証」を参照してください。
`-X`	GET、POST、DELETE、またはPUTなどの、リクエストのタイプを示します。

例:

curl -i -X GET 
        --cacert ~/cacert.pem
        -u <username>:<password> 
        -H <request-header>:<value> 
        https://<api-endpoint>/<path>/<resource-path>

次のcURLコマンドの例では、myVolumeという名前のストレージ・ボリュームを、/Compute-acme/jack.jones@example.comサービス・インスタンスに作成します。

curl -X POST 
     -H "Cookie: $COMPUTE_COOKIE" 
     -H "Content-Type: application/oracle-compute-v3+json" 
     -d '{"size": "10G", 
          "properties": ["/oracle/public/storage/default"], 
          "name": "/Compute-acme/jack.jones@example.com/myVolume"}' 
     https://api-z999.compute.us0.oraclecloud.com/storage/volume/

COMPUTE_COOKIEは、認証cookieを格納する変数の名前です。詳細は、「認証」を参照してください。

注意:

HTTPリクエストを送信する必要があるURLについては、「リクエストの送信」を参照してください。