環境準備
クライアントPC等から実行する場合はOCI CLIのインストールや初期設定が必要です。
Cloud Shellを使えばインストール＆設定済みのOCI CLIが使えますので、今回はCloud Shellを使っていきます。
OCIコンソールの左上のアイコンから起動できます。
VMクラスタのシェイプや現在のCPU数を確認する
コマンド
oci db cloud-vm-cluster get \
--cloud-vm-cluster-id <VMクラスタのOCID> \
--query 'data.{"1.Name":"display-name","2.shape":"shape","3.cpu-core-count":"cpu-core-count"}'
コマンド実行結果例
{
"1.Name": "testvm1",
"2.shape": "Exadata.X11M",
"3.cpu-core-count": 0
}
コマンド説明
指定したOCIDのVMクラスタの情報を取得するコマンドです。
「--query」を用いて、名前、シェイプ、CPU数だけを出すようにしています。
「--query」は
data.{"任意の名前":"出力したい項目の名前","任意の名前2":"出力したい項目の名前2"・・・}
という形式で指定できます。
JMESPathと呼ばれる書式になります。
OCIDがわからない場合
何をするにもOCIDが必要になります。もしOCIDが不明の場合は、下記のようなコマンドで確認できます。
※ Cloud Shellでは$OCI_TENANCYにルートコンパートメントのOCIDが入っています。
※ 複数のデータが返ってきますので--queryのところは「data[]」としています
※ 「--output table」は表記式で出力するオプションです
oci db vm-cluster list \
--compartment-id $OCI_TENANCY \
--query 'data[].{Name:"display-name",OCID:id}' \
--output table
もしルートコンパートメントではない場合、下記のコマンドで各コンパートメントのOCIDを確認できます。
oci iam compartment list \
--compartment-id $OCI_TENANCY \
--compartment-id-in-subtree true \
--query 'data[].{Name:"name",OCID:id,Parent:"compartment-id"}' \
--output table
VMクラスタの状態を確認する
コマンド
基本的には先ほどと同じです。取得項目が「lifecycle-state」になります。
oci db cloud-vm-cluster get \
--cloud-vm-cluster-id <VMクラスタのOCID> \
--query 'data.{"1.Name":"display-name","2.state":"lifecycle-state"}'
コマンド実行結果例
下記の例では更新中になります。
{
"1.Name": "testvm1",
"2.state": "UPDATING"
}
VMクラスタの作業リクエストの状況を確認する
状態が「UPDATING」ということは何かを更新しています。「作業リクエスト」を確認してみましょう。
コマンド
oci work-requests work-request list \
--compartment-id <コンパートメントのOCID> \
--resource-id <VMクラスタのOCID> \
--query 'data[].{"1.operation":"operation-type","2.status":"status","3.percent":"percent-complete","4.ocid":"id"}' \
--output table
コマンド実行結果例
下記の結果から、スケールアップ/ダウン中であることがわかります。
+-----------------------------------------+-------------+-----------+-----------------------------------------------------------------------------------------------------------+
| 1.operation | 2.status | 3.percent | 4.ocid |
+-----------------------------------------+-------------+-----------+-----------------------------------------------------------------------------------------------------------+
| Scale Cloud VM Cluster CPU | IN_PROGRESS | 50.0 | ocid1.coreservicesworkrequest.oc1.ap-osaka-1.yyyyyyyyyy |
| Update Cloud VM Cluster | IN_PROGRESS | 30.0 | ocid1.coreservicesworkrequest.oc1.ap-osaka-1.xxxxxxxxxx |
+-----------------------------------------+-------------+-----------+-----------------------------------------------------------------------------------------------------------+
作業リクエストのログを確認する方法
もしずっとUPDATE中のまま変わらなければ何かおかしいですよね。
そのような場合は作業リクエストのログを確認してみましょう。
コマンド
oci work-requests work-request-log-entry list \
--work-request-id <作業リクエストのOCID> \
--output table
コマンド実行結果例
もし下記のような結果だった場合、VM起動中にエラーが発生していたことがわかります。
そのような場合はサポートへ問い合わせをおこないましょう。
+-------------------------------------------------------------------------------------------------------------------+----------------------------------+
| message | timestamp |
+-------------------------------------------------------------------------------------------------------------------+----------------------------------+
| Sun, Sep 21, 2026, 8:51:28 UTC: Step 1 of 5: Starting the Guest VMs to resize to the new core count - FAILED | 2026-09-21T08:51:28.201000+00:00 |
| Sun, Sep 21, 2026, 8:50:11 UTC: Step 1 of 5: Starting the Guest VMs to resize to the new core count - INITIATING | 2026-09-21T08:50:11.703000+00:00 |
| Scaling up ECPU from 0 to 32 | 2026-09-21T08:50:05.221000+00:00 |
+-------------------------------------------------------------------------------------------------------------------+----------------------------------+
おわりに
OCIコンソール画面からも確認できる情報ではありますが、何らかの理由でOCIコンソールが使えない場合や、定期的に何度も実行する場合、AI等から実行する場合などを考えると、OCI CLIでも実施できるようになっておくとよいと思います。