12.1.1 ドライブの情報を取得する
ドライブに関する情報を取得します。 ドライブの条件を指定して、絞り込んだ情報を取得することもできます。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/simple/v1/objects/drives
リクエストメッセージ
- オブジェクトID
- なし。
- クエリパラメータ
-
パラメータ
型
フィルタ条件
poolId
int
(任意)ドライブが属するプールID
poolNameと同時に指定しないでください。
poolName
string
(任意)ドライブが属するプール名
指定した値の一部がプール名と一致する場合もドライブの情報が取得されます。
poolIdと同時に指定しないでください。poolIdを指定している場合、このパラメータは無視されます。
status
string
(任意)取得するドライブの状態として、次の値を指定します。
- Normal:正常
- Warning:エラー部位がある状態
- Copying:コピー中
- CopyIncomplete:コピー不完全
- Reserved:スペアドライブが使用できない状態
- Failed:障害によるエラー状態
- Blocked:保守によるエラー状態
useOfTheDrive
string
(任意)取得するドライブの用途として、次の値を指定します。
- data:データドライブ
- spare:スペアドライブ
- free:未使用のドライブ
- ボディ
- なし。
レスポンスメッセージ
- ボディ
- プールIDが63のプール(クエリパラメータpoolIdに63を指定)に属するドライブの情報を取得した出力例を次に示します。
-
{ "data": [ { "location": "0-0", "status": "Normal", "typeRpmCapacity": "SAS,10000,600", "driveType": "SAS", "driveRpm": "NUMBER_10000", "driveCapacity": 600, "typeCode": "DKR5D-J600SS", "poolIds": [ 63 ], "useOfTheDrive": "data" }, { "location": "0-1", "status": "Normal", "typeRpmCapacity": "SAS,10000,600", "driveType": "SAS", "driveRpm": "NUMBER_10000", "driveCapacity": 600, "typeCode": "DKR5D-J600SS", "poolIds": [ 63 ], "useOfTheDrive": "data" }, { "location": "0-2", "status": "Normal", "typeRpmCapacity": "SAS,10000,600", "driveType": "SAS", "driveRpm": "NUMBER_10000", "driveCapacity": 600, "typeCode": "DKR5D-J600SS", "poolIds": [ 63 ], "useOfTheDrive": "data" }, { "location": "0-3", "status": "Normal", "typeRpmCapacity": "SAS,10000,600", "driveType": "SAS", "driveRpm": "NUMBER_10000", "driveCapacity": 600, "typeCode": "DKR5D-J600SS", "poolIds": [ 63 ], "useOfTheDrive": "data" } ], "count": 4 }
-
属性
型
説明
location
string
ドライブの位置
status
string
ドライブの状態
- Normal:正常
- Warning:エラー部位がある状態
- Copying:コピー中
- CopyIncomplete:コピー不完全
- Reserved:スペアドライブが使用できない状態
- Failed:障害によるエラー状態
- Blocked:保守によるエラー状態
- Unknown:状態不明
typeRpmCapacity
string
ドライブタイプ、ドライブの回転数、ドライブの容量がコンマで連結した形式で出力されます。
driveType
string
ドライブタイプ
- SAS
- SSD
- FMD DC2
driveRpm
string
ドライブの回転数(rpm)
- NUMBER_0
- NUMBER_7200
- NUMBER_10000
- NUMBER_15000
- High
- Middle
- Low
- Unknown
driveCapacity
int
ドライブの容量(GB)
typeCode
string
ドライブタイプコード
poolIds
int[]
ドライブが属するプールIDのリスト
useOfTheDrive
string
ドライブの用途
- data:データドライブ
- spare:スペアドライブ
- free:未使用のドライブ
ステータスコード
この操作のリクエストに対するステータスコードについては、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/drives?poolId=63