4.6 特定のリソースグループの情報を取得する
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/resource-groups/<オブジェクトID>
リクエストメッセージ
- オブジェクトID
-
リソースグループの情報取得で取得したresourceGroupIdの値を指定します。
属性
型
説明
resourceGroupId
int
(必須)リソースグループID
0~1023の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 G1000、VSP G1500、VSP 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