Hitachi

Hitachi Storage Advisor Embedded ガイド 


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のプール(クエリパラメータpoolId63を指定)に属するドライブの情報を取得した出力例を次に示します。
{
  "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