<book_title> を検索 ...

Veritas InfoScale™ Operations Manager 8.0 ユーザーズガイド

Last Published: 2022-01-26

Product(s): InfoScale & Storage Foundation (8.0)

Platform: Solaris,Linux,AIX,Windows

XPRTLC と cURL を使った操作の実行例

XPRTLC と cURL を使った操作の実行例を以下に示します。

ホストのメタデータを取得するには

xprtlc -m POST -b "session id" -l 
https://veritasdomain.example.com:14161/vom/api/meta/server/host

curl -g -k -X POST -b "session id" 
https://veritasdomain.example.com:14161/vom/api/meta/server/host

クラスタオブジェクトに department という名前の拡張属性を定義するには

xprtlc -m POST -b "session id" -l 
https://veritasdomain.example.com:14161/vom/api/meta/hadr/cluster
/add?name=department

```
curl -g -k -X POST -b "session id" 
https://veritasdomain.example.com:14161/vom/api/meta/hadr/cluster
/add?name=department
```
Management Server コンソールで、クラスタオブジェクトに department 拡張属性を追加し、表示します。

クラスタオブジェクトで、department という名前の拡張属性を Dept_new に変更するには

xprtlc -m POST -b "session id" -l 
https://veritasdomain.example.com:14161/vom/api/meta/hadr/cluster
/modify?name=department&new_name=Dept_new

curl -g -k -X POST -b "session id" 
https://veritasdomain.example.com:14161/vom/api/meta/hadr/cluster
/modify?name=department&new_name=Dept_new

クラスタオブジェクトで、Dept_newという名前の拡張属性を削除するには

xprtlc -m POST -b "session id" -l 
https://veritasdomain.example.com:14161/vom/api/meta/hadr/cluster
/delete?name=dept_new

curl -g -k -X POST -b "session id"  
https://veritasdomain.example.com:14161/vom/api/meta/hadr/cluster
/delete?name=dept_new

拡張属性を削除すると、その属性は Management Server コンソールに表示されません。

拡張属性があるホストの拡張属性値を更新するには

xprtlc -m POST -b "session id" -l 
https://veritasdomain.example.com:14161/vom/api/update/server/host
/myhost_id?location=1st floor

curl -g -k -X POST -b "session id" 
https://veritasdomain.example.com:14161/vom/api/update/server/host
/myhost_id?location=1st floor

表示の種類が専用であるオブジェクトディスクグループをフィルタ処理するには

xprtlc -b "session id" -l 
https://veritasdomain.example.com:14161/vom/api/query/server/host
/myhost_id/diskgroup?display_type=private

curl -g -k -b "session id" 
https://veritasdomain.example.com:14161/vom/api/query/server/host
/myhost_id/diskgroup?display_type=private

リカバリ計画を実行するには

xprtlc -m POST -b "session id" -l 
'https://veritasdomain.example.com:14161/vom/api/op/hadr/recoveryplan/
myrplan_id/execute' -d 
'payload={"Tasks": [{"task_order":"1", "IS_SKIP":false},
{"task_order":"1", "TIMEOUT":"5"},
{"task_order":"2", "IS_SKIP":false,
"TIMEOUT":2}], "OfflineSharedSg":true}' -d 
'reason=recovery plan execution for ticket no. 123'

curl -g -k -X POST -b "session id" -l
'https://veritasdomain.example.com:14161/vom/api/op/hadr/recoveryplan/
myrplan_id/execute' -d
'payload={"Tasks": [{"task_order":"1", "IS_SKIP":false},
 {"task_order":"1","TIMEOUT":5},
 {"task_order":"2", "IS_SKIP":false,
 "TIMEOUT":2}], "OfflineSharedSg":true}' -d
'reason=recovery plan execution for ticket no. 123'

ストレージテンプレートを使ってストレージをプロビジョニングするには

xprtlc -b "session id" -m POST -d
'payload={"HostId":"my_host_id",
 "DiskGroupId":"myDG_id", "VolSize":"vol_size"}' -l 
'https://veritasdomain.example.com:14161/vom/api/op/server/
 template/storage/storage_template_ID/provision'

curl -g -k -X POST -b "session id" -l
'https://veritasdomain.example.com:14161/vom/api/op/server/
 template/storage/storage_template_ID/provision' -d
'payload={"HostId": {"my_host_id",
 "DiskGroupId":"myDG_id", "VolSize":"vol_size"}'

データセンターの管理対象ホストを移動するには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/
op/server/{host_id}/moveto/datacenter/

例

curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;" 
https://veritasdomain.example.com:14161/vom/api/
op/server/%7B0002345-5432-4dff-0000-00000000000%7D/moveto/datacenter/

管理対象ホストを組織 OE1 から組織 OE2 の子組織 OE3 に移動します。

curl -g -k -X POST -b "session id" 
https://veritasdomain.example.com:14161/vom/
api/op/server/{host_id}/moveto_oe/OE2,OE3/

例

curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;" 
https://veritasdomain.example.com:14161/vom/api/
op/server/%7B0002345-5432-4dff-0000-00000000000%7D/moveto_oe/OE2,OE3/

データセンターのクラスタを移動するには

