Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


4.6 特定のリソースグループの情報を取得する

指定したリソースグループの情報を取得します。リソースグループのロック状態、またはロックしているユーザIDもしくはホスト名などを確認します。

実行権限

ストレージ管理者(参照)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/resource-groups/<オブジェクトID

リクエストメッセージ

オブジェクトID

リソースグループの情報取得で取得したresourceGroupIdの値を指定します。

属性

説明

resourceGroupId

int

(必須)リソースグループID

01023の10進数で指定します。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "resourceGroupId": 4,
  "resourceGroupName": "devResourceGroup",
  "lockStatus": "Locked",
  "lockOwner": "devUser",
  "lockHost": "host01",
  "virtualStorageId": 0,
  "ldevIds": [
    12,
    13
  ],
  "parityGroupIds": [
    "1-1",
    "1-2"
  ],
  "externalParityGroupIds": [
    "1-5",
    "1-6"
  ],
  "portIds": [
    "CL1-A",
    "CL1-B"
  ],
  "hostGroupIds": [
    "CL1-A,4",
    "CL1-A,5",
    "CL1-A,6"
  ]
}

属性

説明

resourceGroupName

string

リソースグループ名

resourceGroupId

int

リソースグループID

lockStatus

string

リソースグループのロック状態

  • Locked:リソースグループがロックされている状態
  • Unlocked:リソースグループがロックされていない状態

selfLock

boolean

Authorizationヘッダに指定したセッションがリソースグループをロックしているかどうか

  • true:指定したセッションがロックしている
  • false:指定したセッション以外のセッションがロックしている

リソースグループが、APIを実行したユーザと同じユーザが生成したセッションによってロックされている場合にだけ出力されます。

lockOwner

string

リソースグループをロックしているユーザID

リソースグループがロックされている場合にだけ出力されます。

lockHost

string

リソースグループをロックしているIP アドレスまたはホスト名

REST APIからリソースグループをロックした場合、次のどれかのIP アドレスまたはホスト名が出力されます。
  • SVP
  • GUM
  • Configuration Manager REST APIサーバ
  • Configuration Manager REST APIサーバの通信モードがproxyModeのときの中継用サーバ

リソースグループがロックされている場合にだけ出力されます。

lockSessionId

int

リソースグループをロックしているセッションID

リソースグループがロックされている場合で、Administratorユーザグループ(ビルトイングループ)に属するユーザVSP 5000 シリーズVSP E シリーズVSP Gx00 モデルVSP G1000VSP G1500VSP Fx00 モデルまたはVSP F1500の場合)APIを実行したときだけ出力されます。

virtualStorageId

int

リソースグループに対応している仮想ストレージマシンの ID

ldevIds

int[]

LDEV番号

parityGroupIds

string[]

パリティグループ番号

externalParityGroupIds

string[]

外部パリティグループ番号

portIds

string[]

ポート番号

hostGroupIds

string[]

ホストグループまたはiSCSIターゲットのオブジェクトID

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/resource-groups/4