2.13 OCIコマンドを使用したOracle Cloud Infrastructure REST APIの呼出し

SQLclリリース20.2以降では、OCIコマンドを使用してOracle Cloud Infrastructure (OCI) REST APIを呼び出すことができます。

関連項目:

Oracle Cloud Infrastructure APIドキュメント

前提条件

OCIコマンドを使用するには、最初に認証およびアクセス用のOCIプロファイルを設定する必要があります。

必要なSSHキーの設定方法およびOracle Cloud Infrastructureソフトウェア開発キットの構成方法の詳細は、Oracle Cloud Infrastructureドキュメントの設定および前提条件を参照してください。

OCI構成ファイル(~/.oci/config)に含まれるプロファイルをリストするには、次のように入力します。

oci profile

プロファイル名をdemoに設定するには、次のように入力します。

oci profile demo

SQLclリリース23.3から、DEFAULT OCIプロファイルがインストールされている場合は、SQLclの起動時にロードされます。

2つの構文形式

OCIコマンドを使用する際には、2つの構文形式を使用できます。

ターゲットの指定

最初の構文形式では、ターゲットはOCIコマンドで完全に指定されます。

oci <host> <method> [file-to-send-as-body] <request-target> 

ここで

methodは、GET、PUTまたはDELETEです。

request-targetは、host上のネームスペース、バケットまたはオブジェクトのパスです。

例

emp.csvファイルをtesting-bucketから削除するには、次のようにします。

oci objectstorage.us-ashburn-1.oraclecloud.com delete /n/abc123/b/testing-bucket/o/emp.csv 

testing-bucketの内容をリストするには、次のようにします。

oci objectstorage.us-ashburn-1.oraclecloud.com get /n/abc123/b/testing-bucket/o/ 

emp.csvファイルをtesting-bucketに格納するには、次のようにします。

oci objectstorage.us-ashburn-1.oraclecloud.com put ./emp.csv /n/abc123/b/testing-bucket/o/emp.csv

emp.csvファイルをtesting-bucketから取得するには、次のようにします。

oci objectstorage.us-ashburn-1.oraclecloud.com get /n/abc123/b/testing-bucket/o/emp.csv 

クラウド・ストレージ・コマンドを使用したターゲットの指定

2番目の構文形式では、ターゲットは、クラウド・ストレージ・コマンド(cs)を使用して設定される場所の完全なURLまたは部分的なURLです。

oci <method> [file-to-send-as-body] <qualifier>

ここで

methodは、GET、PUTまたはDELETEです。

qualifierは、クラウド・ストレージのネームスペースまたはバケットです。qualifierは、クラウド・ストレージの設定コマンドで指定された場所に追加され、methodで使用されるネームスペース、バケットまたはオブジェクトの完全なURLを形成する必要があります。

Cloud Storageコマンドの詳細は、クラウド・ストレージの使用を参照してください。

例

emp.csvをtesting-bucketから削除するには、次のようにします。

cs objectstorage.us-ashburn-1.oraclecloud.com
oci delete /n/abc123/b/testing-bucket/o/emp.csv 

testing-bucketの内容をリストするには、次のようにします。

--Using the OCI Command (oci get)

cs objectstorage.us-ashburn-1.oraclecloud.com/n/abc123/b/testing-bucket/o/
oci get

--Using the Cloud Storage Command (cs listo)

cs objectstorage.us-ashburn-1.oraclecloud.com/n/abc123/b/testing-bucket/o/
cs listo

emp.csvをtesting-bucketに格納するには、次のようにします。

cs objectstorage.us-ashburn-1.oraclecloud.com/n/abc123/b/testing-bucket
oci put ./emp.csv /o/emp.csv 

emp.csvをtesting-bucketから取得するには、次のようにします。

cs objectstorage.us-ashburn-1.oraclecloud.com/n/abc123/b/testing-bucket
oci get /o/emp.csv