16.2 特定の外部ボリュームの情報を取得する
外部ボリュームIDを指定して、特定の外部ボリュームの情報を取得します。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/simple/v1/objects/external-volumes/<オブジェクトID>
リクエストメッセージ
- オブジェクトID
-
外部ボリュームの情報取得で取得したidの値を指定します。
属性
型
説明
id
int
(必須)外部ボリュームID
- クエリパラメータ
- なし。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
外部ボリュームIDが3のボリュームの情報を取得した例を次に示します。
{ "id": 3, "nickname": "externalVolumeForQuorum", "totalCapacity": 20480, "status": "Normal", "volumeIdentifier": "HITACHI 5040000C1965", "externalParityGroupId": "8-501", "externalPathGroupId": 501, "externalPathOfVolume": [ { "portId": "CL5-A", "portProtocol": "FC", "externalPortWwn": "50060e8012000c60", "lun": 501 } ], "volumeTypes": [], "externalStorage": { "model": "VSP Gx00", "serial": "400012", "vendor": "HITACHI" } }
取得する属性については、外部ボリュームの情報を取得する場合の属性に加えて、次に示す属性が取得されます。
属性
型
説明
volumeIdentifier
string
外部ボリュームを特定するための識別子
例:HITACHI 5040000C1965
ステータスコード
この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X GET https://192.0.2.100/ConfigurationManager/simple/v1/objects/external-volumes/3