curl -g -k -X POST -b "session id" 
https://veritasdomain.example.com:14161/vom/
api/op/hadr/{cluster_id}/moveto/datacenter/

例

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;" 
https://veritasdomain.example.com:14161/vom/api/op/
hadr/rhelclust-42058/moveto/datacenter/

クラスタを組織 OE1 から組織 OE2 の子組織 OE3 に移動します。

curl -g -k -X POST -b "session id" 
https://veritasdomain.example.com:14161/vom/
api/op/hadr/{cluster_id}/moveto_oe/OE2,OE3/

例

curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;" 
https://veritasdomain.example.com:14161/vom/api/op/
hadr/rhelclust-42058/moveto_oe/OE2,OE3/

パラメータが強制または伝播であるサービスグループをオンラインにするには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/host/{hostname}/{force}/{propogate}/online/

例: パラメータが強制であるオンラインサービスグループ

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/true/false/online

例: パラメータが伝播であるオンラインサービスグループ

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/false/true/online

パラメータが強制、伝播またはプローブであるサービスグループをオフラインにするには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/host/{hostname}/{force}/{probe}/{propogate}/offline/

例: パラメータが強制であるオフラインサービスグループ

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/true/false/false/offline

例: パラメータが強制とプローブであるオフライン操作サービスグループ

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;" https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/true/true/false/offline

サービスグループを切り替えるには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/host/{hostname}/switch/

例

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;" 
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/switch/

パラメータ永続でサービスグループをフリーズするには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/{persistent}/freeze/

例

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/
op/hadr/servicegroup/x1@linux_clus-00000/true/freeze/

例: パラメータを指定しないでサービスグループをフリーズ

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/
op/hadr/servicegroup/x1@linux_clus-00000/false/freeze/

サービスグループのフリーズを解除するには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/unfreeze/

例

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/
op/hadr/servicegroup/x1@linux_clus-00000/unfreeze/

サービスグループの障害を消去するには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/host/{hostname}/clear/

例

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/clear

サービスグループの clearadminwait 状態をクリアするには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/host/{hostname}/{fault}/clearadminwait/

例: clearadminwait 状態と障害をクリア

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/true/clearadminwait

例: 障害を消去せずに clearadminwait 状態をクリア

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/false/clearadminwait

サービスグループをフラッシュするには

curl -g -k -X POST -b "session id"
https://veritasdomain.example.com:14161/vom/api/op/
hadr/servicegroup/{service_group_id}/host/{hostname}/flush/

例

        curl -g -k -X POST -b "JSESSIONID=13C8F4E4203BFE96DD6D1LFC69FC7B65;"
https://veritasdomain.example.com:14161/vom/api/op/hadr/servicegroup/
x1@linux_clus-00000/host/example.com/flush

管理対象ホストの詳細をフェッチするには
1. query API を使用して管理対象ホストの詳細をフェッチする前に、次のコマンドを使用して安全な API ログインのセッション ID を識別します。
```
curl -g -k -d user="userName" -d password="userPassword" -d domain="managementServerID"
https://managementServerID:14161/vom/api/login
```
CMS のユーザー名とパスワードの適切な値を指定します。
サンプルセッション ID の値は次のとおりです。
```
{"cookie":"JSESSIONID=2886C4EE175075D72C0AB91A1D9CF846;","current_server_time":"Mon Oct
26 10:57:36 GMT-12:00 2020","max_active_interval":30,"expires_at":"Mon Oct 26 11:27:36
GMT-12:00 2020"}
```
2. 次のコマンドを使用してホストの詳細をフェッチします。
```
curl -g -k -X POST -b "sessionID"
https://managementServerID.com:14161/vom/api/query/server/host/
```
管理対象ホストを削除または設定解除するには
次のコマンドを実行して、API を使って管理対象ホストを削除または設定解除します。
```
curl -g -k -X POST -b "sessionID"
https://managementServerID.com:14161/vom/api/op/infra/host/%7bhostID%7d/remove
```
メモ:
curl コマンドでは、波カッコ「{ 」、「}」の使用はサポートされていません。対応するマークアップテキストとして「{」を「%7b 」に、「}」を「%7d」に置き換えます。Google Chrome でこの API を使用するには、RestMan アドオンをインストールします。Mozilla FireFox でこの API を使用するには、REStClient アドオンをインストールします。

ここで、veritasdomain.example.com は Management Server 名、server はサーバーパースペクティブ、hadr は可用性パースペクティブ、myhost_id はホストのエンコードされた ID、myDG_id はディスクグループのエンコードされた ID、cluster_id はクラスタのエンコードされた ID、myrplan_id はリカバリ計画 ID です。

［すべての操作の理由を求める (Ask reason for all operations)］が［Management Server］パースペクティブの［高度認証 (Advanced authorization)］の下で有効になっている場合、操作実行の理由を入力することが必要になります。

メモ:

オブジェクトに対する query URL の出力には、［encoded_id］の値が表示されます。このエンコードされた ID 値を使って、該当するオブジェクトの拡張属性を更新する必要があります。

同様に、操作 URL に GET 要求を実行すると、操作実行のサンプル URL が表示されます。

詳細情報

Veritas InfoScale Operations Manager Web サービス API を使った操作の実行について