Hitachi

Hitachi Storage Advisor Embedded ガイド 


14.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:未使用のドライブ
ボディ
なし。

レスポンスメッセージ

ボディ

クエリパラメータpoolIdを指定して(0,1,99,127)、ドライブの情報を取得した出力例を次に示します。

{
    "data": [
        {
            "location": "0-0",
            "status": "Normal",
            "driveType": "SSD",
            "driveInterface": "NVMe",
            "driveRpm": "NUMBER_0",
            "driveCapacity": 960,
            "displayDriveCapacity": "960 GB",
            "typeCode": "SNR5A-R960NC",
            "poolIds": [
                0,
                1,
                99,
                127
            ],
            "useOfTheDrive": "data"
        },
        {
            "location": "0-1",
            "status": "Normal",
            "driveType": "SSD",
            "driveInterface": "NVMe",
            "driveRpm": "NUMBER_0",
            "driveCapacity": 960,
            "displayDriveCapacity": "960 GB",
            "typeCode": "SNR5A-R960NC",
            "poolIds": [
                0,
                1,
                99,
                127
            ],
            "useOfTheDrive": "data"
        },
        {
            "location": "0-2",
            "status": "Normal",
            "driveType": "SSD",
            "driveInterface": "NVMe",
            "driveRpm": "NUMBER_0",
            "driveCapacity": 960,
            "displayDriveCapacity": "960 GB",
            "typeCode": "SNR5A-R960NC",
            "poolIds": [
                0,
                1,
                99,
                127
            ],
            "useOfTheDrive": "data"
        },
        {
            "location": "0-3",
            "status": "Normal",
            "driveType": "SSD",
            "driveInterface": "NVMe",
            "driveRpm": "NUMBER_0",
            "driveCapacity": 960,
            "displayDriveCapacity": "960 GB",
            "typeCode": "SNR5A-R960NC",
            "poolIds": [
                0,
                1,
                99,
                127
            ],
            "useOfTheDrive": "data"
        }
    ],
    "count": 4
}

属性

説明

location

string

ドライブの位置

status

string

ドライブの状態

  • Normal:正常
  • Warning:エラー部位がある状態
  • Copying:コピー中
  • CopyIncomplete:コピー不完全
  • Reserved:スペアドライブが使用できない状態
  • Failed:障害によるエラー状態
  • Blocked:保守によるエラー状態
  • Unknown:状態不明

driveType

string

ドライブタイプ

  • HDD
  • SSD(RI)
  • SSD
  • FMD DC2

driveInterface

string

ドライブインタフェース

  • SAS
  • NVMe

driveRpm

string

ドライブの回転数(rpm)

  • NUMBER_0
  • NUMBER_7200
  • NUMBER_10000
  • NUMBER_15000
  • High
  • Middle
  • Low
  • Unknown

driveCapacity

int

ドライブの容量(GB)

displayDriveCapacity

string

ドライブの容量が単位付き(GBまたはTB)で出力されます。

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=0,1,99,127